From 2893a3b86f9a9530d17b7761de1c5c42b5115ce4 Mon Sep 17 00:00:00 2001 From: cfdaily Date: Mon, 18 May 2026 23:01:31 +0800 Subject: [PATCH] auto-sync: 2026-05-18 23:01:31 --- docs/design/architecture-v2.6.md | 16 +++++++++++----- 1 file changed, 11 insertions(+), 5 deletions(-) diff --git a/docs/design/architecture-v2.6.md b/docs/design/architecture-v2.6.md index 661e847..bb23a0b 100644 --- a/docs/design/architecture-v2.6.md +++ b/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