Oh My OpenAgent | OpenCode 多 Agent 编排 · 模型组合与速查

Oh My OpenAgent（npm 包名仍为 oh-my-opencode）把 OpenCode 从「单模型写代码」升级为「多 Agent 协作团队」：11 个具名 Agent 负责编排、深度执行、规划、搜索与审查；8 个 Category 在委派时自动匹配模型与思维设定。插件价值不在「换一个更强的模型」，而在 按任务类型路由到对的模型家族——编排用 Claude 系（或 Kimi/GLM 平替）、自主攻坚用 GPT 系、前端用 Gemini 系、检索用廉价 Mini/Flash。配置写在 ~/.config/opencode/oh-my-openagent.json；输入 ultrawork（或 ulw）即可激活整套流程。

官网 / 仓库：github.com/code-yeongyu/oh-my-openagent

配置文件

用户级：~/.config/opencode/oh-my-openagent.json（兼容旧名 oh-my-opencode.json）。项目级可在 .opencode/ 下放置同名文件，就近优先。

{
  "agents": { "sisyphus": { "model": "..." }, ... },
  "categories": { "ultrabrain": { "model": "..." }, ... }
}

agents：覆盖具名 Agent 的模型与 variant（如 max、xhigh）
categories：覆盖委派任务时的 Category 模型

Agent 与 Category 速查

11 个 Agent

Agent	角色	典型用途
sisyphus	默认主编排	拆任务、并行委派、驱动 todo 直到完成
hephaestus	自主深度执行	给目标不给步骤，端到端攻关
prometheus	战略规划	`/start-work` 前产出 `.sisyphus/plans/`
atlas	Todo 编排执行	按 Prometheus 计划逐项执行
oracle	架构顾问（只读）	设计评审、复杂调试
librarian	文档 / OSS 检索（只读）	官方文档、GitHub、Web 搜索
explore	代码库搜索（只读）	快速 grep、结构探索
multimodal-looker	多模态分析	PDF、图片、图表提取
metis	规划前顾问	识别歧义与 AI 翻车点
momus	计划审查	审查计划的清晰度与可验证性
sisyphus-junior	Category 执行器	委派 `category=...` 时自动 spawn

Tab 切换（核心）：Sisyphus → Hephaestus → Prometheus → Atlas。

8 个 Category

通过 delegate_task(category="...", ...) 选用，spawn Sisyphus-Junior-{category}：

Category	适用场景
visual-engineering	前端、UI/UX、样式、动画
ultrabrain	深度逻辑、复杂架构决策
deep	自主深度攻关（单目标单交付）
artistry	高创意 / 艺术向任务
quick	单文件小改、trivial 修改
unspecified-low	未分类、中等工作量
unspecified-high	未分类、高工作量 / 跨模块
writing	文档、README、技术写作

模型分工：三个家族，不要混用

官方 Agent-Model Matching Guide 的核心观点是：每个 Agent 的 prompt 是为特定模型性格调过的，换模型等于换大脑，同一指令会被理解成完全不同的行为。

模型家族	适合什么「脑子」	负责的 Agent / Category
Claude 系（Opus/Sonnet/Kimi/GLM）	长指令、多轮工具、编排沟通	Sisyphus、Atlas、Prometheus、Metis
GPT 系（GPT-5.5 / 5.4）	原则驱动、长时间自主攻坚	Hephaestus（必须）、Oracle、Momus、`deep` / `ultrabrain`
Gemini 系（3.1 Pro / Flash）	视觉、UI、文档	`visual-engineering`、`artistry`、`writing`
廉价 Mini/Flash	快、省 token	Explore、Librarian、`quick`

硬性约束：Hephaestus 没有 Claude 系 fallback，必须能访问 GPT 家族；单一 Anthropic 订阅无法激活自主深度执行。单一 OpenAI 订阅则 Sisyphus 编排体验会明显降级（虽有 GPT prompt path，仍非首选）。

三套推荐组合

A. 能力最坚固（预算不敏感）

