auto-sync: 2026-04-11 12:40:02

2026-04-11 12:40:02 +08:00
parent b7274aa52d
commit 3b56d9a86e
1 changed files with 304 additions and 0 deletions
@@ -0,0 +1,304 @@
+# 三个主流多Agent项目协作模式分析报告
+
+**日期**：2026-04-11  
+**分析人**：庞统 (pangtong-fujunshi)  
+**项目**：Hermes Agent / oh-my-codex / oh-my-claudecode
+
+---
+
+## 目录
+
+1. [项目概览](#一项目概览)
+2. [多Agent协作模式对比](#二多agent协作模式对比)
+3. [任务依赖控制实现](#三任务依赖控制实现)
+4. [通信共享信息实现](#四通信共享信息实现)  
+5. [提示词设计总结](#五提示词设计总结)
+6. [对三国量化项目的借鉴](#六对三国量化项目的借鉴)
+
+---
+
+## 一、项目概览
+
+| 项目 | 开发者 | 定位 | 目标 |
+|------|--------|------|------|
+| **Hermes Agent** | NousResearch | 自进化自治Agent框架 | 打造能随用户一起成长的自主Agent，从经验创建技能 |
+| **oh-my-codex** | Yeachan-Heo | OpenAI Codex CLI 工作流层 | 为 Codex CLI 预置标准工作流和专家技能 |
+| **oh-my-claudecode** | Yeachan-Heo | Claude Code 多Agent编排插件 | 为 Claude Code 提供阶段化流水线多Agent协作 |
+
+---
+
+## 二、多Agent协作模式对比
+
+### 1. Hermes Agent (NousResearch)
+
+**协作模式**：原生内置 **主Agent ↔ 隔离子Agent** 层次结构
+
+- 主Agent：理解需求 → 分解任务 → 生成子Agent提示词 → 等待结果 → 整合输出
+- 子Agent：执行分配的具体任务 → 写结果到共享内存 → 汇报完成
+- **特点**：原生支持动态生成子Agent，主Agent全权调度
+
+### 2. oh-my-codex / oh-my-claudecode
+
+**协作模式**：**阶段化流水线 + 同阶段并行**
+
+固定流程：
+```
+深度访谈澄清需求 → 制定方案计划 → 拆解任务 → 多worker并行执行 → 验证评审 → 修复循环 → 汇总交付
+```
+
+- **阶段之间**：顺序执行，必须等前一阶段完成才进入下一阶段
+- **同一阶段**：多个worker完全并行，无依赖
+- **特点**：开箱即用，适合大多数软件开发任务，用户不用自己设计流程
+
+---
+
+## 三、任务依赖控制实现
+
+### 1. Hermes Agent
+
+- **实现**：主Agent负责依赖调度，动态生成子Agent时声明依赖
+- 支持Python脚本RPC编排，可以显式定义依赖顺序
+- 优点：灵活；缺点：需要编写编排代码
+
+### 2. oh-my-codex / oh-my-claudecode
+
+#### 固定阶段流水线（默认推荐）
+
+```
+澄清 → 计划 → 执行 → 验证 → 修复
+```
+
+- 天然满足依赖：前面阶段输出就是后面阶段输入
+- 同一阶段内并行任务无依赖，直接同时跑
+- **简单够用**，绝大多数软件开发任务都能套这个流程
+
+#### 复杂依赖（支持）
+
+如果任务需要自定义依赖：
+
+- 每个任务JSON声明 `depends_on: [task-id...]`
+- 系统轮询检查所有依赖任务状态，全部 `completed` 才解锁当前任务
+- 状态存在文件系统：`.omx/state/team/{name}/tasks/task-{id}.json`
+
+#### 轮询收敛机制（核心实现）
+
+```typescript
+// 每次查询状态都重新从文件读取
+while (!timeout) {
+  for (all tasks) {
+    // 从结果工件文件读取状态
+    const artifact = readResultArtifact(jobId);
+    // 如果结果文件标记完成，更新任务状态
+    convergeJobWithResultArtifact(job, jobId);
+  }
+  // 检查是否全部terminal
+  if (allTasksTerminal()) break;
+  // 指数退避等待
+  await sleep(pollDelay);
+  pollDelay = min(pollDelay * 1.5, 2000);
+}
+```
+
+**没有用任何开源第三方调度库**，完全手写文件轮询，简单可靠。
+
+---
+
+## 四、通信共享信息实现
+
+### 1. Hermes Agent
+
+- **通信方式**：共享持久化内存 + 主Agent中转
+- 所有Agent都能读写共享记忆库
+- 支持全文搜索，跨会话回忆
+
+### 2. oh-my-codex / oh-my-claudecode
+
+**核心设计思想：文件系统就是共享总线**
+
+#### 目录结构
+
+```
+project-root/
+└── .omx/
+    └── state/
+        └── team/{team-name}/
+            ├── manifest.v2.json       # 团队信息
+            ├── mailbox/
+            │   ├── worker1.json     # 每个worker一个邮箱，存消息
+            │   └── worker2.json
+            ├── tasks/
+            │   ├── task-0.json      # 每个任务一个文件，包含状态/依赖/结果
+            │   └── task-1.json
+            └── events/
+                └── events.ndjson   # 事件日志，append-only
+```
+
+#### 通信机制
+
+- **发消息**：写到接收方mailbox JSON文件
+- **收消息**：从自己mailbox JSON文件读取
+- **任务输入输出**：每个任务从指定文件读输入，写完结果到指定文件
+- **总结**：**文件就是通信**，没有IPC，没有复杂机制，简单到不会丢消息
+
+#### 和三国Sanguo Mail对比
+
+| 点 | oh-my-claudecode | 三国Sanguo Mail |
+|----|-----------------|-----------------|
+| 状态存储 | `.omx/state/` JSON文件 | 项目git目录 + 各将军工作目录 |
+| 消息通信 | 文件mailbox | Sanguo Mail + 文件 |
+| 依赖检查 | 轮询文件状态 | 邮件通知 + 主军师调度 |
+| 并行 | tmux多CLI真并行 | 多Agent独立会话真并行 |
+| 优点 | 单机全自动 | 分布式跨机器，支持团队协作 |
+
+**核心思想一致**：都是**文件系统做共享总线**，状态存在文件，靠文件变化推进流程。
+
+---
+
+## 五、提示词设计总结
+
+### 1. Hermes Agent
+
+**设计思路**：自主技能进化，提示词随使用自动改进
+
+- **系统提示**：定义自主学习身份能力
+- **技能创建提示**：从对话提取新技能，生成格式完整的技能文档
+- **技能改进提示**：基于使用反馈优化提示词
+- **用户建模提示**：持续学习用户偏好
+- **记忆压缩提示**：压缩长期记忆，保留关键信息
+
+### 2. oh-my-codex / oh-my-claudecode
+
+**设计思路**：预置专家角色+阶段化提示词，开箱即用
+
+#### 核心预置命令/提示词
+
+| 命令 | 作用 |
+|------|------|
+| `/deep-interview` | 苏格拉底式提问澄清需求，揭示隐藏假设 |
+| `/team N:role "task"` | 启动Team阶段流水线 |
+| `/omc-teams N:model "task"` | 启动tmux多CLI混合模型 |
+| `/plan` | 只执行计划阶段，输出plan.md |
+| `/exec` | 只执行阶段 |
+
+#### 阶段分工提示词
+
+每个阶段独立提示词模板，**只干一件事**：
+
+| 阶段 | 职责 | 输出 |
+|------|------|------|
+| 深度访谈 | 澄清需求，确认验收标准 | `requirements.md` |
+| 团队计划 | 拆分任务，识别依赖 | `plan.md` + `tasks/` |
+| 团队执行 | 并行执行任务 | `results/` |
+| 团队验证 | 代码评审，质量检查 | `issues.md` |
+| 团队修复 | 根据问题修复 | 更新结果 |
+
+#### 混合模型提示词优化
+
+当使用多模型混合时，提示词会**强化模型优势**：
+
+- Codex：你擅长代码分析和审查，请重点关注架构和安全
+- Gemini：你擅长设计和文档，请产出清晰的设计方案
+- Claude：你擅长编码实现，请根据设计写出完整代码
+
+让每个模型干它擅长的，提示词配合模型能力定制优化。
+
+---
+
+## 六、对三国量化项目的借鉴
+
+### 1. 我们已有基础
+
+- ✅ Sanguo Mail 异步消息通信已经搞定
+- ✅ 各将军分工已经明确
+- ✅ Git + 文件系统共享已经在用
+- ✅ 多Agent跨机器并行已经支持
+
+### 2. 可以直接借鉴的点
+
+#### (1) 阶段流水线工作流模板
+
+针对代码输出型项目（sanguo_vnpy / sanguo_quant_live），可以照搬这个阶段化流水线：
+
+```
+需求澄清 → 方案计划 → 拆解任务 → 并行执行 → 验证评审 → 修复循环 → 汇总交付
+```
+
+每个阶段对应发邮件给相应将军：
+
+- 需求澄清 → 庞统/诸葛亮
+- 方案计划 → 庞统/诸葛亮
+- 执行 → 张飞/关羽/赵云 按分工
+- 验证 → 司马懿
+- 修复 → 返还给对应将军
+- 汇总 → 诸葛亮/庞统
+
+**这就是标准流程，新项目直接套用，不用每次重新商量怎么走**。
+
+#### (2) 状态文件约定
+
+可以在项目根目录约定：
+
+```
+<project-root>/
+└── .sanguo/
+    └── state/
+        └── team/{team-name}/
+            ├── config.json
+            ├── tasks/
+            ├── mailbox/
+            └── events/
+```
+
+和 oh-my-claudecode 一样，靠文件状态推进流程，不用改造Sanguo Mail。
+
+#### (3) 依赖处理简单化
+
+- 大部分项目用固定阶段流水线就够了，不用复杂DAG调度
+- 需要自定义依赖的任务，走**文件状态检查**：每个任务声明依赖，轮询检查依赖完成解锁
+- 我们有Sanguo Mail，依赖完成可以发邮件通知，比纯轮询更高效
+
+#### (4) 提示词模块化预置
+
+按角色/阶段预置提示词模板：
+
+```
+prompts/
+├── deep-interview.md    # 需求澄清
+├── team-plan.md         # 计划拆解
+├── team-exec.md         # 任务执行
+├── team-verify.md       # 验证评审
+└── team-fix.md          # 修复问题
+```
+
+每个将军接过任务，直接用对应模板，保证输出格式一致。
+
+#### (5) 支持混合模型（未来扩展）
+
+我们也可以支持"**不同将军用不同模型**"，提示词按模型优势定制：
+
+- 比如：赵云（数据）用某个模型，张飞（编码）用另一个模型，司马懿（评审）用第三个模型
+- 因为我们本来就是独立进程，天然支持混合模型，和 oh-my-claudecode 的 tmux 混合思路一致
+
+### 3. 总结落地方案
+
+| 层 | 已有 | 需要新增 |
+|-----|------|----------|
+| 通信层 | Sanguo Mail | - |
+| 状态层 | 文件系统 | 新增 `.sanguo/state/` 目录约定 |
+| 流程层 | - | 新增 阶段流水线脚本 + 预置提示词模板 |
+| 依赖层 | - | 新增简单依赖检查工具 |
+
+**工程量很小**，就是在现有Sanguo Mail上层加一层流程编排，不用改底层。
+
+---
+
+## 附录：源码关键文件位置（oh-my-claudecode）
+
+- 状态类型定义：`src/interop/omx-team-state.ts`
+- 任务收敛：`src/mcp/team-job-convergence.ts`
+- tmux进程管理：`src/team/tmux-session.ts`
+- MCP服务器：`src/mcp/team-server.ts`
+
+---
+
+**报告完**。