# todo 收口纪律 - **功能**:让待办列表始终反映真实进度——做完的事当场收口,不留「已经做完、却还显示未完成」的陈旧条目。 - **何时用**:创建或更新 todo 时;一项工作做完时;`git commit` 成功后;准备发出最终回复前;会话被压缩后;发现待办状态与事实不符时。 ## 为什么有这条规则 2026-10-09 的一次会话里:`todo` 工具 `create` 23 次,`update` 只有 14 次—— **13 条(57%)从未被标记完成**,而它们对应的活儿全都做完并提交了。 表现是待办面板长期显示一堆「未完成」,看起来像插件不显示完成态,实际是**没人去收口**。 放大因素(都真实发生过): - 批量创建后跨多轮续跑,缺少「收口上一条」这个动作的触发点; - 多项经 subagent 执行,子代理返回、验证后直接进入下一步; - **会话被压缩后,压缩摘要与 todo 列表漂移**,没人对账; - 插件会把已完成项在下一轮隐藏(其既定设计),使遗漏反而更不容易被看见。 ## 规则 三条都有明确触发点——不需要「记得」,只需要在触发点做一次。 ### R1 提交后立即收口 **触发点**:`git commit` 成功。 每次提交成功后,**立刻**把这次提交覆盖的 todo 标为 `completed`。 提交是本项目工作的收尾动作,触发点天然存在,不依赖记性。 ### R2 轮末对账 **触发点**:准备发出最终回复前。 发最终回复前跑一次 `todo list`,凡是「实际已完成、但状态仍是 `pending` / `in_progress`」的, 一律收口。对账是幂等的:没有遗漏时它就是一次空转。 ### R3 压缩后对账 **触发点**:会话被压缩、出现压缩摘要之后。 压缩摘要与 todo 列表是两套状态,压缩后先对账一次再继续干活。 本规则正是从压缩后漂移的场景里总结出来的。 ## 边界 - **不得为收口而收口**:测试失败、实现不完整、仍有未解决报错时保持 `in_progress`, 并为阻塞另建条目(既有约定不变)。 - 建议单批条目不超过 5 条。本规则的诞生场景里 23 条远超面板默认 12 行预算, 本来看不全,也更难发现自己漏维护。这是建议,不是硬规则。 - 这些 todo 只是会话内草稿(插件不写盘,状态由会话分支重放), 收口不涉及代码、数据库或任何仓库内容。 ## 怎么核对 - `todo list` 看最终状态分布; - 需要复盘时,重放会话文件里的 `todo` 调用,统计 `create` 与 `update` 次数是否匹配。