Files
lpt-meta/.agents/roles/todo-discipline.md
T

58 lines
2.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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` 次数是否匹配。