3 个 AI 代理并行改完一个登录模块：oh-my-codex 团队协作实战笔记

3 个 AI 代理并行改完一个登录模块oh-my-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-codexoh-my-codex 是架在 Codex CLI 上的团队协作工作流层它把多代理分工、并行执行和状态协调封装成一条omx team命令。适合正在用 Codex 写代码、想让 AI 代理协同干活的人。多个 AI 助手各干各的问题出在哪上周一个同事问我他同时开了三个 Codex 会话改同一个模块结果两个改同一处逻辑、一个改完不知道另外两个在干什么。AI 编码助手单点用没问题一旦多人格并行缺的不是算力而是一份工单。oh-my-codex 的 team 模式就是来补这一块的它用 tmux 把每个代理放进独立分屏再用一套共享状态文件当任务板谁领了哪张票、做到哪一步都写在明面上。团队怎么被编排一个五阶段状态机加角色分工机制只讲两点理解了就能上手。第一点阶段编排。团队编排器定义了一个五阶段状态机流转规则是硬编码的export type TeamPhase team-plan | team-prd | team-exec | team-verify | team-fix;plan → prd → exec → verify → fix验证不过打回执行重新来fix 最多循环 3 次超了团队直接判失败。就像项目经理先排 sprint 再分 ticket每个阶段有明确的出口条件不许跳级。完整流转规则在 src/team/orchestrator.ts。第二点角色分工。仓库在 src/agents/definitions.ts 内置了 31 种角色提示executor执行、architect架构、planner规划、verifier验证、security-reviewer、quality-reviewer、debugger、researcher 等。启动时用N:角色声明人数和角色同一个任务可以混编不同角色。最常用的一条启动命令长什么样启动一个 3 人团队2 个执行者加 1 个安全评审干登录模块的活omx team 2:executor,1:security-reviewer implement secure login flow它做了什么在 tmux 里切出 3 个分屏每个分屏跑一个完整 Codex 会话任务写入各自的 inbox.md状态落到.omx/state/team/team/目录——config.json、task-1.json、mailbox 各就各位全程留痕。跑起来之后用两条命令管它omx team status team-name omx team shutdown team-namestatus 读任务计数pending / in_progress / failedshutdown 是优雅收尾。注意 shutdown 只在pending0 in_progress0 failed0时才该敲任务还挂着就关等于把没干完的活直接删掉。不同任务规模怎么配代理组合任务规模推荐代理组合为什么这么配简单单模块小改1:executor一个执行者闭环即可验证交给自身测试中等带验证要求2:executor,1:verifier执行与验证分道verifier 基于证据验收再收尾复杂跨模块重构2:architect,1:planner,3:executor架构师定边界、规划师排依赖执行者并行铺量两个补充。N:agent-type选的是角色提示词不是 CLI——想混编 Claude 队友用OMX_TEAM_WORKER_CLI_MAPcodex,claude指定。改动面大时用omx team --worktree让每个 worker 在独立 git worktree 里干活共享同一份团队状态互不踩踏前提是你有 git 仓库。团队起不来或状态不同步怎么办现象omx team api报 ENOENTworker 还在写消息。解法多半是状态目录被提前删了——等任务全部终态再 shutdown而不是手动清目录。现象分屏越跑越乱HUD 出现在 worker 窗口里。解法启动前确认 leader 会话在 tmux 内用tmux list-panes清掉重复的hud --watch分屏再启动。现象shutdown 显示成功却残留 worker 分屏。解法那是上一次失败运行留下的旧 pane手动tmux kill-pane清掉再删.omx/state/team/team重跑。代理间消息走 mailbox 文件mailbox/leader-fixed.json实现见 src/team/state/mailbox.ts状态不同步时先查这个文件和omx team status别去对着 pane 盲敲回车。先跑omx team 1:executor ...跑通最小流程再逐步加人。参考 skills/team/SKILL.md 和 src/team/ 源码。【免费下载链接】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），仅供参考