用途:编写、审阅和维护架构决策记录(ADR),捕捉设计 rationale 与决策的时间维度。
主要能力:起草、评审 ADR;复用仓库既有约定(位置、编号、标题、状态词汇、审批流程与修订策略),无约定时可回退到 docs/adr/ 扁平目录与 Nygard 模板(选项分析复杂时用 MADR);区分提案、决策权限与范围、实施证据三类事实;管理 proposed → accepted/rejected 及 deprecated/superseded 生命周期;维护索引与链接;通过适应度函数把 ADR 主张连接到可检查证据。
用法:先阅读仓库的 agent 指令、贡献指南、ADR 索引、模板和近期记录,再起草。文件命名用现在时祈使动词、小写连字符、.md 扩展名,如 001-choose-database.md;状态写在文档头部而非文件名。模板选择:快速单一决策用 Nygard,多方案权衡用 MADR,高风险/合规用 Tyree & Akerman,供应商采购用 Business Case,QA/合同驱动用 Planguage。
限制:本技能只负责决策 rationale 与确认链接,不负责实现执行或通用可观测性;系统级架构与变更排序应交由 software-architecture,具体工具实现交由相应操作技能。若接受状态未定,应交付 proposed 记录并指明缺失的决策,不得声称已接受。不得为套用技能而移动、重编号、重命名或重写现有 ADR。接受不等于已实现,原型通过不等于生产就绪。适用禁止编造决策人、日期或更广的批准范围。具体收费与平台信息暂未提供。