用途:从 {base_directory}/requirements/technical-requirements.yaml(由 /technical-requirements-interview 生成)提取关键架构决策,并在 {base_directory}/architecture/adrs/ 下生成独立 ADR 文件与 INDEX.md,用于记录“为什么这样设计”而非仅仅“选了什么”。
主要能力:识别候选决策(架构模式、技术栈、数据模型、API 设计、安全、测试、部署、trade_offs 与 open_questions);为每个决策推导现实替代方案;按 ADR-001 起顺序编号并给出简短声明式标题;每个 ADR 包含头部(编号、标题、状态、日期、来源)及 Context、Decision、Alternatives Considered、Consequences 四个必需部分;生成含 ID、标题、状态、日期列的 INDEX.md 汇总表;最后输出 Gap Analysis,按架构、技术栈、数据存储、API 设计、安全、测试、部署等决策领域标注是否覆盖,并列出遗留 open_questions 与建议。
使用方式:/architecture-decision-record [base-directory]。未提供目录时,自动检测当前目录下的 requirements/technical-requirements.yaml;若不存在则询问“Where are your requirements documents located?”,等待用户给出路径后存为 base_directory。随后读取该 YAML 并逐步执行。文件创建命令为 mkdir -p {base_directory}/architecture/adrs,每个 ADR 写入 {base_directory}/architecture/adrs/ADR-NNN-kebab-case-title.md。
限制:文档未提供替代方案时,应注明“alternatives not documented”,不得编造;open_questions 中无法确定为 Accepted ADR 的留作未来 ADR 候选;文档未给出对缺失 YAML 或字段的完整回退策略;未提供定价、平台与效果信息,部分细节(如 ADR 状态取值、日期格式)需参阅 references 中的 adr-document-spec.md。