用途:在做出重大架构决策、记录技术选型与设计权衡、帮助新人了解历史决策、建立决策流程时,使用本技能创建和维护架构决策记录(ADR)。仅需记录小型实现细节、常规补丁或维护、没有架构决策可记录时,不应使用。
主要能力:提供多种模板,包括标准 MADR 格式、轻量级 ADR、Y-Statement、弃用型 ADR、RFC 风格;覆盖 ADR 生命周期(Proposed → Accepted → Deprecated → Superseded,或 Rejected);给出目录结构、索引 README、评审清单与最佳实践。
使用方式:将模板复制为 NNNN-title-with-dashes.md,填写背景、决策驱动、备选方案、决策、理由、后果、实施说明、相关决策与参考;提交 PR 评审,通过后更新索引。可用 adr-tools 自动化:brew install adr-tools;adr init docs/adr;adr new "Use PostgreSQL as Primary Database";adr new -s 3 "Deprecate MongoDB in Favor of PostgreSQL";adr generate toc > docs/adr/README.md;adr link 2 "Complements" 1 "Is complemented by"。
适用场景:新框架采用、数据库技术选择、API 设计模式、安全架构、集成模式等。
限制:不适用于小型实现细节、常规维护或无架构决策的情况;已接受的 ADR 不应直接修改,应新建 ADR 取代;资料未提供具体收费、价格、平台或效果信息。