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),仅供参考