oh-my-opencode

🏔️ 多智能体编排的自主开发引擎

基于 OpenCode 的多智能体编排插件,通过 Sisyphus、Prometheus、Atlas 等 12+ 专业 Agent 实现任务自动分解与并行执行,将单一 AI 会话升级为自主协作式开发工作流。

收藏
17.6k
安装
3.8k
版本
v1.0.0
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

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

Ultrawork 模式:在提示词中加入 ulwultrawork 关键词即可触发快速自主工作流。系统自动完成代码探索、最佳实践研究、功能实现、诊断验证的全流程,无需人工干预直至任务 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 费用,建议配置 providerConcurrencymodelConcurrency 限制并发数。

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

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

安全解读

核心功能

oh-my-opencode 将 OpenCode 升级为完整的多智能体开发平台,提供两种主要工作流:

  • Ultrawork 模式:在提示词中包含 ulw 关键词即可触发全自主工作流,智能体会自动探索代码库、研究最佳实践、实现功能并完成验证,直至 100% 完成。
  • Prometheus 模式:按 Tab 键切换到规划模式,通过访谈式问答生成详细执行计划,再由 Atlas 编排器通过 /start-work 命令分发任务给子智能体并跟踪进度。

智能体体系

包含 11 个专业智能体:Sisyphus(主编排器)、Hephaestus(深度自主工作)、Oracle(架构/调试)、Librarian(文档检索)、Explore(代码搜索)、Multimodal Looker(图像分析)、Prometheus(规划)、Metis(预规划咨询)、Momus(计划审查)、Atlas(计划执行编排)。每个智能体都有优化的模型选择和供应商回退链。

关键特性

  • 分类任务路由:8 个预设类别(visual-engineering、ultrabrain、deep、artistry、quick 等),自动匹配最优模型
  • 背景并行执行:支持 run_in_background=true 非阻塞启动多个智能体,配合 tmux 可视化多窗格执行
  • 会话连续性:通过 session_id 保持跨轮次上下文,节省 70%+ Token
  • 内置 MCP:集成 Exa 搜索、Context7 文档查询、Grep.app GitHub 代码搜索

显著优点

  • 大幅降低复杂任务的认知负担,用户只需描述目标
  • 智能体专业化分工提升输出质量,避免单一模型能力瓶颈
  • 背景并行机制显著提升研究效率(探索代码库 + 检索文档同时进行)
  • 会话恢复和自动续作机制保障长周期任务不中断

潜在局限

  • 模型依赖重:Sisyphus 强烈推荐 Claude Opus 4.5,使用其他模型体验显著下降
  • 配置门槛:类别优化模型需要手动配置,否则回退到系统默认可能非最优
  • 供应商成本:多智能体并行可能产生较高 API 费用
  • 学习曲线:Prometheus/Atlas 配对规则、背景任务管理等概念需要理解

适合人群

  • 需要处理复杂多文件重构、架构设计的资深开发者
  • 希望自动化研究-实现-验证完整流程的技术团队
  • 使用 OpenCode 作为主力 IDE 且追求效率最大化的用户

常规风险

  • Atlas 必须与 Prometheus 计划配对使用,单独使用可能导致任务失败
  • 背景任务需及时取消或收集结果,避免资源浪费
  • 非交互环境需配置 stream: false 避免 JSON 解析错误

oh-my-opencode 内容

references文件夹
scripts文件夹
手动下载zip · 19.5 kB
configuration.mdtext/markdown
请选择文件