architecture-decision-records

用途：在做出重大架构决策、选择技术栈、记录设计取舍、回顾历史决策或建立决策流程时，编写并维护架构决策记录（ADR）。\n\n主要能力：说明 ADR 应包含背景、决策与后果三要素；给出何时写、何时不写的判断；提供 Proposed→Accepted→Deprecated→Superseded（可 Rejected）的生命周期；收录多种模板，包括标准 MADR、轻量模板、Y-Statement、弃用模板与 RFC 风格；并列举 adr-tools 等自动化命令与评审清单。\n\n必要用法：按仓库约定创建 docs/adr 目录与索引 README；复制模板命名为 NNNN-title-with-dashes.md 并填写；提交评审并更新索引。示例命令：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"。\n\n适用场景：架构决策、技术选型、设计取舍、成员入职、历史决策审查与决策流程建设。\n\n限制：资料未提供该技能的具体安装方式、平台支持、费用与版本信息；模板中的示例内容仅作格式参考，不构成本项目的实际技术选择。