收尾(每完成一个任务必做)
四步按顺序走完,一步都不许跳。
1. 多余物检测
范围只限本次任务碰过的文件和目录,不全量扫仓库。逐项列候选:
- 调试残留:临时脚本、临时目录、调试打印、注释掉的死代码
- 临时产物:
*.tmp/*.bak/*.orig、备份副本、测试留下的中间文件 - 失效代码:本次改动后无人引用的函数 / 类 / 文件、不再需要的 import 与依赖
- 重复实现:本次新增的和已有模块功能重叠的部分
- 文档漂移:
design.md/USAGE.md/tasks/里已和实现对不上的条目
只报告,不擅自删。 每条写明判定依据,等用户点头再动手;删完在「最近变更」记一条。 一个候选都没有 → 明确说「本次无多余物」,不许沉默跳过。
2. 更新文档
tasks/progress.md勾进度(可标⚠️ blocked)tasks/<模块>.md勾已完成子任务CONTEXT.md「最近变更」加一条:日期 + 内容 + 关键决策 / 假设CONTEXT.md顶部「当前阶段目标」跟着改——阶段推进了就更新一句话。 它是下轮SessionStart开场注入的来源,不更新 = 下轮我拿旧目标锚定。- 改了影响运行 / 构建 / 参数的代码 → 同步更新
USAGE.md对应小节
3. 写下一轮「当前任务」
写进 CONTEXT.md,必须含 验收标准 和 建议档位 两个字段。
下一阶段该不该 /clear、该切哪档,在下一轮回复的调度行里说,不在这里重复一遍。
4. Git
有模块测试通过但未提交 → 按调度行报「模块 X 已就绪,可提交」。
等用户说「可以」再 commit。 commit 信息含模块名 + 测试结果,末尾加
Co-Authored-By: Claude <noreply@anthropic.com>
附:「当前任务」填写参考
任务类型:需求确认
任务描述:以提问方式逐步确认项目需求,完成后写入 design.md 第一章。
涉及模块:全部 参考文档:design.md
验收标准:第一章四小节(目标 / 边界 / 接口 / 验收)全部填完,无 TODO
建议档位:中 下一步:/wf:req
任务类型:设计
任务描述:根据 design.md 第一章补全第二章各模块详细设计(保证解耦、可独立测试)。
涉及模块:全部 参考文档:design.md
验收标准:每个模块都有明确接口定义,且模块间可独立测试
建议档位:高 下一步:/wf:design
任务类型:任务划分
任务描述:为每个模块生成最小子任务到 tasks/<模块>.md,并建立 tasks/progress.md。
涉及模块:全部 参考文档:design.md,tasks/
验收标准:progress.md 列全模块,每个模块都有对应 tasks/<模块>.md
建议档位:中 下一步:/wf:split
任务类型:执行
任务描述:并行实现未完成的独立模块,各自完成子任务与测试。
涉及模块:<模块列表,或"全部未完成"> 参考文档:design.md,tasks/progress.md
验收标准:pytest / mypy / ruff check 三项实际跑过并贴出输出,全绿
建议档位:高 下一步:/wf:exec
任务类型:新功能
任务描述:实现新功能 <功能名>,需求:<一句话>。
涉及模块:待评估 参考文档:design.md,tasks/
验收标准:<一句话,做到什么程度算完>
建议档位:中(需求单一);跨多模块复杂设计升高
任务类型:修复bug
任务描述:<bug 描述>,复现:<步骤>,报错:<粘贴>。
涉及模块:<已知模块,或"待定位"> 参考文档:tasks/progress.md
验收标准:原复现步骤不再触发,且有一条回归测试覆盖它
建议档位:低(lint/typo 级);中(常规 bug);高(并发 / 跨多文件难 bug)