caomeiyouren 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与多语路线图摘要。 - Session 级任务协议管理: 维护
.session/current-task.yaml，在 session 开局时恢复上下文，在 session 收尾时更新进度与认知状态。
指令 (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。 - 归档一致性检查: 阶段归档时同步检查
docs/plan/archive/中 roadmap 归档分片与 todo-archive 归档分片的覆盖范围是否对齐。若 roadmap 归档分片落后于 todo-archive（如 roadmap 只归档到 Phase X 但 todo 已到 Phase X+N），必须先补齐 roadmap 的缺失归档分片再继续。归档前如需压缩roadmap.md中已完成阶段的详情正文，必须先将原始完整内容提取到归档分片文件，禁止直接丢弃。 - 新阶段评估前工作区清洁: 进入新阶段评估前，先执行一次规划文档的清洁检查——确认
todo.md无已归档阶段残留、roadmap.md无已归档阶段的规划细节残留、backlog.md无已完成候选条目的正文残留、归档分片覆盖范围对齐、文档格式无混用括号 / 异常反引号等漂移。详见docs/standards/planning.mdStep 8。
Session 级任务协议管理
.session/current-task.yaml 是阶段级 todo.md 的 session 级补充。todo.md 负责阶段跨度（以周为单位），.session/current-task.yaml 负责 session 跨度（以小时为单位）。两者同步不替代。
Session 开局恢复
每次新 session 启动时（无论是新对话窗口还是任务切换后继续），按以下顺序恢复上下文：
- 读取
.session/current-task.yaml→ 获取active_plan、progress（已完成 / 进行中 / 阻塞）、next_steps与cognitive状态。 - 读取
.session/runtime-state.json→ 获取failure_count、active_mode、last_verification。 - 读取
.session/wisdom.md→ 若有跨 session 值得复用的发现，一并加载。 - 读取
docs/plan/todo.md→ 对齐阶段级上下文，确认当前进行中的主线是否与 session 协议一致。
Session 收尾更新
每次 session 结束前（用户说"收工""结束""今天到这"或主动切换任务时），更新 .session/current-task.yaml：
| 字段 | 更新内容 |
|---|---|
progress.completed |
追加本 session 已完成的具体步骤 |
progress.in_progress |
更新当前进行中的步骤（最多一项） |
progress.blocked_on |
若有阻塞，写明原因（否则留空） |
next_steps |
下一 session 的优先事项（3 项以内） |
cognitive |
仅本 session 有失败时更新（failure_count、active_mode、tried_approaches、switched_from） |
session.updated_at |
更新为当前时间 |
另外：
- 若有值得跨 session 复用的 pattern / bug / decision，追加到
.session/wisdom.md。 - 若
.session/wisdom.md活跃条目数 >= 20，提醒执行蒸馏（详见 Session Wisdom 蒸馏机制）。 - 更新
.session/runtime-state.json的last_verification。
关键边界
.session/目录为 git-ignored，不进入版本库、不进入深度归档、不进入语义索引。- Session 协议是任务态（每 session 重写），不是历史态。阶段结束时不需要把
.session/内容归档到todo-archive.md。 - 若
.session/current-task.yaml不存在（新项目或首次使用），按正常流程初始化：从todo.md当前进行中条目派生初始内容。
使用示例 (Usage Example)
动作: 读取 todo.md，找到排名最高且未开始的任务，启动开发流程并将该条目标记为"开发中"。
动作: 在开发过程中发现一个非阻塞的体验优化点时，不把它直接加入当前阶段，而是补充到 roadmap.md 的 backlog，并注明来源背景。
动作: 当当前阶段所有主线都已完成时，先按 planning.md 检查归档准入、回归证据、Review Gate 和文档同步，再依次更新 todo.md、todo-archive.md、roadmap.md 与多语路线图摘要，而不是直接删除当前阶段正文。
动作: Session 收尾时，更新 .session/current-task.yaml 的 progress、next_steps 与 cognitive 字段，并确认 todo.md 的任务状态与 session 协议一致。