auto-sync: 2026-05-27 00:45:18

docs/design/v2.8-direction-notes.md

@@ -0,0 +1,82 @@
+# 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`