企业官网建设流程全解析

OmX (oh-my-codex) 完整指南：用 hooks、多代理团队和 HUD 把 Codex 变成可控的编码工作流

【免费下载链接】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 写代码时，你大概率遇到过这三件事：任务说清楚之前代理就开始动手；多个子任务只能排队串行执行；代理跑到一半，你只能盯着终端猜它现在在干什么。OmX（oh-my-codex）就是冲着这三个痛点来的：它在 Codex CLI 外面包了一层工作流，提供 hooks 插件、agent teams 并行团队和 HUD 状态面板，让单人编码变成有分工、有状态、可定制的流程。

定位：它不替代 Codex，而是垫在 Codex 上面的一层

OmX 是一个为 OpenAI Codex CLI 设计的工作流层，官方推荐路径是 macOS 或 Linux 加 Codex CLI。执行引擎始终是 Codex 本身，OmX 提供的是另外三样东西：可复用的角色与技能（prompts 和 skills 目录里预置了几十个角色）、以$deep-interview、$ralplan、$ultragoal为主线的标准工作流、以及存放在.omx/目录下的持久化状态（计划、日志、记忆、模式跟踪）。如果你只想要裸的 Codex 对话，它确实用不上；但如果你希望每次会话的起点更强、流程可复现，这层值得装。

任务还说不清时：先问后规划，再谈执行

最典型的问题是需求边界模糊就开写。OmX 的默认主线分三步：先跑$deep-interview "..."让代理通过追问把范围和约束问清楚；再用$ralplan "..."把澄清后的范围变成一份经过权衡讨论的架构与实施计划，计划阶段到此为止、不动代码；最后用$ultragoal把批准的计划拆成带检查点的持久目标，执行产物记录在.omx/ultragoal里。长任务还可以叠加/goal命令，给 Codex 一个跨轮次持续核对的持久目标。这套顺序的意义在于：每个阶段有明确的产出物，你随时可以停在计划阶段审方案，而不是等代码写完才发现方向错了。

需要并行时：omx team 在 tmux 里拉起多个代理分工

一个代理干活慢，瓶颈往往不是速度而是串行。omx team是基于 tmux 的并行执行模式：它在分割窗格里启动真实的 worker 会话，通过.omx/state/team/下的状态文件协调分工。用法直接写在命令里，比如omx team 3:executor "analyze feature X and report flaws"就是派 3 个 executor 角色处理同一任务；每个 worker 默认使用独立的 git worktree，互不踩踏。有依赖的任务会自动启用更重的协调协议处理交接和合并边界，无依赖的独立任务则走轻量流程。如果你只想让一个代理死磕到完成而不需要多目标台账，用$ralph更合适。细节可以看 team 技能文档。

流程想定制时：写一个 .omx/hooks 插件接到运行时事件

标准工作流覆盖不了的部分，留给 hooks。OmX 的插件放在.omx/hooks/*.mjs，由运行时事件驱动，事件词汇包括session-start、pre-tool-use、post-tool-use、stop、session-end等八个，插件导出一个onHookEvent函数就能接上。整个生命周期四个命令就够：

omx hooks init omx hooks status omx hooks validate omx hooks test

init会在.omx/hooks/sample-plugin.mjs生成脚手架，插件默认启用，单插件默认超时 1500ms。注意团队 worker 会话里插件副作用默认跳过，保证只有 lead 会话产生副作用，避免重复触发。事件信封字段和禁用开关（OMX_HOOK_PLUGINS=0）的完整说明在 hooks 扩展文档。

想看代理在干什么：omx hud 把运行时状态摊到终端上

"状态不可见"在团队模式下最严重：窗口里有 leader 有 worker，谁在跑、谁卡住、跑到哪一步，靠肉眼看。omx hud直接读取.omx/state/下的状态文件，显示当前激活的模式（ralph、ultrawork、autopilot、team 等）、轮次和最近活动；加--watch每秒刷新，加--json输出原始状态供脚本消费，--preset=minimal|focused|full控制信息密度。在 tmux 会话里它是分屏布局的一部分，普通终端里也能独立用。

最短上手路径：三条命令进入第一个会话

前置要求是 Node.js 20+ 和一个已认证可用的 Codex CLI（codex --version能跑通即可，不要求用 npm 装的）。最短路径：

npm install -g oh-my-codex omx doctor

omx doctor检查安装完整性后，建议再跑一次真实冒烟测试omx exec --skip-git-repo-check -C . "Reply with exactly OMX-EXEC-OK"，验证鉴权和 provider 配置在真实请求下没问题。然后从你的 git 项目目录启动：

omx --worktree=feat/task --madmax --xhigh

这一行做三件事：把会话挪进名为feat/task的独立 worktree（隔离改动），--madmax关闭审批和沙箱护栏（仅限可信仓库使用），--xhigh拉满推理强度。macOS/Linux 下它默认在受管的 tmux 会话里启动，HUD 分屏随之可用；想绕过 tmux 直接用omx --direct。

证据：同一任务，两种实现的差距摆在一张图里

项目归档了一张基准对比截图（上图）：同一个"浏览器 Tetris"任务下，两种 AI 产出并排放置。左侧版本带完整计分板、下一步预览和按键说明面板，右侧版本只有最简游戏区。截图没有标注具体指标，但直观结论成立——在同样的任务描述下，流程层带来的差异会直接体现在产出的完整度上，这正是 OmX 想固化的东西：起点提示更强、中间有检查点、状态可回溯。

收尾

OmX 做的事情可以压缩成一句话：Codex 负责干活，它负责分工、留痕和定制。hooks 让你的自动化接进运行时事件，omx team让并行变成一条命令，omx hud让状态可见。如果本周有任务想在 Codex 上跑得更稳，就从npm install -g oh-my-codex加一次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