ADR Plan 用于把一项开发任务转化为架构决策记录(ADR)并附上可执行的实施步骤。它的定位是规划工件,而非长期文档,也不编写实现代码。
使用流程分为四个阶段。第一阶段为分析:读取任务描述、活动计划或任务清单;并发探索受影响的代码区域;梳理改动影响的调用方(函数、类型、路由的消费者);至少列出两个值得考虑的备选方案。
第二阶段为检测 ADR 环境:通过 ls docs/adr/ || ls adr/ || ls doc/adr/ 检查项目是否已有 ADR 目录。若存在则沿用,并根据既有文件推断下一个编号;若不存在则运行 npx adr init en 后继续。
第三阶段生成 ADR 内容:使用 npx adr new "<title>" 创建文件并编辑,结构包含状态(Proposed)、背景、决策、备选方案对比表、实施步骤、后果。实施步骤按依赖排序,每一步标注 Files、Depends on、Done when(具体验收标准),相互独立时可并行。整体要求控制在 1-2 页,不做堆砌。
第四阶段呈现给用户:展示 ADR 内容与文件路径,用户可以批准(保持原样)、调整(编辑后重新呈现)或取消(删除文件)。
限制方面:若任务过于简单(例如仅涉及单个文件、修复显而易见),应说明并跳过 ADR。该技能仅做规划,不生成实现代码。资料未提供收费、价格及更多平台支持信息。