auto-sync: 2026-05-18 23:01:31

docs/design/architecture-v2.6.md

@@ -1558,20 +1558,26 @@ CREATE INDEX IF NOT EXISTS idx_reviews_output ON reviews(output_id);
 | comments | 讨论、@mention、协商过程 | 自然语言 | ❌ 无 |
 | reviews | 正式评审结论 | 结构化 JSON | ✅ 必须有 |
 
-### 9.7 协商流程与状态机对齐
+### 9.7 协商流程与状态机对齐（v2.8 更新）
 
-**现有状态机**：`pending → claimed → working → review → done`
+**现有状态机（v2.8，11个状态）**：`pending → claimed → working → review → done`
 
 | 状态转换 | 触发条件 | 对应阶段 |
-|---------|---------|---------|
+|---------|---------|--------|
 | working → working | 方案审查 needs_revision | 阶段 1 |
 | working → review | 写 output + Guardrail 通过 | 阶段 2→3 |
 | working → working | Guardrail rejected（自动打回） | 阶段 2 |
+| working → escalated | Agent 遇到无法处理的问题 | 任意阶段 |
+| working → waiting_human | Agent 触发 Checkpoint | 任意阶段 |
 | review → done | 产出审查 approved | 阶段 3 |
 | review → working | 产出审查 needs_revision | 阶段 3 |
-| review → review（加 escalated flag） | 超轮次升级用户 | 阶段 3 |
+| review → escalated | 超轮次升级用户 | 阶段 3 |
+| review → waiting_human | 审查阶段需人工裁定 | 阶段 3 |
+| waiting_human → working | Checkpoint reject（驳回） | 阶段 3 |
+| waiting_human → done | verify Checkpoint approve（通过） | 阶段 3 |
+
+**v2.8 变更**: `escalated` 从布尔标志改为独立状态（`status="escalated"`），不再使用 `review + escalated flag` 模式。超轮次时直接进入 `escalated` 状态，通知用户裁定。用户裁定后恢复到 `working` 或 `pending`。
 
-**escalated flag**：tasks 表增加 `escalated BOOLEAN DEFAULT FALSE` 字段。超轮次时设为 TRUE 并通知用户，任务停在 review 状态等用户裁定。用户裁定后清除 flag 并推进状态。不新增 blocked 状态。
 
 low 风险任务：working → [Guardrail 自动检查] → done（跳过 review 状态）
 research 任务：working → [庞统确认] → review → done