SuperAPI AI 工具集

gsd-path-roadmap

通用与其它

查看项目

更新于 10-16 02:39

技能介绍

用途:本技能属于 GSD Path 流程的 roadmap 阶段,把已批准的方案章程(.project/CHARTER.md)拆解为按依赖排序、各自可独立发布的里程碑路线图,并完成路线图门禁与唯一一次批准,从而授权后续里程碑规划。它只处理里程碑粒度的滚动波前期范围,波次与任务属于 $gsd-path-plan。

主要能力:派发单个 roadmapper 生成路线图;对 ROADMAP.md 做结构与语义门禁(章程条目与里程碑互相覆盖、每个里程碑含 Goal、Depends on、Surfaces、Status、Archive、Scope in/out、成功标准、风险、开放问题;依赖必须指向更早里程碑且无环;M001 为最薄端到端骨架;不得出现波次/任务/文件清单);在重切分时保留已发布条目的字节一致性,废弃条目完全不变;通过捆绑脚本处理前瞻轨道、待答问题与批准检查点。

使用方式:由上游阶段按 AGENTS.md 交接规则调用,不可自行调用仅显式调用的同类技能。前置需 pipeline_state.py validate --repo <absolute root> 通过,且存在 CHARTER.md 与 SYNTHESIS.md 的已决章节、无未决 NEEDS-USER 项。状态迁移必须用 pipeline_state.py transition,不可直接编辑 STATE。先运行 python3 <absolute check_handoffs.py> roadmap --repo <absolute root> 做结构检查,再执行语义门禁。重切分前先运行 scripts/promote_lookahead.py snapshot-roadmap --roadmap .project/ROADMAP.md --snapshot .project/ROADMAP.before-reslice.md,基准保留至所有修订与批准结束。批准使用:python3 <absolute pipeline_state.py> approve --repo <absolute root> --kind roadmap-reslice --milestone <reviewed milestone slug> --expected-head <recorded full HEAD>。

适用场景:项目章程已定、需要确定里程碑边界与发布顺序;里程碑边界处的重切分;放弃条目后的重新切分。限制:门禁失败仅允许一轮修订,再失败则保持进入状态并停止或转 blocked;里程碑内重定范围不合法;中途不得手改 STATE、单独删除基准或检查点;未提供 Git 时走 --defer-checkpoint 延迟路径。资料未提供具体收费、平台与价格信息。