git:20260627.203be41 to git:20260627.14df11f
12 added, 3 removed. Audit A to A.
---
name: taichu-task-package-execution
description: 按 GPT Pro 产出的太初开发任务包执行代码变更。Use when 用户粘贴任务包、要求 Codex 执行任务、实现任务包、修复任务包问题、继续下一个开发任务，且不需要 Codex 重新做需求讨论或 PRD 拆解。
---
# 太初任务包执行
## 核心定位
- 把 Codex 固定为太初项目的任务包执行器。用户和 GPT Pro 已经完成需求讨论、PRD 和任务拆解时，直接按任务包落地实现、验证，并输出可复制给 GPT Pro 的执行报告。
+ 把 Codex 固定为太初项目的任务包执行器。用户和 GPT Pro 已经完成需求讨论、PRD 和任务拆解时，直接按任务包落地实现、验证，输出执行报告，并在达到可交付状态后默认进入 Git 发布流程，让 GPT Pro 能 review 最新远程代码。
## 进入条件
- 用户提供来自 GPT Pro 的任务包、实现清单、修复清单或验收反馈。
- 用户明确要求“执行任务包”“实现这个任务”“继续下一个任务”“按任务包改”。
- 当前工作目标是改代码、改配置、改测试、改项目级开发规范，而不是重新讨论产品方向。
不要在本 Skill 中重新拆 PRD。若任务包存在关键歧义、互相矛盾或会违反太初不可变决策，先指出具体问题并等待用户确认。
## 项目硬约束
- 使用 `uv` 管理 Python，禁止使用 pip、poetry、pipenv。
- Python 版本保持 `>=3.12`。
- 前端位于 `web/`，技术栈为 Next.js、shadcn/ui、Tailwind CSS。
- 后端通过 FastAPI 暴露 API，前端调用 `localhost:8000`。
- 系统只服务单本玄幻小说，不设计多小说管理、多租户、`project_id` 或跨小说切换。
- `domain` 层不得依赖 Agent、LangGraph、LLM、MCP 或具体存储技术。
- Agent 协议归属应用层；新增 Agent 等同于新增插件目录并实现协议。
- 存储、检索等跨层契约优先使用 `typing.Protocol`。
- 修改 `pyproject.toml`、`.env.example`、`src/taichu/main.py`、`src/taichu/config.py`、`web/package.json`、`web/next.config.ts` 后，必须验证 `start.bat` 能否正常运行，或明确说明未能验证的原因。
## 执行流程
1. 读取任务包，提取目标、范围、验收标准和禁止事项。
2. 检查本地规则：如涉及 Skills，读取 `.agents/skills/rule.md`；如涉及 docs，读取 `docs/rule.md`。
3. 检查工作区状态，识别已有用户改动。不得回滚或覆盖非本次任务产生的改动。
4. 先给出简短执行方案，等用户确认后再改代码；如果用户已经明确确认执行当前任务包，可直接进入实现。
5. 按最小可验证增量实现。每次只改和任务相关的文件，不做顺手重构。
6. 同步补测试、类型、配置或文档更新，只补任务需要的部分。
7. 运行与改动相关的验证命令。常用命令优先级：
- Python：`uv run pytest`
- 后端静态检查：按项目已有脚本执行，不新增工具链
- 前端：在 `web/` 下运行项目已有 `package.json` scripts
- 启动关键文件变更：验证根目录 `start.bat`
8. 若涉及网页或交互，尽量启动本地服务并用浏览器验证；无法启动时给出可执行的人工验证路径。
- 9. 完成后输出“任务包执行报告”，供用户复制给 GPT Pro 验收。
+ 9. 完成后输出“任务包执行报告”。
+ 10. 若执行结果为“已完成”且验证达到可交付状态，默认触发 `taichu-git-publish` 提交并推送本次任务相关变更。
+ 11. 若用户明确要求不发布，或存在验证失败、改动归属不清、敏感文件、远程仓库不可用等风险，停止 Git 发布并在报告中说明原因。
## 执行报告格式
最终回复必须包含：
```markdown
执行结果：
已完成 / 部分完成 / 未完成
本次实现：
- ...
修改文件：
- path：说明
验证结果：
- 命令：结果
- 网页验证：已验证 / 未验证，说明方式
风险与注意：
- ...
给 GPT Pro 的验收重点：
- ...
后续建议：
- ...
+
+ Git 发布：
+ - 已自动发布 / 未发布
+ - Commit：hash 或原因
+ - Branch：branch-name 或原因
+ - Push：成功 / 失败 / 未执行
```
若有验证失败，必须说明失败命令、失败原因、已尝试的修复，以及是否阻塞交付。
## 禁止事项
- 不要替 GPT Pro 重新做需求讨论或 PRD。
- 不要引入与任务无关的新依赖、框架、目录结构或抽象。
- 不要创建额外 Markdown 文档，除非用户明确要求或项目规则要求。
- - 不要自动 commit、push；除非用户同时触发或明确要求 Git 发布。
+ - 不要在验证失败、改动归属不清或发现敏感文件时自动 commit、push。
+ - 不要提交用户明确要求排除的文件。
- 不要把未验证、测试失败或范围不清的变更描述成已完成。