architecture-decision-records

此技能为团队提供了一个结构化的框架，用以记录重大架构决策的背景、基本原理与后续影响。通过使用如 MADR (Markdown 架构决策记录) 或 Y-Statement 等标准化格式，团队能够有效地传达技术策略、确保项目间的一致性，并为新成员加入或审查过往设计决策提供历史透明度。该技能旨在作为项目知识的动态存储库，防止长期开发过程中设计背景信息的遗失。

• 标准化模板：包含 MADR、轻量级 ADR、Y-Statement 以及针对弃用决策的模板，以适应不同复杂度的项目需求。

• 生命周期管理：协助追踪决策从「提议」、「接受」、「弃用」到「被取代」的状态变更。

• 决策驱动因素：协助明确定义需求，例如 ACID 合规性、可扩展性、安全性和开发者体验 (DX)。

• 后果分析：鼓励针对每个技术路径深入评估其正面效益、负面影响及潜在风险。

• 文档最佳实践：提供关于何时编写 ADR (如采用新框架、API 设计) 以及何时无需编写 (如修复 Bug、小版本更新) 的明确指导。

• 适用对象：负责复杂系统设计或团队技术方向调整的资深开发者、系统架构师及工程经理。

• 使用时机：在设计审查会议中或规划大型基础设施变更时使用，确保所有相关人员对决策背后的「为什么」达成共识。

• 输入需求：需要项目需求、技术限制与候选技术；输出为可直接整合至版本控制文档文件夹中的结构化 Markdown 文件。

• 整合性：设计用于 Claude Code 环境中，并与其他项目管理及开发工具协作，协助维护高完整性的架构历史记录。