
如何用 oh-my-codex 编排多个 AI 助手搭出一支能并行干活的虚拟开发团队【免费下载链接】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 助手却只能一次顶一条线。oh-my-codexomx是 OpenAI Codex CLI 的工作流增强层它让你把多个 AI 助手编成一队分工、拆任务、跑并行、盯状态靠的就是这套 AI 团队协作机制。这篇文章不讲参数清单只讲它怎么跑起来、适合哪些场景、哪里最容易翻车。先搞清楚 omx 在替你干什么可以把 omx 理解为给你的开发任务配了一支虚拟研发团队。平时你和一个 Codex 会话单打独斗时它既是规划者又是执行者需求没想清楚就开干是常态。装上 omx 之后执行引擎仍然是 Codex CLI但多了一层编排探索代码库的、澄清需求的、写代码的、验证结果的各是一个带角色提示词的 AI 助手实例由一个领队leader统一调度。它的团队流程是五阶段闭环源码里定义得清清楚楚见 src/team/orchestrator.ts规划team-plan把模糊诉求拆成可执行任务需求team-prd明确验收标准和边界执行team-exec多个 worker 并行改代码验证team-verify用测试和证据核对完成度修复team-fix发现问题的回到执行阶段迭代直到收敛这套编排基于 tmuxomx 把当前窗口切成多个 pane每个 pane 里是一个独立的 Codex 会话状态则全部落盘到项目里的.omx/state/team/团队名/目录下任务清单、邮箱、心跳文件都在那见 src/team/state/。所以团队状态不靠记忆而是文件里可查的事实。三步跑通第一次 AI 团队协作第一次不用追求配置周全三步就能看完整的协作流程。第一步安装并自检。前提是有 Node.js 20 和一个已登录的 Codex CLImacOS/Linux 上再装好 tmux。npm install -g oh-my-codex omx doctoromx doctor会检查安装完整性、hooks 和运行时依赖这一步能拦掉大部分装完不会用的问题。第二步在项目里启动一个会话。进到 git 项目目录用推荐姿势启动--worktree会在独立检出里干活避免污染主分支omx --worktreefeat/task --madmax --xhigh第三步开一个最小团队。语法是omx team N:角色 任务描述N 是 worker 数量omx team 2:executor 给登录接口加限频并补上单元测试窗口会被切出两个 worker pane各自认领任务。运行中用omx team status 团队名看进度全部任务结束后再omx team shutdown 团队名收尾。跑完这三步你就完整体验过了一次多 AI 助手协作。场景手册不同开发任务怎么排兵布阵大型功能开发先出方案再并行实施推荐组合先用 architect planner 在单会话里把方案和顺序定下来omx 的$ralplan流程就是干这个的再开执行团队。示例命令omx team 3:executor 按已批准的计划实现支付模块含接口、存储与测试适用边界前提是计划已被你批准、任务能切成互不重叠的块。需求还停留在大概想要个支付功能的阶段就别急着开团先跑$deep-interview把需求磨清楚。模块重构与疑难 bug诊断型角色进场推荐组合debugger根因定位负责诊断executor 负责动手最后留一条 verifier验证者通道核对回归。示例命令omx team 2:debugger 定位 flaky 集成测试的根因并给出修复方案适用边界适合症状明确但原因不明的问题。如果是横跨多个模块的大重构先按目录或模块把边界切干净再分配 worker否则多人会改到同一批文件。质量与安全评审执行和把关分开推荐组合executor 出功能security-reviewer安全评审和 quality-reviewer质量评审单独成组复核。omx 的 agent 目录里评审类角色是现成的直接按角色名拉起来就行。示例命令omx team 1:security-reviewer 审计认证模块的鉴权边界与令牌处理适用边界评审 lane 对改完的代码最有效适合在功能落地后独立跑对需求阶段的争议用 analyst 澄清比上安全评审更对口。跨模块并行用 worktree 物理隔离推荐组合多个 executor 各自在一个 git worktree同一仓库的独立工作副本里干活共享一份团队状态最后由领队统一合入。示例命令omx team --worktree 2:executor 分别在各自 worktree 完成两个独立模块适用边界必须在一个 git 仓库里分支名或路径冲突会让 worktree 创建失败。任务间有强依赖B 模块的接口要等 A 模块定稿时并行意义不大不如串行。团队配置选型表按复杂度选角色和人数任务复杂度推荐角色人数建议说明简单修复、文档executor 或 writer1–2单 owner 即可不必开团队中型功能executor verifier2–3 执行 1 验证至少留一条验证 lane别全拿去写码大型新功能architect、planner → executor verifier3–4 执行规划阶段用高阶角色执行阶段放量跨模块重构debugger / executor quality-reviewer2 执行 1 评审用 --worktree 隔离按模块切任务一个经验值并行 worker 超过 4 个之后协调成本互相等、等合并开始超过收益。人数不是越多越好任务切得开才值得加人。避坑经验这几处最容易被忽略别裸奔开团。最常见的问题是拿一句话需求直接omx team结果三个 worker 三种理解产出互相打架。正确姿势是先跑$deep-interview澄清需求、再$ralplan让方案过一遍评审把批准后的计划喂给团队。omx 的设计初衷就是先澄清、再规划、后执行跳步的代价会在验证阶段加倍还回来。盯状态看文件别看屏幕。worker 在 pane 里滚动输出的内容不可靠团队契约里明确反对靠肉眼判断进度。稳定做法是周期性跑omx team status 团队名或者直接看.omx/state/team/团队名/下的任务文件和 mailbox 里的应答记录。开团后保持每 30 秒查一次状态的节奏直到任务全部进入终态。资源争用靠切分解决不靠默契。多个 worker 改同一批文件是最典型的冲突源。两个办法一是拆任务时把文件边界写进任务描述你只动 src/auth 下二是加--worktree让每个 worker 有独立工作副本。任务描述里写清楚不许碰哪些目录比事后合并冲突省事得多。收尾等终态别提前 shutdown。正确的关闭顺序是pending0、in_progress0、failed0失败要有明确处理结论之后才执行omx team shutdown。提前杀掉领队会话的话还在跑的 worker 写状态文件时会报 ENOENT任务证据就断了。真有残留的僵尸 pane按先tmux list-panes清点、再手动清理、最后清状态目录的顺序来别误杀领队 pane。适合谁怎么开始omx 的 AI 团队协作模式主要服务两类人一是在 macOS/Linux 上日常使用 Codex CLI、手上经常有多条线并行需求的开发者二是想把需求澄清 → 规划 → 并行执行 → 验证这套流程固化下来、而不是每次靠口头约定的团队。如果你的任务就是改个错别字、调个样式原生 Codex 已经够用不必为此多装一层。开始路径很简单安装后先omx doctor自检在一个 git 项目里用omx --worktreefeat/task --madmax --xhigh起会话然后用omx team 1:executor 一个小任务从单 worker 试起跑顺了再上多人并行。想了解每个角色的模型配置和分工细节可以看官方入门文档和代理目录。【免费下载链接】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),仅供参考