cs-roadmap 是 CodeStable 工作流中的规划层技能,用于把单条 feature 装不下的大需求(如权限系统、通知中心、SSO 接入)拆解为可独立验证的子 feature 路线。触发条件:需求大到需要拆 feature,或用户说“拆需求/开 roadmap”;也接受 cs-brainstorm 的分流移交。
主要能力:在 .codestable/roadmap/{slug}/ 下建立规划层,主文档包含背景、范围与明确不做、模块拆分(概设)、接口契约(架构层详设)、子 feature 清单与排期,另有 {slug}-items.yaml 机器可读清单、{slug}-roadmap-review.md 审查报告和可选 drafts/。工作流分七阶段:锁定目标、读取材料、拆解起草、自查清单、候选落盘并经 cs-roadmap-review 独立审查、用户 review、确认落盘(status 改为 active)。
使用方式:开始前先执行 CodeStable preflight,读 .codestable/attention.md,缺失则先 cs-onboard。模式分流为 new(新建 roadmap)与 update(增删改条目、调顺序、标废弃),每次只动一份 roadmap。子 feature 起步时由 cs-feat-design 在 design frontmatter 标注 roadmap 与 roadmap_item,items.yaml 状态回写由 cs-feat-accept 负责;全部条目 done/dropped 后主文档置 completed。
限制:不写单 feature 内部实现细节,不改 requirements/architecture/代码,不替用户决定优先级,接口契约必须写到可执行级或明确“无跨模块接口”,依赖图必须是 DAG。具体命令、模板与字段全部位于上述引用文档中,本处未提供原文。