用途:从规格说明文件中提取架构决策,生成符合 MADR(Markdown Any Decision Records)格式的架构决策记录(ADR)。
何时创建 ADR:当规格说明包含技术选型(数据库、框架、库)、架构模式(微服务、CQRS、事件溯源)、集成方式(同步/异步、REST/GraphQL)、安全决策(认证方式、加密)、重要权衡(性能与简洁性)或对现有模式的偏离时。
MADR 格式包含:标题(命令式)、Status(Proposed/Accepted/Deprecated/Superseded by ADR-XXX)、Context、Decision、Consequences(Positive/Negative/Neutral)、Alternatives Considered(含 Pros/Cons/Why Rejected)。
工作流程:加载规格说明并识别决策点;提取显式决策(“We will use X”)与隐式决策(提到的技术);若无文档则研究备选方案的利弊与拒绝理由;按 MADR 格式生成 ADR;分配编号并保存到 docs/adr/(或用户指定位置);更新 ADR 索引。
参数:$1 为规格说明文件路径;--decision 指定要记录的决策;--output 指定输出目录(默认 docs/adr/);--number 指定 ADR 编号(未提供则自动分配)。
用法示例: /spec-driven-development:adr-create .specs/auth/spec.md /spec-driven-development:adr-create .specs/auth/spec.md --decision "Use JWT for session tokens" /spec-driven-development:adr-create .specs/auth/spec.md --output docs/adr/ /spec-driven-development:adr-create .specs/auth/spec.md --number 42
相关命令:/spec-driven-development:specify(生成规格说明)、/spec-driven-development:plan(生成设计)、/spec-driven-development:validate(验证规格说明)。
限制:资料未提供安装命令、平台支持范围、收费信息或具体模型依赖;实际可用性以对应插件环境为准。