用途:adr-author 用于指导用户编写架构决策记录(ADR),让未来的开发者愿意阅读,并让自动化审查系统能够执行。它基于 Michael Nygard 在《Documenting Architecture Decisions》中提出的格式。
主要能力:该技能把 ADR 视为某一时刻的决策快照,回答“决定了什么、为什么、由此产生什么后果”。它强调 Decision 部分是核心,也是被强制执行的内容;Context 与 Consequences 提供推理依据。技能引入“可执行性等级”概念:HIGH 指自动化工具可检查合规(如文件路径、数值阈值、版本约束、精确格式),MEDIUM 指人类审查者能依据清晰指引判断合规,LOW 指仅作参考与背景说明。
使用方式:工作流包括读取项目现有 ADR(通常位于 docs/adr/、doc/arch/ 或 decisions/,需匹配编号方案、章节结构、语气与状态约定);理解决策、问题、备选方案及执行方式;选择可执行性等级;按 Nygard 四段式(Status、Context、Decision、Consequences)起草;针对目标等级撰写 Decision 部分;复核并细化;确保 Consequences 诚实列出收益、成本、风险与取舍。
适用场景:适用于需要记录架构选择、并希望这些记录能被 CI、linter 或代码审查执行的团队,也适用于需要向 AI 审查系统提供可执行约束的项目。
限制:资料未提供该技能的具体安装命令、收费方式、支持平台或运行环境要求,这些信息暂未提供。技能本身不替代团队对可执行性等级的选择,需由用户根据决策性质决定。