OmX 完整教程:给 Codex CLI 加多智能体编排,长任务能续跑
2026/9/21 19:43:35 网站建设 项目流程

OmX 完整教程:给 Codex CLI 加多智能体编排,长任务能续跑

【免费下载链接】oh-my-codexOmX - Oh My codeX: Your codex is not alone. Add hooks, agent teams, HUDs, and so much more.项目地址: https://gitcode.com/GitHub_Trending/oh/oh-my-codex

Codex CLI 适合一问一答式的快速编码,但一旦任务跨好几个文件、跑上十几轮,它就容易在中途丢掉前面的约束,中断后再问还得从头交代背景。OmX(oh-my-codex)是加在 Codex CLI 之上的一个编排层:Codex 继续负责执行,它负责多智能体协作、结构化工作流和状态监控,让长任务能跨会话续跑、不丢上下文。

Codex 单轮高效,长任务就丢上下文

问题很具体:你让 Codex 修一个 bug,它修着修着把之前确认过的约束忘了;会话一断,进度就清零。OmX 的做法是把计划、日志、状态、模式统一放在项目里的.omx/目录,每一轮对话都基于这些落盘信息继续。中断、换会话之后,直接从上次停下的位置接上。

标准工作流三步跑通:澄清、计划、执行

在会话里依次调用三个技能:

  • $deep-interview "..."——需求模糊时让 Codex 先反问,把边界和"不做什么"问清楚
  • $ralplan "..."——产出实现计划并审查取舍,这一步只产出计划,不动代码
  • $ultragoal "..."——把批准的计划变成持久目标,按检查点逐项执行

配合/goal可以把目标写进检查点结构,跨轮次自动对账进度。这套流程是 omx 内置的默认路径,不需要自己维护进度笔记。

并行多智能体:omx team 怎么开、怎么监控

omx team 3:executor "..."会启动多个真实的 Codex 会话,分屏并行干活。每个 worker 在独立的 git worktree(可理解为仓库的一份独立工作副本)里工作,不会互相覆盖改动;它们靠.omx/state/team/下的状态文件协调,omx team resume还能恢复中断的团队。

多路并行时,人得知道谁在干活。omx hud --watch每秒刷新一次当前模式、worker 数、轮次和最后活动时间。

扩展钩子插件:.omx/hooks 下加一个 .mjs 就行

omx 自带 40 多个技能,$code-review$security-review$tdd等直接可用。想加自己的逻辑,在项目.omx/hooks/下放一个.mjs钩子插件,就能在 Codex 生命周期事件触发时执行自定义代码,omx hooks init会生成插件脚手架,事件模型见 docs/hooks-extension.md。

三步上手:npm 安装到跑通第一次工作流

前提:Node.js 20+,且 Codex CLI 已安装并登录。

npm install -g oh-my-codex omx doctor omx --worktree=feat/task --madmax --xhigh

第一条装好 omx,第二条检查安装是否完整,第三条启动一个带独立 worktree 的强推理会话。会话里依次调用$deep-interview$ralplan$ultragoal,第一次完整工作流就跑通了。

适合哪些场景,哪些情况不必装

值得上的场景:改动横跨多个文件的重构、需要复现和回归验证的 bug 修复、跨多轮且可能中断的长任务,以及需要代码审查、安全审查配合的任务。如果平时只是让 Codex 写个小脚本、答个技术问题,直接用它更省事。另外 omx 主要面向 macOS 和 Linux 环境,官方文档也建议以这两个平台为准。

更多细节看仓库自带的 Getting Started 文档和 docs/skills.html 技能参考,装完不确定的地方跑一次omx doctor,它会指出缺了什么。

【免费下载链接】oh-my-codexOmX - Oh My codeX: Your codex is not alone. Add hooks, agent teams, HUDs, and so much more.项目地址: https://gitcode.com/GitHub_Trending/oh/oh-my-codex

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询