architecture-decision-records

架构决策记录 (ADR) 为项目生命周期中记录关键技术选择提供了结构化的方法论。通过捕捉架构模式、技术选型与设计权衡背后的“原因”，此技能协助团队避免决策疲劳与架构记忆丧失。它专为需要维护组织知识、促进新成员顺利入职，并确保历史决策保持透明与可审查性的技术负责人、软件架构师与工程团队设计。

• 标准化文档：包含标准 MADR 格式、轻量级 ADR、Y-语句与弃用记录的模板。

• 决策生命周期管理：追踪决策从提案到被接受、弃用或取代的演变过程。

• 策略清晰度：明确区分实现细节与重大架构变更，协助团队优先处理需要正式记录的事项。

• 情境归档：对于记录数据库选择、API 设计、安全架构与集成模式相关的取舍至关重要。

• 团队共识：确保所有利益相关者理解复杂技术决策背后的逻辑，减少代码审查与未来重构期间的摩擦。

• 在启动新项目或进行技术堆栈重大调整（例如框架采用、数据库迁移或重大安全性变更）时使用此技能。

• 建议针对版本微幅升级、例行配置变更或错误修复跳过此步骤。

• 输入通常涉及技术需求、性能基准测试与考虑过的替代方案。

• 输出为存储在存储库中的结构化 Markdown 文档，作为设计逻辑的单一事实来源。

• 与现有的存储库文档工作流程无缝集成，以维护技术演进的可搜索历史记录。