oh-my-openagent (OmO) 调研报告
OpenCode 生态中最复杂的框架级插件——11 个专精 Agent、54+ 生命周期钩子、多模型编排，把单 Agent 变成整支开发团队。
项目概览
oh-my-openagent（简称 OmO）是由 code-yeongyu 开发的开源项目，是 OpenCode 生态中最为复杂和功能丰富的第三方插件。它本质上是一个"框架级"插件——在 OpenCode 的 Plugin 系统之上构建了完整的多 Agent 编排系统，包括 11 个角色化 Agent、15+ 自定义工具、54+ 生命周期钩子、20 个功能模块、3 个内嵌 MCP 服务。
架构设计
OmO 采用四层架构设计：
- Plugin 接口层——将内部能力"翻译"为 OpenCode Plugin 接口（chat.params、chat.message、event、tool.execute.before/after）
- 能力层——agents/、tools/、hooks/、features/、mcp/，是 OmO 的核心
- 基础设施层——shared/、config/、plugin-state.ts，提供跨模块共享工具、配置加载、全局状态
- 运行时层——OpenCode 的 Plugin 加载器，提供 @opencode-ai/plugin 类型契约
MCP 三阶架构
OmO 的 MCP 系统分为三个层级：
| 层级 | 来源 | 示例 |
|---|---|---|
| 1 — 内建 MCP | OmO 运行时注入 | websearch (Exa)、context7、grep_app |
| 2 — .mcp.json | 从项目配置文件加载 | 用户自定义 MCP 服务 |
| 3 — Skill MCP | SKILL.md frontmatter 声明 | 按需启动，session 级作用域 |
Agent 编排系统
OmO 最核心的创新是 Agent 编排。它将单一 AI Agent 扩展为一整支协作团队，通过三层架构解决上下文超载、认知漂移和验证不足的问题。
规划层（人 + Prometheus）
Prometheus（规划师）通过访谈式对话理解需求，生成结构化计划。Metis（顾问）提供架构建议，Momus（评审员）审核计划质量。三者形成"构思→咨询→审查"的规划闭环。
执行层（Atlas）
Atlas 是执行指挥——读取计划、拆解任务、按类别分配给最合适的 Worker Agent，汇总结果、跟踪进度。
工人层
| Agent | 职责 | 推荐模型 |
|---|---|---|
| Sisyphus-Junior | 通用任务执行 | Claude Sonnet 4.6 |
| Oracle | 架构咨询 | GPT-5.4 / Claude Opus 4.6 |
| Explore | 代码库搜索 | Grok Code（快速） |
| Librarian | 文档/开源搜索 | Gemini 3 Flash |
| Frontend | 前端/UI 开发 | Gemini 3.1 Pro |
分类路由
Agent 不直接指定模型，而是通过 Category 路由：visual-engineering → Gemini、ultrabrain → GPT-5.5 xhigh、artistry → Gemini 3.1 Pro、quick → 最便宜的模型。开发者只需配置一次，任务自动匹配最优模型。
核心功能
- 11 个专精 Agent——规划、执行、搜索、前端、架构，各司其职
- 54+ 生命周期钩子——颗粒度极高的行为控制
- IntentGate——意图分类系统，自动判断研究/实现/修复，路由到正确流程
- LSP + AST 工具——工作区级重命名、跳转定义、查找引用、预构建诊断
- Skill 系统——每个 Skill 自带 MCP 服务，任务级作用域，不污染全局
- Team Mode——1 个 Lead + 最多 8 个并行成员，实时 tmux 可视化
- OpenClaw——双向集成 Discord、Telegram、HTTP、Shell，带回复监听守护进程
- Rules Injection——AGENTS.md / .omo/rules 自动注入 Agent 上下文
- Claude Code 兼容——hooks、commands、MCPs、plugins 全部可复用
安装与配置
BASH# Ultimate 版（OpenCode）
bunx oh-my-openagent install
# Light 版（Codex CLI）
npx lazycodex-ai install
# 同时安装两个平台
bunx oh-my-openagent install --platform=both安装过程交互式引导，自动注册 Plugin、配置 Agent 和 Provider。也可通过 oh-my-openagent.json 精细控制。
JSONC{
"sisyphus_agent": {
"disabled": false,
"planner_enabled": true
},
"disabled_hooks": [],
"agents": {
"oracle": { "model": "openai/gpt-5.5", "variant": "high" }
},
"categories": {
"visual-engineering": { "model": "google/gemini-3.1-pro", "variant": "high" },
"ultrabrain": { "model": "openai/gpt-5.5", "variant": "xhigh" }
}
}竞品对比
| 维度 | OmO (Ultimate) | Claude Code | 原生 OpenCode |
|---|---|---|---|
| 多 Agent 编排 | ✅ 11 个专精 Agent | ❌ 单 Agent | ❌ 单 Agent |
| 多模型路由 | ✅ Category → 模型自动映射 | ❌ 单一模型 | ❌ 单一模型 |
| Skill 系统 | ✅ 带 MCP 的领域技能 | ❌ | ✅ 基础 Skill |
| LSP 集成 | ✅ 完整 IDE 级 | ❌ | ✅ 基础 LSP |
| 团队模式 | ✅ 8 并行成员 | ❌ | ❌ |
| 学习曲线 | 陡峭 | 简单 | 中等 |
优缺点分析
优势
- 编排能力极强——多 Agent 协作、多模型混用，远比单 Agent 能做复杂的事
- 生态兼容——兼容 Claude Code 的配置文件，降低迁移成本
- 插件化 Skill——每个 Skill 自包含 MCP 和配置，可共享可复用
- 活跃的社区——文档详尽、更新频繁、有专门的 OpenCode-Book 章节
不足
- 复杂度爆炸——数万行代码、11 个 Agent、54 个钩子，理解和调试难度高
- API 成本高——多模型并行调用，Token 消耗远超单 Agent 方案
- 依赖 OpenCode 版本——Plugin API 变动可能导致兼容性问题
- 过度设计风险——对于简单任务，OmO 的编排开销可能得不偿失
总结
oh-my-openagent 是 OpenCode 生态中理念最激进、功能最完整的插件。它不满足于"增强"OpenCode，而是试图在 OpenCode 之上构建一个完整的 AI 开发团队操作系统。对于需要处理复杂多步骤开发任务、有预算使用多模型、愿意投入学习成本的团队，OmO 提供了当前最强大的 Agent 编排能力。
但如果你只是需要一个简单的 AI 编程助手，OmO 可能过于沉重。它更适合"想要让 AI 团队替我写代码"而非"让 AI 帮我写代码"的用户。