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

83 lines
2.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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.0`docs/PRD-v3.0.md`
- architecture-v2.6`docs/design/architecture-v2.6.md`
- Pipeline 调研报告(归档):`docs/research/pipeline-architecture-research.md`
- v2.8 Pipeline 设计(归档,已被本方向替代):`docs/design/v2.8-pipeline-architecture.md`