待办规划 (Todo & Plan)

把复杂任务拆成可勾选的清单,做一项、勾一项、始终只有一项进行中。让多步工作可见、可控、不漏项。借鉴 Claude Code 的 TodoWrite。

使用时机

✅ 使用此技能当: 任务有 3 步以上、涉及多文件/多阶段、用户给了多条要求、或边做边冒出新子任务。 ❌ 不要用当: 单一、琐碎、一步搞定的任务(加清单反而啰嗦)。

铁律

1. 开工先列清单 — 动手前把任务拆成有序、具体、可验证的小项,先给用户看一眼计划。
2. 始终只一项 进行中 — 同一时刻只标一项 in-progress;开始下一项前,先把当前项收尾并标 已完成。
3. 完成即时勾掉 — 一项做完立刻标已完成,不要攒着批量勾;让进度实时可见。
4. 冒出新子任务就加进清单 — 中途发现的事追加为新项,别塞进脑子里漏掉。
5. 每项可验证 — 项的描述要能判断"做完没"(如"typecheck 通过""xx 接口返回 200"),而非含糊的"处理一下"。

清单写法

- [x] 1. 定位需求涉及的文件(检索)
- [x] 2. 读懂目标函数与调用方
- [→] 3. 精确改 foo() 的边界判断    ← 当前进行中(只此一项)
- [ ] 4. 跑 typecheck + 相关测试验证
- [ ] 5. 自检 diff、补/改测试

状态:[ ] 待办 · [→] 进行中 · [x] 已完成。

标准流程

1. 拆解 — 把任务拆成 3-7 个有序小项(太多再分层),每项一句话、可验证。
2. 亮计划 — 把清单给用户,确认方向再开工。
3. 逐项推进 — 标一项进行中 → 做(配合检索/编辑/执行验证)→ 收尾标完成 → 下一项。
4. 动态维护 — 新需求/新发现 → 追加项;方向变 → 调整清单。
5. 收口 — 全部 [x] 后,回看是否真的满足原始需求,再宣告完成。

与闭环配合

待办规划是「读-改-验」的总指挥:每个待办项内部走 检索(读)→ 精确编辑(改)→ 执行验证(验),验证绿了才勾掉该项。

反模式(禁止)

• ❌ 不拆解直接埋头做多步任务、中途漏项
• ❌ 同时多项进行中,自己都乱
• ❌ 做完不勾、进度对用户不透明
• ❌ 清单项含糊到无法判断完成与否

核心原则

先拆后做 · 单线进行 · 即时勾选 · 项项可验。 清单是给用户的进度窗口,也是给自己的防漏网。