适合关键项目、大仓库、合并前最后一道关。

槽位	推荐模型	variant
Sisyphus / unspecified-high	Claude Opus 4.8 或 4.7	`max`
Hephaestus / deep	GPT-5.5	`medium`
Oracle / ultrabrain	GPT-5.5	`high` / `xhigh`
Momus	GPT-5.5	`xhigh`
visual-engineering	Gemini 3.1 Pro	`high`
Explore / Librarian / quick	GPT-5.4 Mini Fast 或 Claude Haiku	—

B. 官方性价比甜蜜点（约 $30/月）

官方推荐：OpenCode Go（$10）+ ChatGPT Plus（$20+）。

订阅	覆盖
OpenCode Go	Kimi K2.6、GLM-5、Qwen、MiniMax——编排与检索
ChatGPT Plus/Pro	GPT-5.5——Hephaestus、Oracle、deep 必需

编排（Sisyphus / Atlas / Prometheus）→ opencode-go/kimi-k2.6
深度（Hephaestus / Oracle / ultrabrain）→ openai/gpt-5.5
前端（无 Google 时）→ opencode-go/qwen3.6-plus
检索 → opencode-go/qwen3.5-plus 或 gpt-5.4-mini

若已有 Claude Max：安装时加 --claude=max20，Sisyphus 默认 Opus，Go 仍作 fallback——能力上限最高且有余量。

C. 纯 OpenRouter 按量付费

不想多订订阅、按 token 计费时，按官方 substitution 规则映射：

槽位	OpenRouter 模型
日常编排	`moonshotai/kimi-k2.6`
ultrawork / 高难度	`anthropic/claude-opus-4-7`（`max`）
Hephaestus / Oracle / deep	`openai/gpt-5.5`
前端	`google/gemini-3.1-pro-preview`
Explore / Librarian	`deepseek/deepseek-v4-flash`

OpenRouter 接入：opencode auth login 选择 OpenRouter，Agent 模型 ID 加 openrouter/ 前缀。配置后执行 opencode models --refresh 与 bunx oh-my-opencode doctor 核对实际解析结果。

GPT 不可用时的平替顺序：GPT-5.3 Codex → DeepSeek v3.2。不要用 MiniMax 顶替 Hephaestus / Oracle（官方明确不推荐）。

常见避坑

做法	后果
全程 Opus	Explore/Librarian 等检索 Agent 成本爆炸，体验未必更好
Sisyphus 用旧版 / 弱 GPT	prompt 为 Claude 设计，编排质量明显下降
Hephaestus 换成 Kimi / GLM / MiniMax	该 Agent 为 GPT 原则驱动，换脑后深度自治能力大幅缩水
Explore / Librarian 升级到 Opus	用旗舰模型做 grep——官方原话是「请高级工程师去归档」
前端任务用 Kimi / GLM	推理风格不对，应使用 Gemini 或 Qwen
只用 Anthropic 订阅	Hephaestus 无法激活，失去 autonomous deep work

验证与诊断

opencode auth login          # 连接各 Provider 或 OpenRouter
opencode models --refresh    # 刷新本地模型列表
bunx oh-my-opencode doctor   # 查看每个 Agent/Category 实际使用的模型

适用场景

已在用 OpenCode，需要开箱即用的多模型 Agent 团队
希望 Category 自动选模型，而非每个子任务手动挑模型
愿意在 json 里做 成本分流（旗舰编排 + 廉价检索 + GPT 深度）
需要 Claude Code 兼容（hooks、commands、skills、MCP）

不太适合

只用 Codex CLI 且不需要 OpenCode 完整编排（可选 Light Edition：npx lazycodex-ai install）
期望零配置、单一模型搞定一切
不需要子 Agent / 规划流程，只要简单问答

下一步

安装：bunx oh-my-openagent install（勿用 bunx omo，会解析到无关 npm 包）
模型匹配详解：Agent-Model Matching Guide
文档：omo.vibetip.help/docs