Decision Log

记录所有"选 A 而不选 B"的设计决策，形成可追溯的决策链条。

When to Use

• 架构设计时，在多个技术方案中做了选择
• 任何 skill 输出中，出现了"采用 X 而不采用 Y"的描述
• 技术选型会议后，需要记录决策依据
• Code review 时发现设计意图不清晰

NOT When to Use

• 选择是显然的"默认值"——即业界通行做法、没有合理替代方案、不选它反而需要额外理由
  • 示例：用 UTF-8 编码（不用记录，因为 UTF-8 是业界标准）
  • 示例：用 JSON 作为 API 响应格式（不用记录，因为 JSON 是 Web API 通用格式）
  • 示例：使用 Git 管理代码（不用记录，因为这是基础工具而非设计决策）
  • 反例：用 UTF-8 而不是 GBK 编码 → 值得记录，因为有编码选择的权衡考量
• 两个选项没有本质差异（无论选哪个对系统无实质影响）
• 纯个人偏好，无客观依据（无法论证为什么 A 比 B 更好）

Input

Output Schema

Minimum Viable Output

• 至少 5 条决策记录
• 每条包含：决策内容、选中选项、放弃选项、选择原因

Complete Output

• 完整决策日志（覆盖所有非平凡选择）
• 每条决策标注来源文档
• 按时间/模块/优先级排序
• 决策状态（现行/已推翻/待定）

Dependencies

Procedure

Phase 1: 识别决策点

在设计文档中，任何出现以下模式的句子都是决策点：

❌ 采用了 X               （没有说明为什么不选 Y）
❌ 使用 X 进行存储         （没有说明为什么不是 Y）
❌ 选择 X 架构            （没有说明为什么不是 Y）
❌ 决定支持 X             （没有说明为什么不是 Y）

✅ 决策：采用 X 而不选 Y，因为 [原因]
✅ 决策：选择 X 方案，主要考虑 [权衡因素]

Phase 2: 记录决策模板

## 决策记录模板

| 字段 | 内容 |
|------|------|
| 决策 ID | DEC-XXX（DEC-001, DEC-002...）|
| 决策时间 | YYYY-MM-DD |
| 决策者 | [角色/团队] |
| 所属阶段 | [incubation/requirements/architecture/delivery...] |
| 决策来源 | [对应的设计文档] |
| 决策类型 | 技术选型 / 架构模式 / 工具选择 / 流程决策 |

### 决策内容
[一句话描述这个决策]

### 选中方案
**[方案名称]**
[方案描述，包括关键参数/配置]

### 放弃方案
**[方案名称]**
[方案描述]

### 选择原因
[为什么要选这个？可以包含：]
- 优势 1：[具体说明]
- 优势 2：[具体说明]
- 风险缓解：[这个选择规避了什么风险]

### 风险与权衡
[这个选择引入了什么代价？有没有被刻意接受的权衡？]

### 状态变更历史
| 日期 | 状态 | 变更原因 |
|------|------|---------|
| YYYY-MM-DD | 现行 | - |

### Phase 3: 决策分类

```markdown
## 决策分类索引

### 架构类
| DEC-ID | 决策 | 日期 | 状态 |
|--------|------|------|------|
| DEC-001 | ... | 2026-04-30 | 现行 |

### 技术栈类
| DEC-ID | 决策 | 日期 | 状态 |
|--------|------|------|------|
| DEC-002 | ... | 2026-04-30 | 现行 |

### 流程类
| DEC-ID | 决策 | 日期 | 状态 |
|--------|------|------|------|
| DEC-003 | ... | 2026-04-30 | 现行 |

Phase 4: 决策状态追踪

## 决策状态

| DEC-ID | 决策 | 状态 | 变更原因 |
|--------|------|------|---------|
| DEC-001 | ... | 现行 | - |
| DEC-002 | ... | 已推翻 | 2026-05-01: 发现原假设不成立 |

决策触发规则

以下情况必须记录决策：

与 ADR 的关系

decision-log 是 ADR（Architecture Decision Record）的父集：

• ADR 是 decision-log 的子集，专门用于架构决策
• 一个架构决策 → 一个 ADR 记录 + 一个 decision-log 条目
• 非架构决策（工具选择、流程决策）→ decision-log 条目（不必创建 ADR）

decision-log 按时间轴记录所有决策；ADR 侧重于单个决策的完整文档化。两者共同存储在 wiki/08-history/decision-log.md。

与其他 Skill 的集成

decision-log 不是独立运行的 skill，而是嵌入在其他 skill 的 Procedure 中：

集成方式：在对应 skill 的 Procedure 中，增加一条：

在完成 [选择] 后，立即在 decision-log 中记录：
- 选中方案：[方案]
- 放弃方案：[方案]
- 选择原因：[原因]

Target Pages

• <项目根目录>/wiki/08-history/decision-log.md

Changelog