Todo Manager Skill (待办事项管理技能)
核心能力 (Core Capabilities)
- 状态同步: 实时更新
docs/plan/todo.md中的任务状态(进行中、已完成)。 - 任务拆解: 将复杂需求拆解为
todo.md中的原子化条目。 - 版本规划: 根据更改内容更新
docs/plan/roadmap.md。 - 事项分流落点: 根据优先级把新增事项放到当前阶段或 backlog,而不是一律塞进当前待办。
- 闭环检查: 在任务完成前,核对所有 TODO 项是否已打勾。
- 阶段归档收口: 在阶段结束时,按统一 checklist 清理
todo.md、更新todo-archive.md、同步roadmap.md与多语路线图摘要。
指令 (Instructions)
- 路径感知: 规划类操作(
todo.md,roadmap.md)应在项目主根目录(master分支)下执行。 - 先判定再落盘: 新发现的事项在写入
todo.md或roadmap.md之前,必须先经过requirement-analyst或等效流程判断其属于当前范围、允许插队事项还是延期事项。 - 首尾呼应: 每个任务开始前必须将对应的 TODO 标记为
in-progress;完成后标记为completed。 - 严禁无门槛膨胀: 不得因为开发过程中顺手发现了问题,就直接向当前阶段追加多个新条目。只有阻塞交付、回归修复、安全/合规修复等高优先级事项,才允许插入当前阶段。
- 延后有去处: 不允许简单忽略低优先级事项;应将体验优化、非阻塞依赖升级、探索性想法等写入
roadmap.md的积压区,而不是占用当前迭代容量。 - 容量约束: 若当前阶段核心任务数将超过 5-6 项,必须提示执行“进一出一”策略。
- 文档一致: 确保
roadmap.md与实际开发进度保持同步。 - 归档流程唯一事实源: 凡是涉及“阶段完成、归档、切到下一阶段”,必须严格遵循
docs/standards/planning.md中的“阶段归档与下一阶段规划标准流程”,不得自行省略检查项或改顺序。 - 归档前置检查: 归档前必须逐项确认当前阶段条目已完成、
todo.md当前进行中事项已清理、回归记录与质量门证据已可追溯、并且至少有一轮 review 结论。 - 归档更新顺序: 先清理
todo.md,再写todo-archive.md,再同步roadmap.md,最后按需更新docs/i18n/*/plan/roadmap.md;todo.md与backlog.md默认保持中文,不为归档动作单独翻译。 - 最低检查不可跳过: 阶段归档属于正式规划变更,至少补齐
lint-md、pnpm docs:check:i18n、质量门状态确认与错误面检查;若缺失这些证据,不得标记“已归档”。 - 下一阶段闸门: 当前阶段未完成归档前,只允许输出“候选方案 / 准入分析”,不得直接把下一阶段写入
todo.md或roadmap.md。
使用示例 (Usage Example)
动作: 读取 todo.md,找到排名最高且未开始的任务,启动开发流程并将该条目标记为“开发中”。
动作: 在开发过程中发现一个非阻塞的体验优化点时,不把它直接加入当前阶段,而是补充到 roadmap.md 的 backlog,并注明来源背景。
动作: 当当前阶段所有主线都已完成时,先按 planning.md 检查归档准入、回归证据、Review Gate 和文档同步,再依次更新 todo.md、todo-archive.md、roadmap.md 与多语路线图摘要,而不是直接删除当前阶段正文。