用途:该技能用于编写和维护架构决策记录(ADR),在做出重大架构决策、记录技术选型、设计权衡、新人入职和历史决策回顾时使用。
主要能力:围绕 ADR 的核心三要素——背景(为何需要决策)、决定(决定了什么)、后果(带来什么影响)组织文档;提供标准 ADR(MADR 格式)与轻量级 ADR 两类模板;说明 ADR 生命周期:Proposed -> Accepted -> Deprecated -> Superseded,以及 Rejected 分支;给出何时写、何时跳过的判断清单,例如新框架采用、数据库技术选择、API 设计模式、安全架构、集成模式应写,而小版本升级、缺陷修复、实现细节、例行维护、配置变更可跳过。
使用方式:按模板填写状态、背景、决策驱动因素、备选方案、决定、理由、后果与实施说明;轻量模板可只保留状态、日期、决策者、背景、决定与后果。参考资料 references/templates-and-management.md 涵盖 Y-Statement、Deprecation、RFC 风格模板、ADR 目录管理、adr-tools 自动化与评审清单。
最佳实践:尽早写、保持 1-2 页、诚实列出权衡、链接相关决策、状态变更时标记废弃;不要修改已接受的 ADR,应写新 ADR 取代;不要省略背景、隐藏失败或被否决的方案,避免含糊表述。
限制:资料未提供具体安装命令、收费方式、平台支持或效果数据。