auto-sync: 2026-05-29 20:41:45

docs/design/architecture-v3.0.md

@@ -536,6 +536,7 @@ Ticker.tick()
 | Agent 角色 | 被动执行者（固定步骤 prompt） | 自主决策者（读黑板→想→干→写回） |
 | 谁决定执行路径 | Daemon（if/else + YAML） | Agent（根据黑板信息自主判断） |
 | Agent 间通信 | 无（Daemon 中央调度） | 黑板 comment + observation + @mention |
+| Session 管理 | `--session-id UUID` → 新 session → 爆炸 | main session + subagent delegation |
 
 **业界印证**：
 
@@ -551,6 +552,14 @@ Ticker.tick()
 3. ❌ blackboard_* 工具封装（优先级低，当前 curl + API 方式可用）
 4. ❌ Skill 集群模板（和 Agent 自主决策矛盾）
 
+**Spawn 改造方向**（详见 `docs/design/02-main-session-delegation.md`）：
+
+现行 `openclaw agent --session-id UUID` 导致 session 爆炸（E2E 测试 6 Agent 产生 68 个 session）。改造为：
+- 所有 spawn 统一走 `spawn_full_agent(use_main_session=True)`（复用 Mail 路径已验证的模式）
+- Agent main session 收到任务后自主决定执行方式（直接做 / sessions_spawn subagent / @mention 协作）
+- subagent 通过 `cleanup: "delete"` 用完即删，不堆积
+- 三层幻觉门控：Daemon 确定性检查 → 文件存在性验证 → AI 验证
+
 > ⚠️ **澄清**：§10.5 Handoff Schema 不是 Pipeline 框架。Handoff 是 Agent 间的结构化交接文档（上家写给下家），是信息传递，不是执行编排。Pipeline 框架指的是 PipelineRouter/SingleStepPipeline 等代码级执行模式抽象，已明确不做。
 
 **涉及文件**: `src/daemon/ticker.py`、`src/daemon/dispatcher.py`、`src/daemon/spawner.py`、`src/daemon/router.py`