auto-sync: 2026-05-15 13:39:11

docs/design/architecture-v2.6.md

@@ -940,28 +940,28 @@ Agent 被 spawn
    - must_haves 三件套(任务创建时由庞统定义):
      - truths:用户视角的可观测行为("用户能看到回测结果"),不是实现步骤("编写回测脚本")
      - artifacts:必须存在的产出文件
-     - constraints:继承的约束(如“不超过500行”、“必须用vnpy”)
+     - constraints:继承的约束(如"不超过500行"、"必须用vnpy")
     ↓
 5. 写 Handoff Comment → 退出
-   - Agent 结束前必须写一条结构化的交接评论（借鉴 agent-chorus checkpoint）
-   - 内容：完成什么、产出在哪、还剩什么、建议下一步
-   - 这条 comment 会出现在下一个 Agent 的 L1 消息中（最近 3 条评论），实现无缝接手
-   - 示例：
+   - Agent 结束前必须写一条结构化的交接评论(借鉴 agent-chorus checkpoint)
+   - 内容:完成什么、产出在哪、还剩什么、建议下一步
+   - 这条 comment 会出现在下一个 Agent 的 L1 消息中(最近 3 条评论),实现无缝接手
+   - 示例:
      ```
      blackboard.py comment --task task-001 --author zhangfei-dev \
-       --body "## Handoff\n完成：分批加载实现\n产出：task-001/output-zhangfei-v2.md\n未完成：止损逻辑分批适配\n建议下一步：关羽 review 止损逻辑"
+       --body "## Handoff\n完成:分批加载实现\n产出:task-001/output-zhangfei-v2.md\n未完成:止损逻辑分批适配\n建议下一步:关羽 review 止损逻辑"
      ```
     ↓
 6. Daemon 自动清理 session
-   - 通知 Daemon（inbox JSONL）
-   - Daemon 检测到完成 → 继续下一步（解锁下游 / spawn review / 清理 session）
+   - 通知 Daemon(inbox JSONL)
+   - Daemon 检测到完成 → 继续下一步(解锁下游 / spawn review / 清理 session)
 ```
 
-**设计推导（Handoff Comment）**：
-- agent-chorus 的核心机制是 Standup + Conclude：Agent 开始时读 inbox，结束时广播状态
-- 映射到黑板：Standup = Agent spawn 后读黑板（L1），Conclude = Agent 结束时写 handoff comment
+**设计推导(Handoff Comment)**:
+- agent-chorus 的核心机制是 Standup + Conclude:Agent 开始时读 inbox,结束时广播状态
+- 映射到黑板:Standup = Agent spawn 后读黑板(L1),Conclude = Agent 结束时写 handoff comment
 - agent-chorus 的 checkpoint 广播给所有其他 Agent → 我们的 handoff comment 通过 L1 自然传递给下一个 Agent
-- 关键价值：**黑板上的状态足够让 Agent B 无缝接手 Agent A 的工作**——这正是 agent-chorus 解决的核心问题
+- 关键价值:**黑板上的状态足够让 Agent B 无缝接手 Agent A 的工作**--这正是 agent-chorus 解决的核心问题
 
 ### 5.2 Agent 工具集
 
@@ -1009,34 +1009,34 @@ python3 ~/.sanguo_projects/sanguo_moziplus/cli/blackboard.py create --title "分
 
 ## 6. 关键场景流程
 
-### 6.1 庞统规划 + Agent 领任务(事件驱动版)
+### 6.1 庞统规划 + Agent 领任务（事件驱动版）
 
 ```
-用户 → 庞统(主session):"设计一个动量因子策略"
+用户 → 庞统(主session):“设计一个动量因子策略”
     ↓
 庞统在黑板上写:
   - 创建 task-001(数据准备,pending,无依赖)
   - 创建 task-002(因子计算,pending,depends_on: [task-001])
   - 创建 task-003(回测验证,pending,depends_on: [task-002])
-  - 评论:"建议赵云领 001,张飞领 002 和 003"
+  - 评论:“建议赵云领 001,张飞领 002 和 003”
     ↓
-庞统写 signal file: task_created
+庞统写 inbox 通知: task_created
     ↓
-Daemon EventBus 收到 task_created(低优先级)
-  → Tick 批量处理: spawn 赵云通知 task-001
+Daemon Tick 发现 task-001 pending + 庞统评论建议赵云
+  → spawn 赵云（L1 消息含任务核心 + 庞统建议）
     ↓
-赵云读黑板 → claim task-001 → 执行 → 写产出 → 更新 status→done
-  → 写 signal file: task_completed
+赵云读黑板 → claim task-001 → 执行 → 写产出
+  → 写 Handoff Comment: “完成：分钟线数据下载 | 产出：task-001/data/ | 无未完成事项”
+  → 更新 status→done → 通知 Daemon（inbox JSONL）
     ↓
-Daemon EventBus 即时收到 task_completed
+Daemon ~1s 内收到 inbox 通知 → mini-tick:
   → 查询 depends_on 包含 task-001 的 pending 任务 → task-002
-  → task-002 的依赖全部满足 → 触发 task_ready
-  → spawn 张飞执行 task-002
+  → task-002 的依赖全部满足 → spawn 张飞（L1 消息含赵云的 handoff 摘要）
     ↓
-(同理 task-002 done → 即时触发 task-003)
+（同理 task-002 done → 即时触发 task-003）
 ```
 
-**对比 polling 版**:task-001 done 到 task-002 spawn 的延迟从 ≤60s 降到 ~0ms。
+**对比 polling 版**：task-001 done 到 task-002 spawn 的延迟从 ≤60s 降到 ≤1s。张飞的 L1 消息中包含赵云的 Handoff Comment，无需额外查询即可无缝接手。
 
 ### 6.2 Agent 间协作讨论(事件驱动版)