SuperAPI AI 工具集

adr-roadmap

编程与开发

查看项目

更新于 10-16 01:28

技能介绍

用途:读取项目中的架构决策记录(ADR,Layer 5),产出分阶段实施路线图,包含依赖映射、关键路径、阶段分解、时间估算、各阶段风险评估以及测试与技术债策略。该技能与引擎无关,适用于 web、移动、数据、ML、基础设施、嵌入式等任意领域。上游为 ADR,下游为 SPEC → TDD → IPLAN 交付排序。

适用场景:项目约有五个或更多 ADR,需要协调、分阶段推进;需要看清架构依赖与关键路径;相关方需要基于 ADR 复杂度得到时间线、里程碑和执行摘要。不适用场景:单个且实现简单的 ADR;无构建工作的信息型 ADR;从需求出发的规划(应使用 doc-brd/doc-prd/doc-ears);仅需图表(应使用 charts-flow)。

主要能力与用法:清点全部 ADR-*.md,提取 ID、标题、状态、复杂度(1–5)、工作量与依赖;对缺失复杂度或断裂依赖引用告警,找不到 ADR 则报错。构建依赖图,区分硬/软/无依赖,检测环路(报错),计算关键路径,找出可并行执行的簇。按复杂度映射基础工作量,汇总并加约 20% 风险缓冲,标记高风险 ADR(复杂度 4–5 且依赖多)。按所选阶段模型(默认 poc-mvp-prod,另有 iterative、waterfall)划分阶段,遵守依赖、阶段时长上限默认 8 周、隔离风险、在自然里程碑收尾,并针对绿地、棕地/迁移(增加回滚与双跑)、重构(逐模块)适配。根据工作量与团队规模推导阶段时长,加入阶段间缓冲,并借助 charts-flow 生成含里程碑的甘特图。最终写入 {adr_dir}/ADR-00_IMPLEMENTATION-ROADMAP.md,含文档控制、执行摘要、各阶段章节(目标、ADR、架构图、顺序、交付物、成功/退出标准、风险)、依赖矩阵、技术债管理、风险评估、测试策略,以及向上游(BRD–BDD)和下游(SPEC/TDD/IPLAN)的可追溯性。

限制:必须原样使用 ADR 决策,不得自行做技术选型;每个 ADR 只能映射到一个阶段;不得超过阶段时长上限;语言保持客观;生产阶段必须有回滚计划;每份文档控制在 10 万 token 以内。相关资源包括 ADR 层 README 与模板、ID 命名标准、可追溯性文档、charts-flow 及下游 doc-spec/doc-tdd/doc-iplan、doc-validator。其他细节资料未提供。