技能 architecture-decision-records
📝
architecture-decision-records
安全 🌐
網路存取⚙️
外部命令
快速建立清晰的架構決策
當決策沒有文件記錄或分散四處時，團隊會失去脈絡。此技能提供 ADR 範本、生命週期指導和審查清單，以一致的方式記錄決策。
支援: Claude Codex Code(CC)
1
下載技能 ZIP
2
在 Claude 中上傳
前往 設定 → 功能 → 技能 → 上傳技能
3
開啟並開始使用
測試它
正在使用「architecture-decision-records」。 Write an ADR to adopt Redis for caching product pages.
預期結果:
- ADR-0010: Use Redis for product page caching
- Status: Accepted
- Context: Slow page loads during peak traffic
- Decision: Add Redis as a read through cache
- Consequences: Faster reads, added cache invalidation work
正在使用「architecture-decision-records」。 Create an ADR for choosing between REST and GraphQL.
預期結果:
- ADR-0015: Use GraphQL for the API layer
- Status: Accepted
- Context: Mobile clients need flexible data fetching
- Decision: Adopt GraphQL with Apollo Server
- Considered: REST API with pagination, Falcor
- Positive: Reduced over-fetching, strong typing
- Negative: Added complexity, caching challenges
安全審計
安全v4 • 1/17/2026
Pure documentation skill containing only templates and guidance for writing Architecture Decision Records. All 56 static findings are false positives: detected patterns are markdown documentation examples, harmless text strings in prose, and legitimate documentation links. No executable code, file access, network activity, or external commands are present.
2
已掃描檔案
605
分析行數
2
發現項
4
審計總數
風險因素
🌐 網路存取 (9)
⚙️ 外部命令 (25)
SKILL.md:40-44 SKILL.md:44-50 SKILL.md:50-144 SKILL.md:144-145 SKILL.md:145-149 SKILL.md:149-174 SKILL.md:174-175 SKILL.md:175-179 SKILL.md:179-188 SKILL.md:188-192 SKILL.md:192-237 SKILL.md:237-241 SKILL.md:241-261 SKILL.md:261-267 SKILL.md:267-310 SKILL.md:310-316 SKILL.md:316-325 SKILL.md:325-329 SKILL.md:329-345 SKILL.md:345 SKILL.md:345-357 SKILL.md:357-361 SKILL.md:361-379 SKILL.md:379-383 SKILL.md:383-405
審計者: claude 查看審計歷史 →
品質評分
38
架構
100
可維護性
85
內容
21
社群
100
安全
91
規範符合性
你能建構什麼
記錄重大選擇
為資料庫、平台和整合決策建立結構化 ADR。
標準化決策日誌
在團隊間採用一致的 ADR 流程和審查清單。
審視過去的決策
在入職期間了解歷史選擇及其後果。
試試這些提示
草擬簡單 ADR
為在前端採用 TypeScript 建立輕量級 ADR。包含脈絡、決策和後果。
選項比較 ADR
撰寫標準 ADR，比較產品目錄的 PostgreSQL、MySQL 和 MongoDB。
取代 ADR
草擬廢止 ADR，以 PostgreSQL 取代 MongoDB，包含遷移計劃。
RFC 風格 ADR
為訂單管理的事件溯源建立 RFC 風格 ADR，包含動機、設計、缺點和替代方案。
最佳實務
- 在實作開始前撰寫 ADR
- 記錄正面和負面的後果
- 連結相關的 ADR 並隨時間更新狀態
避免
- 編輯已接受的 ADR 而非取代它們
- 省略脈絡和決策驅動因素
- 使用模糊語言而無明確決策
常見問題
這是否與 Claude、Codex 和 Claude Code 相容？
是的，這是純文字指導和範本，可在任何助手環境中使用。
我應該預期什麼限制？
它僅提供範本和清單，不會自動化建立檔案。
它是否可以與 adr-tools 或我的儲存庫整合？
它包含 adr-tools 指令，但不會執行它們或編輯檔案。
它是否會存取我的資料或密碼？
不，它包含靜態文件，沒有資料存取行為。
如果 ADR 感覺太長怎麼辦？
使用輕量級範本，並將內容限制在必要的脈絡和決策。
這與設計文件有何不同？
它記錄特定的決策和理由，而非完整的實作細節。