architecture-decision-records

name	architecture-decision-records
description	在Claude Code会话期间，将做出的架构决策捕获为结构化的架构决策记录（ADR）。自动检测决策时刻，记录上下文、考虑的替代方案和理由。维护一个ADR日志，以便未来的开发人员理解代码库为何以当前方式构建。
origin	ECC

架构决策记录

在编码会话期间捕捉架构决策。让决策不仅存在于 Slack 线程、PR 评论或某人的记忆中，此技能将生成结构化的 ADR 文档，并与代码并存。

何时激活

• 用户明确说"让我们记录这个决定"或"为这个做 ADR"
• 用户在重要的备选方案（框架、库、模式、数据库、API 设计）之间做出选择
• 用户说"我们决定..."或"我们选择 X 而不是 Y 的原因是..."
• 用户询问"我们为什么选择了 X？"（读取现有 ADR）
• 在讨论架构权衡的规划阶段

ADR 格式

使用 Michael Nygard 提出的轻量级 ADR 格式，并针对 AI 辅助开发进行调整：

# ADR-NNNN: [决策标题]

**日期**: YYYY-MM-DD
**状态**: 提议中 | 已接受 | 已弃用 | 被 ADR-NNNN 取代
**决策者**: [相关人员]

## 背景

我们观察到的促使做出此决策或变更的问题是什么？

[用 2-5 句话描述当前情况、约束条件和影响因素]

## 决策

我们提议和/或正在进行的变更是什么？

[用 1-3 句话清晰地陈述决策]

## 考虑的备选方案

### 备选方案 1: [名称]
- **优点**: [益处]
- **缺点**: [弊端]
- **为何不选**: [被拒绝的具体原因]

### 备选方案 2: [名称]
- **优点**: [益处]
- **缺点**: [弊端]
- **为何不选**: [被拒绝的具体原因]



由于此变更，哪些事情会变得更容易或更困难？


 [益处 1]
 [益处 2]


 [权衡 1]
 [权衡 2]


 [风险及缓解措施]