用途:把产品想法转成有序、粗粒度、可持续维护的路线图,并随产品交付保持真实。它回答“建什么、什么顺序、每个多重、哪些先要决策”,而不是“某个东西怎么建”(后者属于 /architect 和 /develop)。
主要能力:命令固定为 /roadmap [what],不设子命令,由技能推断行为。plan(默认):尚无路线图且有产品级想法,做完整流程,提问、拆成粗特征段、排序分阶段、写出路线图。replan:路线图已存在且无参数,核对已交付内容、纳入构建中出现的新需求、重排、排下一个切片。add:路线图已存在且参数指向单个特征,只登记一行,不重做整个产品。
路线图形态:两部分,一张精简的 At a glance 表(# · Feature · Phase · Status)和按阶段分组的清晰特征段。每个特征含标题、一到两行意图、一行 Done when(验收标准种子)、复选框步骤。原子构建任务留在 ADR 的 Build plan,路线图只保留里程碑汇总。
使用方式:先定位路线图:docs/roadmap/ 下 roadmap.md(单文件)或 index.md 加各 epic 文件;monorepo 则按 docs/roadmap/<workspace>/ 分工作区,跨仓库内容放 docs/roadmap/_root/。若 docs/ 是已发布文档站(如 docusaurus、vitepress、mkdocs、Astro Starlight、Nextra),改用 .workflow/。提问按批量决策面板进行,每轮最多 4 问,每问 2 到 4 个具体选项,恰有一个标 (recommended) 并附一句理由。状态生命周期:新特征为 planned,棕地为 existing 或 in-progress,/develop 推进 planned → in-progress → done,replan 可置为 dropped 但不删除行。每个特征带 Weight:lean、medium、full,决定下游流程强度。
适用场景:新产品或棕地仓库的下一个切片规划、交付后的路线图核对、向已有路线图追加单个特征。
限制:不选择工具、供应商、库、ORM、托管或 BaaS,工具选择留待 /architect 在 ADR 中按特征决定,因此凡涉及工具选择即标 Needs ADR: yes。只写 docs/roadmap/ 下的路线图文件,不写 ADR、代码或 AGENTS.md。输出语言要求朴素、不用任何破折号。路线图跨会话共享,写入前需重新读取并做外科式编辑,避免覆盖他人改动。期望状态不符时应标记而非覆盖。是否提供 /sync、/verify、/test 等下游命令的细节以及具体平台支持范围,资料未完全展开,暂未提供。