企业官网建设流程全解析

oh-my-codex 团队协作完整上手：3 个 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

oh-my-codex（OMX）是 OpenAI Codex CLI 的工作流增强层，它的团队协作能力可以一句话概括：把一群不同分工的 AI 助手编进同一个团队，围绕共享任务清单并行干活，规划、评审、验证、修复全部自动流转。你只发一条命令，剩下的协调由 OMX 接管。

团队花名册：每个 AI 角色干什么

主力角色分工如下（完整目录见 src/agents/definitions.ts，共 20 余个角色，按此处 9 个就能组队）：

三种编队，按任务选 🎯

按任务量级选档位，命令都能直接照抄（$team是会话内写法，等价于omx team）：

• 单个功能开发：$team 3:executor "implement the login feature"—— 3 个执行者直接并行开工，小任务不必加评审岗。
• 大型重构：$team 2:architect,1:planner,3:executor "refactor the payment module"—— 2 名架构师定边界，1 名规划师排顺序，3 名执行者落地；混合角色用逗号分隔，同名角色写人数。
• 安全优先交付：$team 2:executor,1:quality-reviewer,1:security-reviewer "harden the auth flow"—— 编码与评审同时在线，交付前问题就暴露出来。

前提：团队跑在 tmux 里，需要tmux -V可用；会话外直接跑omx team ...也可以。

指挥台：五步闭环

编排器像乐队指挥：不亲自吹号，只决定谁在什么时候进场。五步闭环是team-plan → team-prd → team-exec → team-verify → team-fix：

1. 规划（team-plan）：拆任务，产出计划；
2. 需求定义（team-prd）：验收标准落地成文；
3. 执行（team-exec）：worker 从共享任务清单认领任务并行干活；
4. 验证（team-verify）：verifier 拿证据核对，合格才放行；
5. 修复（team-fix）：验证不过自动回到执行重跑。

跳转是白名单制：verify 只能通过或转 fix，fix 超过 3 次直接判failed，不会无限打转；每次跳转都留痕，事后可查。逻辑在 src/team/orchestrator.ts，状态机定义在 src/team/state/types.ts。

协作的隐藏层：状态、通信与监控

团队跑起来后，底层有三件事在支撑。状态全部落盘：每个任务一个 JSON 文件，worker 用认领令牌独占任务，重复领取会被拒（src/team/state/tasks.ts）。worker 之间走邮箱系统，leader 发指令、收回执（src/team/state/mailbox.ts）。monitor 盯卡顿和心跳，HUD 在 tmux 里把进度摊开给你看（src/hud/）。排查问题基本就是读状态文件 + 看 mailbox，不需要猜。

实战走一遍：3 个执行者并行改一个模块 🔧

目标：重构登录模块，把邮箱密码登录抽成可插拔认证层。

1. 发一条命令：omx team 3:executor "refactor auth: extract pluggable credential layer"。
2. leader 先接管 plan/prd：拆出任务清单，写验收标准，落进共享状态。
3. 3 个 worker 各自认领任务，进入自动分配的独立 worktree 并行编码，互不抢文件。
4. 全部提交后 verifier 逐项核对证据和测试覆盖；发现问题自动进 fix 循环（最多 3 轮）。
5. 期间用omx team status <name> --json盯 pending / in_progress / failed 三个计数；三项归零后跑omx team shutdown <name>，它会顺手清理状态文件。

踩坑速查

• worker 卡住不动→ 跑omx team status <name> --json定位，再查它的 mailbox，必要时手动发一条消息唤醒 → src/team/state/mailbox.ts。
• fix 循环超限直接判失败→ 别硬试，通常是任务拆太大，改小粒度重发（上限 3 次，定义在 src/team/orchestrator.ts）。
• 并行规模拿不准→ 3 个 worker 起步，大任务提到 5~6 个；worker 默认各自独立 worktree，同仓并行不冲突 → src/team/worktree.ts。
• 想盯实时进度→ 开 HUD，tmux 里直接看面板；omx team status输出可被脚本解析 → src/hud/。
• 状态文件越积越多→ 团队收尾就 shutdown，它会清掉.omx/state/team/<name>/下的全部残留。

第一次体验不必上 5 个人：跑一条omx team 2:executor "给 README 加 Quickstart 章节"，五分钟内看完整走一遍五步闭环。跑顺之后，把 skills/team/SKILL.md 和 docs/ 里的团队契约文档过一遍，你就拿到了完整的配置手册。

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