oh-my-opencode

核心用法

oh-my-opencode 是 OpenCode 平台的多智能体编排插件，提供两种核心工作模式：

Ultrawork 模式：在提示词中加入 ulw 或 ultrawork 关键词即可触发快速自主工作流。系统自动完成代码探索、最佳实践研究、功能实现、诊断验证的全流程，无需人工干预直至任务 100% 完成。

Prometheus 模式：按 Tab 键切换至规划模式，Prometheus Agent 通过访谈式提问澄清需求，生成结构化执行计划（存储于 .sisyphus/plans/*.md），随后通过 /start-work 命令交由 Atlas 编排器分发任务给专业子 Agent 并行执行，支持跨会话断点续传。

Agent 调用通过 delegate_task()() 函数或 --agent CLI 参数实现，支持 12 种专业 Agent：Sisyphus（主编排）、Hephaestus（深度自主工作）、Oracle（架构调试）、Librarian（文档检索）、Explore（代码搜索）、Multimodal Looker（图像分析）、Prometheus/Atlas（规划执行）、Metis/Momus（预规划/评审）等。任务可按类别（visual-engineering、ultrabrain、deep、quick 等）路由至优化模型，支持后台并行执行与 tmux 可视化集成。

显著优点

智能任务分解：将复杂项目自动拆解为可并行子任务，Atlas 编排器独立验证每个任务完成度，累积跨任务学习经验，显著提升大型项目交付质量。

模型路由优化：8 个预设类别自动匹配最优模型链（如 visual-engineering 优先 Gemini 3 Pro，ultrabrain 优先 GPT-5.2 Codex），避免手动调参，兼顾效果与成本。

后台并行执行：Explore、Librarian 等研究型 Agent 支持 run_in_background=true 非阻塞启动，配合 tmux 分屏可视化，实现真正的多 Agent 协作开发体验。

会话连续性：通过 session_id 机制保留完整上下文，后续调用可节省 70%+ Token 消耗，支持跨天项目断点续传。

生态集成完善：内置 Exa 搜索、Context7 文档、Grep.app 代码示例三大 MCP，提供 Playwright 浏览器自动化、Git 专家、前端 UI/UX 等可注入技能模块。

潜在缺点与局限性

模型依赖门槛高：Sisyphus 强烈推荐 Claude Opus 4.5，Hephaestus 强制要求 GPT-5.2 Codex，若未配置对应订阅，体验显著降级。国内用户访问 Anthropic/OpenAI 存在网络门槛。

配置复杂度：类别默认模型不会自动生效，必须手动添加至 oh-my-opencode.json 配置，否则回退至系统默认模型，新手易踩坑。

Prometheus-Atlas 强耦合：Atlas 编排器必须配合 Prometheus 计划使用，单独调用会导致执行失败，学习成本较高。

T3 来源风险：项目为个人开发者维护（code-yeongyu），非官方组织背书，长期维护稳定性存疑，需自行关注上游安全更新。

资源消耗：多 Agent 并行 + 后台任务 + tmux 多窗格对本地计算资源和终端环境有较高要求，低配设备可能出现性能瓶颈。

适合的目标群体

• 全栈开发者：需要同时处理前后端、架构设计、文档编写的复杂项目
• AI 辅助编程重度用户：已订阅 Claude Pro/Max 或 OpenAI 高级套餐，追求极致自动化效率
• 技术团队 Lead：需要标准化团队 AI 工作流，通过类别路由统一模型选型策略
• 开源项目维护者：利用 Librarian + Explore 并行检索官方文档与代码库实践，快速上手陌生技术栈
• tmux/终端极客：追求可视化多 Agent 协作的沉浸式开发体验

使用风险

依赖项风险：强制依赖 OpenCode CLI 1.0.150+ 及多 LLM 提供商认证，任一环节配置失败将导致功能不可用。bunx 执行环境需预先安装 Bun 运行时。

成本失控风险：后台并行 Agent + Opus 4.5 等高端模型组合可能产生意外高额 API 费用，建议配置 providerConcurrency 和 modelConcurrency 限制并发数。

上下文溢出风险：长会话多 Agent 协作易触发上下文窗口限制，虽内置 context-window-monitor 和 preemptive-compaction 钩子，极端场景仍可能丢失关键信息。

计划执行偏差：Prometheus 生成的计划依赖 Atlas 严格执行，若中途手动干预或网络中断，可能导致任务状态不一致，需熟悉 /stop-continuation 等应急命令。