Files
sanguo_moziplus_v2/docs/design/v2.8-direction-notes.md
T
2026-05-27 00:45:18 +08:00

2.9 KiB
Raw Blame History

v2.8 设计方向备忘

日期: 2026-05-27
作者: 庞统
状态: 方向确认,记录备忘


核心方向:Daemon 退化 + Agent 进化

业界印证(Claude Code Agent Teams / Hermes Kanban)都在往这个方向走。

当前(v2.7 未来(AI Native
Daemon = 调度器 + 路由器 + 决策者 Daemon = 投递员 + 看护人
Agent = 被动执行者(拿到固定步骤 prompt) Agent = 自主决策者(读黑板→想→干→写回)

不做的事

  1. 不做 Pipeline 框架PipelineRouter / SingleStepPipeline / MultiStepPipeline / ParallelPipeline

    • 各种执行模式(parallel/loop/saga/interactive)不需要代码层面的 Pipeline 类
    • Agent 自己根据黑板信息决定执行策略
  2. 不做黑板摘要注入

    • Agent 已经有 API 能力读黑板全局状态
    • 让 Agent 自己决定看什么,比系统预注入更 AI native
    • 当前 prompt 确实需要改,但改的是"告诉 Agent 能做什么",不是"帮 Agent 把数据准备好"
  3. 不做 blackboard_ 工具封装*

    • 当前 curl + API 方式已经能用
    • 工具封装是优化项(省 token、降出错率),不是必须项
    • 优先级低,v2.10 再考虑

要做的事

v2.8:Mail 独立(代码整理,不改功能)

当前 46 处 if/_mail 散落在 ticker/dispatcher/spawner 里。Mail 是机械投递,不需要智能,独立出来:

  • 新建 mail_handler.py,集中 Mail 投递逻辑
  • ticker/dispatcher/spawner 里的 Mail 方法标注废弃,调用改为 mail_handler.tick()
  • 不新建 Pipeline 框架,不搞 PipelineRouter

v2.9+:Prompt 进化(从固定步骤 → 自主决策)

当前 prompt 的问题:把 Agent 限制在固定步骤(标 working → 干活 → 写产出 → 标 review)。

改 prompt

  • 告诉 Agent 它能做什么(API 列表 + 能力说明)
  • 不告诉它具体步骤(让 Agent 自己决定)
  • 告诉它约束(安全红线、完成标准)

v2.10+Agent 进化

  • Agent 自主 claim(从 Daemon 分配 → Agent 领活)
  • Agent 间感知(comment + observation + @mention
  • Daemon 简化为纯投递员

场景覆盖方式

28 个场景不需要 28 种 Pipeline。Agent 自己根据黑板信息决定执行策略:

  • 批量回测?张飞读黑板,看到多组参数,自己决定怎么拆
  • Saga 链?Agent 自己决定步骤链和补偿
  • 审议循环?司马懿自己决定是否通过,不通过就在黑板写驳回

约束是硬的(guardrail 拦截、成本上限、审批要求),执行是软的(Agent 自主决策)。


参考

  • PRD v3.0docs/PRD-v3.0.md
  • architecture-v2.6docs/design/architecture-v2.6.md
  • Pipeline 调研报告(归档):docs/research/pipeline-architecture-research.md
  • v2.8 Pipeline 设计(归档,已被本方向替代):docs/design/v2.8-pipeline-architecture.md