docs: 简化 v0.5 设计文档第 3.6 节 - 验收机制

- 保留三向一致性检查概念图
- 简化检查方法,只保留核心三向检查
- 明确偏差处理:发现偏差后重新进入 Superpowers 五阶段工作流
- 删除详细的偏差处理策略表格,使内容更简洁
This commit is contained in:
2026-07-01 20:02:41 +08:00
parent 47df41043b
commit cc3d9e380d
@@ -111,7 +111,7 @@ sanguo_moziplus_v3 是一个基于 Claude Code 的多 Agent 协作系统。系
| **工程决策** | Linus 三问审慎判断 | 决策框架 |
| **任务分析** | 评估复杂度、确定所需 Sub Agents | 分析逻辑 |
| **编排执行** | 安排 Sub Agents、协调协作 | Agent 工具 |
| **验收整合** | 验证结果、整合输出 | requesting-code-review skill |
| **验收整合** | 验证结果、一致性检查、整合输出 | requesting-code-review skill + 一致性检查 |
**工作方式**
@@ -272,6 +272,55 @@ if (review.passed) {
}
```
### 3.6 验收机制:需求-设计-编码一致性检查
Main Agent 在验收时必须执行**三向一致性检查**:
```
┌─────────────────────────────────────────────────────────────┐
│ 验收:三向一致性检查 │
│ │
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
│ │ 需求 │ ←→ │ 设计 │ ←→ │ 编码 │ │
│ └─────────┘ └─────────┘ └─────────┘ │
│ ↑ ↑ ↑ │
│ └──────────────┴──────────────┘ │
│ 一致性检查 │
└─────────────────────────────────────────────────────────────┘
```
**检查方法**
对照三向检查,逐项验证:
- 需求 → 设计:设计是否完整覆盖需求?
- 设计 → 编码:编码是否正确实现设计?
- 需求 → 编码:实现是否满足原始需求?
**偏差处理**
发现偏差时,重新进入 Superpowers 五阶段工作流:
```
验收发现偏差
┌─────────────────────────────────┐
│ 重新进入 Superpowers 工作流 │
│ │
│ 1. 规划 (writing-plans) │ ← 需求/设计偏差
│ 2. 执行 (executing-plans) │ ← 编码偏差
│ 3. 审查 (requesting-code-review) │
│ 4. 调试 (systematic-debugging) │
│ 5. 完成 (finishing-development) │
│ │
│ → 重新验收 │
└─────────────────────────────────┘
```
**一致性检查时机**
- 复杂任务:每次 Sub Agent 完成后检查
- 中等任务:Review 阶段检查
- 简单任务:最终验收时检查
---
## 4. 工作流程