code-yeongyu/oh-my-openagent · 上手攻略

  • 仓库：code-yeongyu/oh-my-openagent
  • 链接：https://github.com/code-yeongyu/oh-my-openagent
  • 分类：agent
  • 作者：Jay
  • 更新：2026-07-06

这是什么

oh-my-openagent（简称 OmO）是一个面向编码 Agent 的生产级编排框架，核心理念是"让 AI Agent 把任务做完，而不是停在半成品"。

它本质上是给 OpenCode（Anthropic 官方开源 CLI）配备的完整 Agent 引擎：多 Agent 协作、54+ 生命周期钩子、内置 MCP 工具链、ultrawork 模式（持续工作直到任务验证完成）、Team Mode（多线程并行 Agent 团队）。作者在 README 中坦承"Anthropic blocked OpenCode because of us"，可见其对 OpenCode 的深度定制程度。

OmO 还孵化了 LazyCodex——将 OmO 的 Hephaestus 深工 Agent 轻量移植到 OpenAI Codex CLI 的版本，适合不想用完整 OmO 但想要可靠编码 Agent 的用户。

解决什么问题

大多数编码 Agent（Claude Code、Cursor、Copilot）在复杂项目里容易： - 停在 80% 完成度，声称成功但实际有 bug - 上下文耗尽后丢失全局理解 - 没有验证手段，代码"看起来对了"但跑不通 - 多文件重构时出现 stale line 错误

OmO 的解法： Discipline Agents（自律 Agent）+ 验证门控 + Hash-Anchored Edit Tool（基于行内容哈希而非行号编辑），让 Agent 不"摆烂"。

快速安装

OmO 提供两个版本，建议让另一个 AI Agent 来安装——因为 Ultimate 版涉及订阅选择、多模型配置和认证流程，人类容易出错。

Ultimate 版（OpenCode + 完整功能）

# 需要 Bun 环境
bunx oh-my-openagent install
# 安装过程会启动 TUI 交互界面，引导选择订阅、模型、提供商认证

Light 版（Codex CLI + 核心组件）

# 需要 Node/npm 环境，无需 Bun
npx lazycodex-ai install

# 非交互模式（静默）
npx lazycodex-ai install --no-tui --codex-autonomous

⚠️ 注意：omo 在 npm 上是另一个无关包，不要用 npx omo 或 bunx omo，必须用 bunx oh-my-openagent 或 npx lazycodex-ai。

跳过安装指南（让 AI 帮你装）

将以下 prompt 粘贴到任意 AI 编码助手（Claude Code / AmpCode / Cursor）：

Install and configure oh-my-openagent by following the instructions here:
https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/refs/heads/dev/docs/guide/installation.md

核心用法

ultrawork（核心命令）

输入 ultrawork（或简写 ulw），OmO 会启动"不停止不放弃"模式——调度多个 Discipline Agents 并行工作，持续到任务 100% 验证完成。

# 在 OpenCode 中直接输入
ultrawork 为这个 React 项目添加深色模式支持

ulw-loop（自验证循环）

ulw-loop 是一个自引用循环：Agent 声称完成后，Oracle Agent 必须验证才能退出。普通模式上限 100 次迭代，ultrawork 模式下 500 次。

$ulw-loop "把所有 API 调用加上 retry 逻辑" [--strategy=reset|continue]

ulw-plan（战略规划）

在动手之前，Prometheus Agent 会用 Socratic 提问方式做访谈，明确范围后才生成可执行计划。不会一上来就开始写代码。

$ulw-plan "把单体服务拆成微服务"
# → Prometheus 提问 → 分析 → 输出 plans/.md 计划文件

start-work（执行计划）

$start-work plans/my-plan.md [--worktree <path>]
# 读取计划文件，逐条完成，每条经过 5 个证据门控验证

Team Mode（并行 Agent 团队）

v4.0 引入：1 个 Lead Agent + 最多 8 个并行成员，每个成员有明确的职责边界和所有权区域，实时通过 tmux 可视化。

# 定义团队成员后，用 /team_* 命令启动
# 适合：多角度调研、多模块同步开发

init-deep（项目上下文初始化）

/init-deep
# 自动在项目各目录生成 hierarchical AGENTS.md
# 让 Agent 从本地规范开始理解项目，而非从全局提示词开始
# 效果：token 效率提升 + 理解质量提升

典型使用场景

场景 推荐命令
一次性大重构（如 8000 条 eslint 警告） ultrawork
复杂新功能（需要调研 + 设计 + 实现） $ulw-plan → $start-work
多模块并行开发 Team Mode
深层代码研究（理解陌生 codebase） $ulw-loop + 并行 explore subagents
持久化大任务（不怕 session 断） $start-work --worktree

Agent 体系一览

Agent 模型 职责
Sisyphus claude-opus-4-7 / kimi-k2.6 / glm-5.1 主协调器，计划 + 委派
Hephaestus gpt-5.5 自主深工，拿到目标就自己干到底
Prometheus claude-opus-4-7 / kimi-k2.6 / glm-5.1 战略规划，访谈模式
Oracle - 验证每个完成声明
Librarian / Explore - 代码库探索专家

坑与注意

  1. Bun vs Node 环境：Ultimate 版依赖 Bun，bunx 是首选；Light 版只需要 Node/npm。Bun 未安装先装 Bun：curl -fsSL https://bun.sh/install | bash
  2. 模型不是越贵越好：README 提到仅靠 ChatGPT Subscription（$20）就能良好运行 ultrawork；OmO 根据任务类型自动路由到合适模型，不需要手动选。
  3. Team Mode 还在快速迭代：v4.0 刚出，部分细节可能随版本变化，使用前对照最新文档。
  4. 匿名遥测默认开启：安装后会发送每日去标识化活跃事件，可通过 OMO_DISABLE_POSTHOG=1 或配置 telemetry: false 关闭。
  5. 不要手动安装 Ultimate：README 原话"Strongly recommended: let an LLM agent install this for you"，人类容易在订阅选择和认证步骤出错。
  6. hashline edit 需学习：基于内容哈希而非行号的编辑方式有别于传统 diff，学习曲线约 1-2 次使用后适应。

与同类对比

方案 编排复杂度 验证机制 适合用户
OmO Ultimate ★★★★★ 多 Agent 编排 Hash-Anchored Edit + Oracle 验证 深度开发、复杂重构
LazyCodex ★★★ 单一深工 Agent 验证门控 Codex CLI 用户
Claude Code 官方 ★★ 单 Agent 无内置验证 日常简单任务
Cursor Agent ★★★ 多文件编辑 IDE 辅助检查 不想改工作流的用户
custom-agent + hooks ★★★ 自拼装 DIY 有自建能力的团队

OmO 是目前最完整的开源编码 Agent 编排框架，代价是配置和学习成本；LazyCodex 是其降级入口，适合只需要"一个能自己干完的编码 Agent"的用户。

一句话推荐结论

如果你在用 OpenCode 或 Codex CLI，且受够了 Agent 在 80% 处停住——OmO（或轻量版 LazyCodex）是目前最可靠的"不结束不罢休"解决方案；代价是需要一次认真的配置，但配置好后ultrawork 体验无出其右。

来源

  • GitHub README：https://github.com/code-yeongyu/oh-my-openagent
  • LazyCodex 官网：https://lazycodex.ai/
  • 安装指南（raw）：https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/refs/heads/dev/docs/guide/installation.md
  • Discord 社区：https://discord.gg/PUwSMR9XNk
  • 底层基于 opencode (Anthropic 官方 CLI)