Oh My OpenAgent (OMO) 介绍与使用指南

一、核心定位

Oh My OpenAgent 是一个 多模型智能体编排框架，专为 OpenCode 设计的插件，将单一 AI 代理转变为一个协调的虚拟开发团队。

二、核心架构

复制代码

用户请求
    ↓
[Intent Gate] --- 意图分类
    ↓
[Sisyphus] --- 主编排器，规划和委派任务
    ↓
├─→ [Prometheus] --- 战略规划（访谈模式）
├─→ [Atlas] --- 任务编排和执行
├─→ [Oracle] --- 架构咨询
├─→ [Librarian] --- 文档/代码搜索
├─→ [Explore] --- 快速代码库扫描
└─→ [Category-based agents] --- 按任务类型专业化分工

三、关键特性

特性	说明
多模型路由	根据任务复杂度自动选择最优模型（Claude Opus、GPT-5.4、Kimi、Gemini 等）
哈希锚定编辑	编辑成功率提升 10 倍（从 ~6.7% 提升到 68.3%）
并行执行	多个 Agent 同时工作，大型项目效率极高
Ultrawork 模式	一键激活：`ultrawork` 或 `ulw` 命令
40+ 生命周期钩子	支持任务前后操作、安全检查等扩展
内置 MCP 服务	网页搜索、官方文档、GitHub 代码搜索

四、核心智能体团队

智能体	职责	推荐模型
Sisyphus	主编排器，规划、委派、执行	Claude Opus 4.6 / Kimi K2.5
Hephaestus	深度工作者，端到端自主执行	GPT-5.4
Prometheus	战略规划师，访谈式需求澄清	Claude Opus 4.7 / Kimi K2.5
Oracle	架构/调试专家	-
Librarian	文档/代码搜索专家	-
Explore	快速代码库扫描	-

五、常用命令

基础命令

bash 复制代码

# 懒人模式 - 一键自动完成
ultrawork 实现用户认证功能
# 或使用简写
ulw 创建一个React组件

# 最大火力模式 - 不完成不停止
/ulw-loop "实现支付模块"

# 不完成不停止模式
/ralph-loop "修复登录bug"

# 生成代码知识图谱
/init-deep

# 安全重构
/refactor <模块> --scope=file

# 执行计划
/start-work

显式调用智能体

bash 复制代码

# 问架构顾问
问 @oracle 这个微服务架构设计合不合理？

# 查询文档
问 @librarian React Query 的最佳实践

# 搜索代码库
问 @explore 找一下用户认证相关的代码

# 查询官方文档
@librarian 查询 expressjs.com 的中间件文档

# 在GitHub搜索
@grep_app 在 GitHub 搜索 JWT 刷新令牌的 TypeScript 实现

六、实战场景示例

场景1：新项目开发

bash 复制代码

# 1. 创建项目目录
mkdir my-new-project
cd my-new-project

# 2. 启动OpenCode
opencode

# 3. 生成项目上下文
/init-deep

# 4. 开始开发
ultrawork 创建一个待办事项应用，使用React + TypeScript

场景2：代码重构

bash 复制代码

# 方式1：直接重构
/refactor src/utils/ --scope=file

# 方式2：委托给智能体
delegate_task(agent="oracle", prompt="帮我分析这个设计")

场景3：完整功能开发

bash 复制代码

ultrawork 实现用户认证功能，包含：
   - 注册（用户名/邮箱/密码）
   - 登录（邮箱+密码）
   - JWT令牌验证
   - 密码重置

七、配置文件示例

用户级配置（~/.config/opencode/oh-my-openagent.json）

json 复制代码

{
  "orchestrator": "sisyphus",
  "models": {
    "primary": "claude-opus-4.6",
    "secondary": "gpt-5.4",
    "quick": "gemini-flash"
  },
  "parallelWorkers": 5,
  "autoReview": true,
  "hashAnchoredEdits": true
}

项目级配置（.opencode/oh-my-opencode.json）

json 复制代码

{
  "allowedModels": ["claude-opus-4.6", "kimi-k2.5"],
  "maxWorkers": 3,
  "skipFiles": ["node_modules/", "dist/"],
  "requiredSkills": ["code-reviewer", "test-driven-development"]
}

八、目录结构

复制代码

~/.config/opencode/
├── opencode.json                    # OpenCode 主配置
├── oh-my-openagent.json             # OhMyOpenCode 代理编排配置
└── oh-my-openagent.json.migrations.json

~/.local/share/opencode/
├── auth.json                        # API 密钥存储
├── opencode.db                      # 会话数据库
├── log/                             # 会话日志
└── storage/                         # 持久化状态

~/.cache/oh-my-opencode/
├── connected-providers.json         # 已连接提供商
├── model-capabilities.json          # 模型能力数据
└── provider-models.json             # 提供商模型列表

九、适用场景

✅ 复杂多智能体项目
✅ 大型代码库重构
✅ 需要多模型协作的任务
✅ 追求高效率的专业开发者

十、安装方式

bash 复制代码

# 前提：OpenCode 已安装
# 方式一：npx 安装（推荐）
bunx oh-my-opencode install

# 方式二：npm 全局安装
npm install -g oh-my-opencode

注意：OMO 深度绑定 OpenCode 生态，许可证为 SUL-1.0（存在法律不确定性）。