| source | ../../../../skills/adr-assistant/SKILL.md |
| source_version | 1.0.0 |
| translation_version | 1.0.0 |
| last_synced | "2026-03-26T00:00:00.000Z" |
| status | current |
| description | [UDS] 建立、管理和追蹤架構決策記錄（ADR） |
| name | adr |
| allowed-tools | Read, Write, Glob, Grep |
| scope | universal |
| argument-hint | [create | list | supersede ADR-NNN | 決策主題] |
架構決策記錄助手
語言: English | 繁體中文
建立、管理和追蹤架構決策記錄。捕捉重大技術決策的背景、選項和理由。
工作流程
CAPTURE ──► ANALYZE ──► DECIDE ──► RECORD ──► LINK
捕捉背景 分析選項 做出決策 記錄 ADR 建立連結
階段 1：CAPTURE | 捕捉背景
識別驅動決策的背景與限制條件。
| 步驟 | 動作 |
|---|
| 1 | 識別問題或機會 |
| 2 | 列出限制條件（時間、預算、團隊技能） |
| 3 | 定義決策驅動因素 |
階段 2：ANALYZE | 分析選項
至少探索 2 個選項，列出優缺點。
| 步驟 | 動作 |
|---|
| 1 | 腦力激盪候選方案 |
| 2 | 根據決策驅動因素評估各方案 |
| 3 | 記錄各方案優缺點 |
階段 3：DECIDE | 做出決策
選擇最佳方案並闡述理由。
階段 4：RECORD | 記錄 ADR
依照標準模板產生 ADR 檔案。
階段 5：LINK | 建立連結
與相關工件（規格、PR、程式碼）建立交叉引用。
快速參考
何時撰寫 ADR
| 撰寫 ADR | 不需要 ADR |
|---|
| 框架/函式庫選擇 | 例行性依賴更新 |
| API 合約或資料格式 | 現有架構內的 Bug 修復 |
| 部署策略變更 | 程式碼風格決策 |
| 建立新模式 | 瑣碎的實作選擇 |
經驗法則：如果 6 個月後有人可能會問「為什麼？」，就寫一份 ADR。
狀態生命週期
Proposed ──► Accepted ──► Deprecated
│
└──► Superseded by ADR-NNN
| 狀態 | 說明 |
|---|
| Proposed | 討論中，尚未決定 |
| Accepted | 已接受，應遵循 |
| Deprecated | 不再適用 |
| Superseded | 已被新 ADR 取代 |
模板摘要
# ADR-NNN: [決策標題]
- Status: [Proposed | Accepted | Deprecated | Superseded]
- Date: YYYY-MM-DD
Deciders: [參與決策者]
Technical Story: [SPEC-ID 或 Issue]
