关于 adr-roadmap
面向需要协调多个架构决策记录的项目团队，将 ADR 转化为分阶段实施路线图。它梳理依赖、关键路径、工期、风险和测试策略，并保持技术选择遵循 ADR。
主要功能
- 01盘点 ADR 并检查依赖引用
- 02构建依赖图并计算关键路径
- 03估算工作量并识别高风险项
- 04按依赖划分实施阶段
- 05生成含里程碑的时间线
- 06记录风险、测试与技术债策略
适用场景
- 01规划多个 ADR 的协调落地
- 02向利益相关者呈现阶段与时间线
- 03安排迁移项目的回滚和双轨运行
- 04依据架构决策制定交付顺序
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/adr-roadmap确认已加载。
详细介绍
adr-roadmap
用途
分析项目的架构决策记录（ADR，第 5 层），并制定分阶段实施路线图：依赖关系映射、关键路径、阶段划分、时间估算、各阶段风险评估，以及测试和技术债务策略。不依赖特定引擎，适用于任何领域（Web、移动端、数据、ML、基础设施、嵌入式）。
上游：ADR。下游：为 SPEC → TDD → IPLAN 的交付顺序提供依据。
适用场景
在以下情况下使用 adr-roadmap：
- 项目有大约五个或更多 ADR，需要协调并分阶段推出。
- 需要了解架构依赖关系和关键路径。
- 利益相关方需要根据 ADR 的复杂度制定时间表、里程碑和执行摘要。
以下情况不要使用：单个 ADR 的实现简单明了；没有构建工作的说明性 ADR；根据需求进行规划（使用 ../doc-brd/SKILL.md / ../doc-prd/SKILL.md / ../doc-ears/SKILL.md）；或只需要图表（使用 ../charts-flow/SKILL.md）。
行为
- 清点 ADR — 阅读每个
ADR-*.md，提取 ID、标题、状态、复杂度（1–5）、工作量和依赖关系；对于缺失复杂度或无效依赖引用发出警告；如果找不到 ADR，则报错。 - 构建依赖关系图 — 将依赖关系分类为硬依赖／软依赖／无依赖，检测循环（报错），计算关键路径，并找出可并行执行的集群。
- 估算工作量 — 将复杂度映射为基础工作量，汇总所有 ADR 的工作量，加入风险缓冲（约 20%），并标记高风险 ADR（复杂度为 4–5 且依赖较多）。
- 划分阶段 — 应用所选的阶段模型（默认
poc-mvp-prod，也可选iterative或waterfall），同时遵循依赖关系、限制阶段时长（默认 8 周）、隔离风险，并以自然里程碑作为阶段结束点。根据绿地、棕地／迁移（增加回滚和双轨运行），或重构（按模块逐一进行）项目进行调整。 - 制定时间表 — 根据工作量和团队规模推算阶段时长，加入阶段间缓冲，并通过
../charts-flow/SKILL.md生成包含里程碑的甘特图。 - 在
{adr_dir}/ADR-00_IMPLEMENTATION-ROADMAP.md编写路线图：包含文档控制、执行摘要、各阶段章节（目标、ADR、架构图、顺序、交付物、成功／退出标准、风险）、依赖关系矩阵、技术债务管理、风险评估、测试策略，以及追溯至上游（BRD–BDD）和下游（SPEC/TDD/IPLAN）工件的追溯关系。
约束：原样采用 ADR 决策（不做技术选型）；每个 ADR 必须且只能映射到一个阶段；不得超过阶段时长上限；语言保持客观；生产阶段必须制定回滚计划。每份文档不得超过 100k 个 token。
相关资源
- ADR 层：
${CLAUDE_PLUGIN_ROOT}/framework/layers/05_ADR/README.md·${CLAUDE_PLUGIN_ROOT}/framework/layers/05_ADR/ADR-TEMPLATE.yaml - ID 和标签规范：
${CLAUDE_PLUGIN_ROOT}/framework/governance/ID_NAMING_STANDARDS.md - 追溯关系：
${CLAUDE_PLUGIN_ROOT}/framework/governance/TRACEABILITY.md - 图表：
../charts-flow/SKILL.md - 下游生成：
../doc-spec/SKILL.md·../doc-tdd/SKILL.md·../doc-iplan/SKILL.md - 追溯检查：
../doc-validator/SKILL.md
评论
支持 Markdown