OMX团队协作实战：3个执行者并行、一套状态全员共享

OMX团队协作实战3个执行者并行、一套状态全员共享【免费下载链接】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的 OMX 团队协作功能就是冲着它来的把多个 AI 助手并行拉起来用共享状态管分工、挡冲突、验结果。它到底做了什么OMX 团队协作的编排、分工与状态共享核心是一台五阶段状态机。团队编排器 把团队从 team-plan 推到 team-prd、team-exec、team-verify、team-fix每次跳转都有白名单约束——规划完不能直接宣布完成修复阶段超过循环上限就判失败而不是原地打转。这套设计回答的是谁在什么时候干什么规划阶段由 analyst 和 planner 把需求拆成带依赖的任务清单执行阶段 executor 写代码、test-engineer 补测试验证阶段 verifier 和各评审角色只认证据给出 pass/fail修复阶段 debugger 先定位根因executor 再动手。角色目录里有 20 多个专职代理这种按阶段配人的分工方式就是 OMX 多代理分工的典型形态。执行层更实在omx team把当前 tmux 窗口切开每个 worker 都是独立的完整 CLI 会话不是进程里的一条线程。所有人共享同一个状态目录.omx/state/team/team-name/——任务存在 task- .json 里worker 必须带 claim token 认领后才能动ACK 和进度回写到 mailbox 文件谁想看全局都能看。文件改动默认走独立 git worktree每个任务做完先提交leader 再做增量合并并行就不会互相覆盖。一条真实工作流给模块加认证的完整流程拿给一个模块加认证这个典型场景走一遍。第一步先开深度访谈$deep-interview 澄清认证改动的范围和边界它排在最前面是因为执行质量通常卡在意图清晰度上——不改什么、边界在哪、哪些决策必须人拍板不先说清楚拉的人越多跑偏越远。第二步让计划过共识评审$ralplan --interactive 评审认证计划的取舍Planner 出方案Architect 审架构Critic 核对验收标准不 APPROVE 就循环返工。这一步给整个团队一个唯一事实来源避免各 worker 按自己的理解干活。第三步正式拉起团队omx team 3:executor 并行执行已批准的认证计划三个 executor 从共享任务列表里轮流认领各在各的 worktree 里干活做完一个任务提交一个。监控阶段别靠盯面板用omx team status team-name看快照。收尾有条硬规矩pending、in_progress、failed 三个数都归零才能omx team shutdown。怎么选配置小中大三档任务的角色搭配不需要背全量组合按任务大小分档就够了任务规模推荐配置理由小单文件、原子修复1 个 executor很小的任务 OMX 会把隐式 fanout 压到 1 个 worker省协调开销中单功能如加认证2-3 executor 1 个验证向角色并行交付验证 lane 独立拿证据把关大跨模块、有依赖executor 为主配 architect/planner 和 quality-reviewer、security-reviewer多领域分工worktree 隔离文件变更有两个细节值得知道N:agent-type里选的是 worker 角色提示不是 CLI某个理想角色不可用时从现有名册里挑最接近的并说明原因别硬造一个。这份搭配思路基本就是 AI 编码助手团队配置的通用决策框架。踩过的坑与解法 ⚠️任务互相阻塞是最常见的。解法在设计里任务必须先认领后动手worker 被卡住时规范是上报最小求助并继续做安全的切片而不是整条 lane 停摆。任务图里有共享文件或依赖时打开协调检查点完成前核对上下游契约和验证证据。状态不同步是第二个坑典型症状是我瞄一眼面板觉得它在跑。正确姿势是把证据当依据先omx team status再看 mailbox 文件手工敲键只是兜底手段。还有个顺序别反完成门没过的情况下不要 shutdown否则没干完的 worker 再写状态会报 ENOENT整轮记录被污染。执行者过多反而慢是第三个坑。并行不是免费的每个 worker 都要认领、提交、回写状态协调开销超过并行收益时人越多越乱。判断标准很简单任务能不能切成没有共享文件的独立切片切不开就别硬并行1-2 个人足矣。说白了OMX 团队协作就是把多人 AI 协作从口头约定变成了可执行的状态机并行被限制在安全边界内冲突被状态文件挡住验证闭环在收尾前完成。想上手的话建议先读一遍 skills/team/SKILL.md 里的生命周期和状态文件约定再拿一个中等任务练手。卡住的时候第一反应永远是先跑omx team status看证据而不是猜。【免费下载链接】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），仅供参考