用途
Roadmap 用于把目标、候选想法、工单、审计发现和设计文档转化为对即将开展工作的全局视图。它强调路线图是方向、优先级和依赖关系的结合，说明接下来可能推进哪些能力、成果或战略轨道，为什么重要，以及在这些工作真正落地之前必须先完成什么。它明确不是愿望清单、会议记录、日期承诺、待办事项堆砌、冲刺计划或实现计划。
主要能力
- 设定路线图的受众、时间视野、范围和条目词汇。默认时间视野为 now/next/later，默认条目词汇为能力/功能，仅在有助于说明顺序或匹配项目用语时使用史诗、里程碑、阶段等敏捷式名词。
- 侦察来源材料：读取用户提供的文档、issue、工单、想法、设计、计划、README、AGENTS.md/CLAUDE.md、CONTEXT.md、ADR 和现有路线图。若路线图来自 improve，则读取选中的发现、被拒绝的发现和依赖说明；若来自构思流程，则读取相关 docs/ideas/、docs/tickets/ 和 docs/agents/<slug>/ 产物。
- 在缺少候选时进行轻量只读方向侦察：TODO/FIXME 主题、半成品界面、已记录但未交付的承诺、表面不对称、高变更区域，以及当前架构使其成本较低的相邻能力。
- 将每个候选规范化为统一结构，包含类型、成果、证据、首个切片、依赖、风险、置信度和下一步交接。
- 按杠杆而非数量排序：优先解锁或降低后续工作风险的事项、高价值低工作量且有强证据的事项、在承诺前消除重大不确定性的学习型探索，以及在前置条件和验证关卡就绪后才推进的高风险或高成本事项。
- 为持久产物选择形态：项目根目录的 ./ROADMAP.md 作为规范项目路线图；若存在 ./docs/ 则使用 ./docs/roadmaps/<slug>.md，否则使用 ./roadmaps/<slug>.md。
- 使用 assets/roadmap-template.md，省略没有决策价值的可选章节。若目标已存在，则读取并就地更新，保留有用的历史决策，将过时条目标记为已被取代而非静默删除。
使用方式
调用变体包括：裸 roadmap 构建标准 now/next/later 路线图；quick 不做广泛侦察，仅使用提供的产物和明显的仓库文档；deep 在排序前进行更充分的来源审查和候选发现；product、technical、migration、release、agent-execution 聚焦路线图视角；from improve / from tickets / from ideas / from plans 优先处理这些来源。
工作流程分为五个阶段：设定高度、侦察、规范化候选、优先级排序与顺序安排、编写与协调。每个 Now 条目都需要明确的下一步动作：模糊的产品范围交给 brainstorm，缺失事实或代码库未知交给 questions 或 research，未决技术选择交给 design-discussion，已决定的实现交给 writing-plans，已经战术化且很小的事项则询问是直接执行还是记录为小型 writing-plans 条目，没有有用动作则停止。
适用场景
适用于维护者、产品负责人、实现代理、贡献者、领导层或未来的自己需要理解即将开展的工作时。可用于整个仓库、产品领域、功能族、技术债务、发布、迁移或代理执行栈。
限制
绝不修改源代码，除非用户明确要求下游产物，否则只编写路线图产物。不运行变更性命令。若证据薄弱，将候选标记为低置信度而非填充内容。默认侦察在能命名 5–10 个有来源的合理候选或明显来源集耗尽时停止；若找到少于三个候选，应说明并解释证据缺口。没有容量证据的日期是虚假精确。常见错误包括把路线图当作待办事项堆砌、编造日期、让通用想法进入、为每个条目做设计、编写 PR 级实现计划以及隐藏不确定性。