前言¶
在智能體開發和項目協作中，經常出現重複爭論已關閉決策的情況，原因往往是沒人記得當初關閉它的理由。decision-records 插件旨在解決這個問題，幫助團隊記錄那些難以回退或難以重新爭論的決策。
這是什麼¶
decision-records 是一個輕量級決策記錄工具，由 ChenneyZhuang 維護。它遵循 MIT 許可證，核心價值在於記錄決策時的理由，而非僅僅記錄結論。它不需要模板儀式或審批流程，且保持零依賴。
核心功能¶
- 僅追加模式：使用新記錄覆蓋舊記錄，而不是重寫歷史。重寫歷史是導致記錄腐爛的原因。
- 零依賴：只有一個 SKILL.md 文件。
- 零儀式：沒有模板儀式或審批工作流。
- 位置：決策記錄保存在項目所在地（倉庫或文檔）。
安裝¶
在終端中執行以下命令：
git clone https://github.com/ChenneyZhuang/decision-records ~/.claude/skills/decision-records
典型用法¶
- 在項目文檔中創建一個名爲
decisions.md的文件，或者將其作爲現有文檔的一個章節，放在它所治理的工作旁邊。 - 使用標準的 5 行格式記錄決策。
示例格式如下：
### 2026-09-14 — Use plan B for syncing
- Decision: sync via UUID, not timestamps
- Alternatives: timestamps (rejected: clock skew across devices)
- Why: IDs survive offline edits; timestamps silently drop concurrent rows
- Reversible? yes — migration script exists
適用場景與注意¶
- 適用對象：團隊協作場景價值最大，個人項目通常只需要 2-3 條記錄。
- 記錄時機：必須在決策做出的那一刻記錄理由。會後補記的記錄補的是記憶，不是理由。
- 環境變化：記錄的是決策當時的理由；背景變化可能會讓“當時正確”的決策變成“現在存疑”的決策，替代流程（supersede）正是爲此設計。
- 權限檢查：插件以當前 DSH 進程權限運行，安裝前請檢查源碼與許可證。
結語¶
decision-records 通過記錄決策理由和保持歷史可讀性，避免重複爭論。更多信息可訪問 GitHub 倉庫 或 DSH 目錄。
