Wrap

---
description: 每完成一个任务或模块后收尾：多余物检测 + 更新文档 + 写下一轮当前任务 + 提醒 git。
model: sonnet
effort: medium
---

# 收尾（每完成一个任务必做）

四步按顺序走完，一步都不许跳。

## 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）
```