用途
该技能用于读取功能路线图，找到下一个尚未规划的阶段，对其进行头脑风暴，并将生成的文档名称更新回路线图。它通过一份按阶段生成的检查清单来跟踪每次运行的进度，支持中断后恢复，并确保路线图、设计文档、实现计划与决策日志之间保持一致。
主要能力
- 恢复检测（步骤 0）：在读取路线图或执行任何阶段工作之前，检查是否存在需要恢复的进行中运行，并验证项目目录布局。
- 布局迁移：检测旧版布局（docs/roadmap.md、docs/plans/、docs/roadmap-decisions/）并提示迁移到新布局（docs/roadmap/roadmap.md、docs/roadmap/plans/、docs/roadmap/decisions/）。迁移前会检查工作树是否干净。
- 阶段检查清单：每次运行创建一份检查清单，位于 docs/roadmap/plans/YYYY-MM-DD-<topic>-checklist.md，包含 frontmatter 与步骤复选框，用于记录运行状态。
- 阶段文件名 slug 规则：从阶段标题生成文件名 slug，包括小写化、去除撇号、将非字母数字字符替换为连字符等步骤，空结果时回退为 phase-N。
- 头脑风暴与设计：对下一个未规划阶段进行头脑风暴，生成设计文档。
- 推送反馈（pushback）与对齐检查（alignment）：通过子代理返回发现的问题，记录严重程度、类别、摘要与状态，并支持用户追加发现。
- 决策日志：将推送反馈与对齐检查的发现转录到决策日志中。
- Shell 命令加固：调用 git mv 时始终使用 -- 分隔符，防止以 - 开头的路径被解析为标志。
使用方式
该技能以斜杠命令 /roadmap 的形式运行。运行时会依次执行：恢复检测、读取路线图、识别下一个未规划阶段、创建分支、提取阶段上下文、头脑风暴并保存设计、在路线图中记录计划文件名、推送反馈审查、CLAUDE.md 审查、编写实现计划、对齐检查、编写决策日志条目、宣布完成。每个步骤结束后都会更新检查清单（frontmatter 的 last_updated、相关复选框以及路径字段）。
检查清单的 frontmatter 包含 phase、phase_slug、branch、roadmap、started、last_updated、design_file、plan_file、decision_log 等字段。步骤 4、8、10 在勾选前会验证对应文件存在且非空（使用 test -s 与 grep 组合检查）。
适用场景
适用于需要按阶段推进功能开发、并希望将路线图、设计、计划与决策记录关联起来的项目。特别适合需要中断后恢复、需要追踪推送反馈与对齐检查发现、以及需要从旧版目录布局迁移到新版布局的场景。
限制
- 若未找到路线图（docs/roadmap/roadmap.md 不存在），会停止并提示先创建该文件。
- 若新旧布局同时存在，会停止并提示手动协调，不会静默选择。
- 布局迁移前若工作树不干净，会提示用户提交、暂存或明确确认后再继续。
- 头脑风暴步骤不可恢复：若在步骤 4 中断，需重新运行头脑风暴。
- 检查清单的 Status 词汇为封闭集合：open | closed。
- 推送反馈具有部分随机性，不能将昨天的发现合并到今天的输出中。
- 该技能的具体收费、价格、平台支持等信息暂未提供。