adr

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]