// 专门负责管理项目路线图 (roadmap.md)、待办事项 (todo.md)、待办归档 (todo-archive.md) 与阶段切换收口流程。
分析项目上下文、Nuxt 结构和依赖项，用于规划和调试。
暂存更改并生成符合 Conventional Commits 规范的提交消息。
全局一体化开发与协作工作流技能，覆盖需求评估、开发、测试、质量、文档、提交、发布等全链路阶段，可集成所有基础原子技能，实现 PDTFC+ 循环自动化及分工合作优化。
编写、运行和优化项目测试用例（Vitest）。
审查 git 变更、Review Gate、merge ready、发布前审计以及代码、文档、配置、脚本质量门禁时使用。输出结构化 Pass 或 Reject 结论、问题分级、最低验证矩阵、证据链和复查基线；当用户提到 review、code review、审计、review gate、merge ready、blocker、evidence、pass、reject 时触发。
专注于查阅、维护和生成项目文档 (位于 docs/ 目录下)。
| name | todo-manager |
| description | 专门负责管理项目路线图 (roadmap.md)、待办事项 (todo.md)、待办归档 (todo-archive.md) 与阶段切换收口流程。 |
| metadata | {"internal":true} |
docs/plan/todo.md 中的任务状态（进行中、已完成）。todo.md 中的原子化条目。docs/plan/roadmap.md。todo.md、更新 todo-archive.md、同步 roadmap.md 与多语路线图摘要。.session/current-task.yaml，在 session 开局时恢复上下文，在 session 收尾时更新进度与认知状态。todo.md, roadmap.md）应在项目主根目录（master 分支）下执行。todo.md 或 roadmap.md 之前，必须先经过 requirement-analyst 或等效流程判断其属于当前范围、允许插队事项还是延期事项。in-progress；完成后标记为 completed。roadmap.md 的积压区，而不是占用当前迭代容量。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。.session/current-task.yaml 是阶段级 todo.md 的 session 级补充。todo.md 负责阶段跨度（以周为单位），.session/current-task.yaml 负责 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/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/wisdom.md。.session/runtime-state.json 的 last_verification。.session/ 目录为 git-ignored，不进入版本库、不进入深度归档、不进入语义索引。.session/ 内容归档到 todo-archive.md。.session/current-task.yaml 不存在（新项目或首次使用），按正常流程初始化：从 todo.md 当前进行中条目派生初始内容。动作: 读取 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 协议一致。