前言¶
在智能体开发和项目协作中，经常出现重复争论已关闭决策的情况，原因往往是没人记得当初关闭它的理由。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 目录。
