多智能体协同引擎 — Leader 拆解 WBS → Worker 并行执行 → 结果聚合。

多智能体编排引擎，支持 WBS 协同、并行 Worker、Skill/MCP 分发、Lessons 自学习。

📖 操作手册 · ROADMAP.md · CHANGELOG.md

如果这个项目对你有帮助，欢迎 star 关注。参与前请阅读 CONTRIBUTING.md，安全问题请走 SECURITY.md，路线图见 ROADMAP.md，版本变化见 CHANGELOG.md。

curl -fsSL https://raw.githubusercontent.com/lpc0387/hermes-collab-engine/main/scripts/install.sh | bash

安装后：

opc                  # 交互式配置并启动
hermes-collab run "分析项目结构" --cwd .   # 直接运行任务
hermes-collab server --host 0.0.0.0 --port 8765  # 启动 Web 面板

pip install -e .
hermes-collab run "分析 src/ 结构" --cwd . --json
hermes-collab server --host 0.0.0.0 --port 8765 --cwd .

v6.0 — Leader=Hermes, Worker=OpenCode 双 Agent 架构

• Leader=Hermes：WBS 分解、aggregate 汇总均使用 Hermes Agent
• Worker=OpenCode：执行阶段使用 OpenCode，轻量高效
• Planner 重构：WBS 分解由 Hermes 完成，不再依赖 claude-code
• prompt_flag 修正：Hermes CLI 参数格式 -z，解决 invalid choice 错误

• 每日 lessons 自动归档到 data/memory/
• 回填前一天缺失的总结
• 无 Hermes 路径依赖，可拔插式记忆
• engine-memory skill：Hermes 端加载引擎 lessons

• MCP 页面改为只读展示，支持描述字段和实时健康检查
• 注册/编辑/删除 MCP 服务器（持久化到 mcp-config.json）
• 传输类型选择：stdio / gitmcp / SSE
• 测试通信按钮：真实 MCP 协议 tools/list 握手

• Leader 注意力轮询：每 15s 读取 worker stdout，Leader 实时判断方向
• 方向正确 → continue（不干预）；方向偏离 → off_track（打断重派）
• [GUARDIAN:NEED_INPUT] 标记 → 暂停 worker，等待用户确认（如扫码登录）
• 30s 无输出 → 自动触发 Leader 审核
• 重复错误检测 → 自动触发 Leader 审核
• 每次注意力 ~280 tokens，一个 1 分钟任务约 4 次 = ~1,120 tokens
• 防跑偏场景：可节省 90%+ 失败重跑成本

• scope（L1/L2/L3）+ tags
• _learn() 增强：ARG_MAX、超时、慢 worker 检测
• GET /api/lessons + GET /api/distill/daily/{date}

• Skill、Tool、MCP 统一管理，能力标签索引
• Web UI 注册 → 自动持久化，重启不丢失
• Leader 自动感知可用 skill/tool 并在 WBS 阶段预分配

• Skill/Tool/MCP 集中管理：Planner 根据节点 capability 自动匹配最优 skill 和工具
• 搜索路由：搜索/调查类请求 → analysis 节点 → search-verify skill
• 设计路由：UI/设计类请求 → design → frontend-optimization skill
• MCP 工具注入：节点能力自动匹配 MCP 服务器
• 预算管理：剩余预算 < 30s 自动跳过节点
• subprocess 防挂死：temp 文件替代 PIPE 捕获 stdout/stderr
• 运行状态修复：去掉 planning 卡死状态

• search-verify skill：多源搜索 → 交叉验证 → 结构化摘要
• frontend-optimization skill：daisyUI/Tailwind/unocss 设计规范
• ui-design-v2 skill：shadcn/ui v4 高级审美（Linear/Stripe/Vercel 风格）

• 分片策略重写：基于任务估算量 + 系统负载 + WBS 最小颗粒度四级决策
• 负载感知 dispatch：CPU > 85% 或 MEM > 90% 时暂停派发新 worker
• ARG_MAX 防护：prompt 拼装后 900KB 硬截断

• 内置 Agent（claude-code、hermes、codex、opencode）
• Web UI 注册自定义 Agent，严格验证（name/command/capabilities）

• 通过"接入上次会话"形成连续对话链
• 按 resume 链分组展示多个 run 的状态与进度

• 引擎自动记录运行经验并去重提炼
• 只读节点风险检测修复
• checkpoint 状态原子持久化

sandbox              # 默认 2 小时，端口 8876
sandbox 4            # 运行 4 小时
sandbox --port 8877  # 自定义端口

用户 → Leader (WBS 拆解 + 实时守护) → Worker × N (并行执行) → 聚合 → 结果
                              │
                         Agent Backend
                    (Hermes Leader / OpenCode Worker)
                              │
                        MCP 工具池
                   (搜索/浏览器/UI 组件)
                              │
                       Guardian 守护线程
                   (Leader 注意力轮询 / NEED_INPUT
                    超时检测 / 错误循环检测)

hermes-collab run "<task>" --cwd .          # 运行任务
hermes-collab run --request-file task.md    # 文件提交
hermes-collab server                        # 启动面板
hermes-collab lessons                       # 查看经验
hermes-collab skills                        # 查看技能
hermes-collab tools                         # 查看工具
hermes-collab agents                        # 查看 Agent
hermes-collab kill/split/skip/redo <run> <node>  # 运行中干预

完整 CLI 参考见 docs/manual/cli.md

完整 API 文档见 docs/manual/api.md

WeChat: lg19961117

可选赞助支持维护

License: MIT · 多智能体 · AI编排 · WBS · Agentic AI

GitHub Topics 推荐: multi-agent, claude-code, ai-orchestration, wbs, llm, agentic-ai