Oh My OpenCode

核心用法

Oh My OpenCode 是 OpenCode 的高级多智能体编排插件，通过 bunx oh-my-opencode install 一键安装，将 OpenCode 升级为完整的智能体调度系统。

两种工作模式

Ultrawork 模式：在提示词中包含 ulw 或 ultrawork 关键词即可触发快速自主工作流，Sisyphus 代理自动探索代码库、研究最佳实践、实现功能并完成验证。

Prometheus 模式：按 Tab 键切换至规划模式，Prometheus 代理通过访谈式对话生成详细执行计划，随后使用 /start-work 命令由 Atlas 编排器分配子代理并行执行。

智能体体系

包含 12+ 专业代理：Sisyphus（主编排器）、Oracle（架构/调试）、Librarian（文档搜索）、Explore（代码库检索）、Prometheus（规划）、Atlas（计划执行）、Hephaestus（深度自主工作）等。通过 delegate_task() 或 --agent 标志调用，支持后台并行执行（run_in_background=true）。

分类模型路由

8 个任务分类自动匹配最优模型：

• visual-engineering → Gemini 3 Pro（前端/UI）
• ultrabrain → GPT-5.2 Codex（复杂架构）
• deep → GPT-5.2 Codex（自主问题求解）
• quick → Claude Haiku（快速修复）

高级特性

• Tmux 集成：可视化多代理并行执行
• Session 连续性：复用 session_id 节省 70%+ Token
• 内置 MCP：Exa 搜索、Context7 文档、Grep.app 代码示例
• 20+ 自动 Hook：任务续力、上下文窗口监控、会话恢复等

显著优点

1. 生产级多代理架构：代理分工明确，避免单模型上下文爆炸
2. 智能模型 fallback：每个代理配置多供应商优先级链，确保可用性
3. 真正并行执行：背景代理非阻塞运行，支持多路探索+研究同步进行
4. 计划驱动复杂任务：Prometheus+Atlas 组合确保大型项目可控交付
5. 成本优化：分类路由自动选择性价比最优模型组合

潜在局限

1. 供应商依赖较重：Sisyphus 强烈推荐 Claude Opus 4.5，体验降级明显
2. 配置复杂度：类别模型需手动配置才能生效，默认可能回退至次优模型
3. 学习曲线陡峭：12+ 代理、8 个分类、20+ Hook 需时间掌握最佳实践
4. 实验性项目：GitHub 星标较少（<500），长期维护存不确定性
5. Bun 生态绑定：官方推荐 bunx，npm/npx 支持为次级

适合人群

• 需要处理复杂多文件重构项目的资深开发者
• 追求 AI 开发工作流自动化的团队技术负责人
• 已订阅 Claude Pro/Max 且希望最大化利用多代理架构的用户
• 熟悉 tmux、愿意配置优化开发环境的效率极客

常规风险

| 风险类型 | 说明 |

|---------|------|

| API 成本失控 | 多代理并行+背景任务可能导致 Token 消耗激增，建议配置并发限制 |

| 模型可用性 | 依赖 Anthropic/Claude 深度功能，供应商策略变更影响大 |

| 配置漂移 | 类别模型未正确配置时自动降级，可能无感知使用次优模型 |

| 过度委托 | 复杂任务拆分解耦不当可能导致代理间上下文丢失 |

| 项目成熟度 | 开源时间较短，生产环境稳定性待大规模验证 |

概述

Oh My OpenCode 是一个专为 OpenCode 设计的多智能体编排插件，其核心目标是将单个 AI 编程助手转变为多角色、协同工作的智能开发团队。它通过引入 Sisyphus（主要编排器）、Oracle（架构/推理）、Prometheus（规划）和 Atlas（执行）等超过 12 个专职智能体，结合超自动化的 Ultrawork 模式与结构化的 Prometheus 规划模式，为用户提供了从简单功能开发到大型复杂项目管理的完整解决方案。

核心用法

该技能的核心在于两条工作流的选择：对于快速、高度自洽的编码任务，用户只需在提示词中加入 ulw 关键词即可启动 Ultrawork 模式，智能体将自动探索代码库、研究最佳实践、实施功能并进行验证，持续工作直至完成。而对于复杂的、关键性的或多日项目，用户可按下 Tab 键切换到 Prometheus（规划者）模式，经过交互式访谈生成详细计划，确认后再通过 /start-work 命令由 Atlas 编排器分配给专门的子智能体执行，并支持跨会话追踪进度。基本的安装通过 bunx oh-my-opencode install 交互式命令完成，配置后即可在 OpenCode 中无缝调用。

显著优点

• 多角色专业化分工：通过 "群策群力" 的代理模式，将架构、研究、前端、测试等任务分派给最擅长的智能体和模型，解决了单个模型在复杂任务中顾此失彼的问题。
• 高度自动化与持续性：内置的 todo-continuation-enforcer、Ralph Loop 和 Ultrawork Loop 等机制，强制智能体克服半途而废的本能，推动工作直至 100% 完成，显著减少了人工催促和确认。
• 灵活的任务分发与资源优化：细粒度的类别路由（Categories）功能可以为不同任务类型（如快速修复、视觉工程、深度推理）分配成本与性能最优的模型组合，同时支持后台并行执行探索和研究任务，极大提升了大型项目的整体效率。

潜在缺点或局限性

• 高要求的环境依赖：Sisyphus 智能体强烈推荐使用 Anthropic Claude Opus 4.5 模型，这是一个高成本选项。如果用户未配置或订阅相关 Pro/Max 计划，主智能体的体验和编排能力会显著下降。
• 陡峭的学习曲线：该插件拥有复杂的智能体角色、工作流模式、类别路由和众多自定义钩子（Hooks），新用户需要投入相当的时间阅读文档才能避免配置错误，例如错误地单独使用 Atlas 或误解类别模型的解析优先级。
• T3 来源的维护风险：Skill 来自个人开发者 (code-yeongyu)，属于社区驱动项目。其长期维护、Bug 修复和对上游 OpenCode API 变更的及时适应，不如 T1/T2 级官方或大型机构维护的项目有保证。

适合的目标群体

此技能最适合那些已经深度使用 OpenCode 并希望突破其单兵作战能力上限的专业开发者和技术团队。对于需要频繁处理中到大型全栈项目、有复杂架构迭代需求，且已配备强大 LLM API 密钥（尤其是 Anthropic Claude Opus）的用户来说，Oh My OpenCode 可以成为一个真正的开发加速器。它同样适合对 AI 智能体协作模式感兴趣，并愿意花时间优化配置以换取极致开发自动化的技术探索者。

使用风险

• 常规配置风险：如果未按照文档正确配置 oh-my-opencode.json 中的各类别模型，智能体可能会回退到系统默认模型，导致性能不佳或任务失败（例如用低性能模型处理复杂架构任务）。
• 成本失控风险：后台并行任务和 Ultrawork 模式若不加节制使用，可能在无人值守时产生大量 API 调用，用户需注意监控 opencode stats 并合理配置并发数。
• 供应链安全风险：文档中引用和推荐的 curl | bash 安装方式（如 OpenCode 与 Bun 的安装），缺乏完整性校验，这虽是业界常见做法，但对于安全意识较高的用户，建议改用 npm/bun 等包管理器进行安装。
• 依赖单一仓库风险：插件的安装、更新和 JSON Schema 验证高度依赖 github.com/code-yeongyu/oh-my-opencode 仓库的可用性，一旦仓库失效或被恶意篡改（即便是暂时），将对所有依赖者造成直接影响。