企业官网建设流程全解析

oh-my-codex 完整教程：给 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

oh-my-codex（简称 OMX）是给 Codex CLI 加的一层工作流增强工具。它不替换 Codex，而是保留 Codex 作为执行引擎，把"澄清需求、制定计划、分配代理、跟踪状态"这些零散步骤串成一条默认流水线。如果你已经常用 Codex 写代码、又嫌它太单打独斗，这套钩子 + 代理团队 + 状态看板能帮你少切换工具、少重复沟通。适合个人开发者和小团队协作。

从一个卡住你的真实场景说起 🛠

想象你在让 Codex 改一个登录 bug。它一头扎进改代码，改到一半你才发现它没搞清楚"刷新令牌"的边界；想让它先出个方案，你又得手动来回追问；干到后半夜，你盯着终端也说不清它到底走到哪一步了。

这类"来回拉扯"是 Codex 单人模式的常见损耗。OMX 的做法是把这三件事固化成默认流程：需求不清就先澄清、计划没批就先别动手、进度实时挂在旁边。你负责判断和拍板，它负责把过程跑顺。

功能拆解：四块能力，按上手顺序讲

默认工作流：一条命令走完"澄清 → 规划 → 执行"

这是 OMX 最常用、也最该先学会的一环。它把一次任务拆成三个$前缀的步骤，你只管在终端里敲：

• 怎么用：意图不清时先$deep-interview澄清边界，再$ralplan批准实现计划，最后$ultragoal把它固化成可长期推进的目标。高风险任务还能插入$prometheus-strict做更严格的追问和压测。
• 关键命令：$deep-interview "clarify the auth change"、$ralplan "approve the plan"、$ultragoal "turn the plan into durable goals"
• 状态落盘：计划、日志、模式状态都写进项目里的.omx/目录，换个会话也能接得上。

代理团队：让多个专家并行分工

单干之外，OMX 内置了一批分工明确的角色：探索代码库的explore、划边界的architect、查根因的debugger、出方案的planner，以及负责验证的verifier。

• 怎么用：某个 Ultragoal 故事需要并行推进时，用$team拉起协作，而不是把所有事压给一个代理。
• 关键路径：角色定义见 prompts/，目录说明见 Agent 目录文档，运行逻辑在 功能源码 src/team/。

状态看板 HUD：一眼看懂跑到哪了

干到一半最想知道的是"现在啥状态"。HUD 就是把当前工作流状态直接渲染到终端里。

• 怎么用：omx hud看当前快照，加--watch每秒刷新，加--tmux单独开一个分屏常驻。
• 关键命令：omx hud --preset=full（full / focused / minimal 三档）。实现看 src/hud/。

自定义钩子 Hooks：把重复操作自动化 🧩

前几块开箱即用，这块才是"按你的习惯改"的入口。OMX 把会话开始、工具调用前后、会话结束等事件暴露成插件钩子，你写点逻辑就能自动化。

• 怎么用：omx hooks init生成一个样例插件，改完用omx hooks validate和omx hooks test验证。
• 关键路径：插件统一放在.omx/hooks/*.mjs，事件模型和字段说明见 Hooks 扩展文档，事件分发逻辑在 功能源码 src/hooks/。

最快上手路径：4 步跑通

前提：本机有 Node.js 20+，并且已装好、能登录的 Codex CLI（用codex --version确认）。

codex --version # 先确认 Codex 已装好、已登录 npm install -g oh-my-codex # 全局安装 OMX omx doctor # 体检安装形态是否完整 omx --madmax --xhigh # 强启动（--worktree=feat/task 可另开任务分支）

想从源码看也行：

git clone https://gitcode.com/GitHub_Trending/oh/oh-my-codex cd oh-my-codex

装完别急着开干，先跑一次omx exec冒烟测试，确认当前环境真能调用模型（绿色的omx doctor只代表装对了，不代表能跑通请求）。更多分步细节在 上手指南。

效果展示：AI 产出的差距，图里直接看 👀

OMX 的默认工作流（尤其$ralplan之后的执行阶段）会显著影响最终产出的完成度。下图是同一类浏览器游戏任务的基准对比——左边是走完整澄清与规划链路的成品，控件、计分、布局都更齐整：

结论一句话：让 Codex 先想清楚再动手，产物的"完成度"肉眼可见地更稳。

谁适合用，以及下一步

适合你，如果：你已经在用 Codex 写代码，但希望把"需求—计划—执行—验证"管起来；或者你希望多角色并行、进度可查，而不是一整晚盯一个终端。

不太需要它，如果：你只想要一个轻量的纯 Codex，不打算加工作流层——那 OMX 反而有点重。

下一步去哪：

• 装好跑不通：看 故障排查 的表格，对照omx doctor和codex login status。
• 想搞懂状态怎么流转：读 状态模型。
• 想接自己的插件：从 Hooks 扩展文档 开始。

挑一个你手头卡住的小任务，按上面 4 步装好，然后给它来一句$ralplan——跑通第一单，你就明白这套流水线帮你省了多少来回。

【免费下载链接】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