ARTICLE · INTELLIGENCE

战地情报 · 详情页

来自尧图项目组的一线实战观察与深度解析

oh-my-codex 完整教程:给 Codex CLI 装上钩子、代理团队和状态看板

oh-my-codex 完整教程:给 Codex CLI 装上钩子、代理团队和状态看板 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-codexoh-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 --presetfullfull / 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 # 强启动--worktreefeat/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创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
RELATED READING

延伸阅读

更多一线实战笔记与深度复盘,助您持续精进