diff --git a/docs/design/architecture-v2.6.md b/docs/design/architecture-v2.6.md index 0ebba72..c1c728c 100644 --- a/docs/design/architecture-v2.6.md +++ b/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 间协作讨论(事件驱动版)