omx

omx（oh-my-codex）——面向 Codex CLI 的多 Agent 编排

何时使用此技能

• 你想为 Codex CLI 配备更强大的运行时，以及可复用的角色提示词和工作流技能
• 你需要通过 tmux 团队工作者协调并行 Agent
• 你想要与 Claude /team、/autopilot、/ultrawork 或 /ultraqa 等效的 Codex/OMX 功能
• 你需要执行持久任务（$ralph）或进行共识规划（$ralplan）等复杂任务
• 你需要探索代码仓库（omx explore）或进行范围受限的 Shell 检查（omx sparkshell）
• 通过 $ask-claude 或 $ask-gemini 进行跨模型咨询

---

1. 快速开始

npm install -g @openai/codex oh-my-codex
omx setup
omx --madmax --high

在 Codex 中：

/prompts:architect "analyze the authentication flow"
$plan "map the safest implementation path"

思维模型：Codex 负责 Agent 工作。OMX 为其提供更好的提示词、可复用的工作流技能，以及围绕它构建的运行时层。先使用 omx --madmax --high，让 Agent 根据任务需要调用 $team、$ralph 或其他工作流。

---

2. Agent 角色（30+）

层级	Agent
核心开发	architect · planner · executor · debugger · verifier · explore
质量保证	style-reviewer · quality-reviewer · api-reviewer · security-reviewer · performance-reviewer
领域专家	dependency-expert · test-engineer · build-fixer · designer · writer · qa-tester
产品策略	product-manager · ux-researcher · product-analyst · information-architect

通过以下方式调用：/prompts:<agent-name> "task"

---

3. 工作流技能（35+）

技能	触发方式	描述
autopilot	$autopilot	全自动流程——从创意到可运行代码
ralph	$ralph	持续执行循环，直至验证完成
ultrawork	$ulw、$ultrawork	让独立 Agent 实现最大并行度
team	$team	N 个通过 tmux/worktree 隔离的协作 Agent
plan	$plan	实施前进行战略规划
ralplan	$ralplan	基于共识的迭代规划
deep-interview	$deep-interview	规划或执行前进行苏格拉底式澄清
deepsearch	$deepsearch	聚焦代码库的深度搜索
analyze	$analyze	基于证据的因果分析（追踪方法）
tdd	$tdd	测试优先开发（红-绿-重构）
build-fix	$build-fix	修复构建错误、类型错误和工具链故障
code-review	$code-review	多维度全面代码审查
security-review	$security-review	安全审计——漏洞、信任边界
ultraqa	$ultraqa	最大并行度的 QA/审查流程
visual-verdict	$visual-verdict	带结论的 UI/UX 视觉审查
frontend-ui-ux	$frontend-ui-ux	前端 UI/UX 设计与审查
ai-slop-cleaner	$ai-slop-cleaner	清理代码和文档中的 AI 腔
ask-claude	$ask-claude	与 Claude 进行跨模型咨询
ask-gemini	$ask-gemini	与 Gemini 进行跨模型咨询
git-master	$git-master	原子提交、变基和历史管理
ecomode	$ecomode	节省令牌的执行模式
web-clone	$web-clone	克隆并改造网页或 UI 模式
cancel	$cancel	停止活动执行模式

---

4. 团队运行时

# Start parallel team workers
omx team 3:executor "fix all TypeScript errors"
omx team 2:security-reviewer,1:architect "audit auth module"

# Team management
omx team status <team-name>
omx team resume <team-name>
omx team shutdown <team-name>

在 Codex 中：

$team 3:executor "parallelize this refactor"

要求：

平台	依赖项
macOS	brew install tmux
Ubuntu/Debian	sudo apt install tmux
Fedora	sudo dnf install tmux
Windows（原生）	winget install psmux
Windows（WSL2）	sudo apt install tmux

---

5. Claude 工作流对等

当用户要求在 Codex 中使用 Claude 风格的 team、autopilot、ultrawork 或 ultraqa 时，请阅读 references/parallel-quality-workflows.md。

Claude / OMC 意图	OMX 命令	适用场景
/team N:role "task"	$team N:role "task" 或 omx team N:role "task"	协同工作需要共享任务列表和隔离的工作者
/autopilot "task" 或 autopilot: task	$autopilot "task"	端到端的构想 → 计划 → 实现 → 验证应保持原生于 Codex
/ultrawork "task"	$ulw "task" 或 $ultrawork "task"	各独立工作流可以在几乎无需同步的情况下运行
/ultraqa "target"	$ultraqa "target"	QA/审查应分派到测试、安全、性能或 UI 等方面

不要重复使用 Claude 会话中的 .omc/state/。OMX 状态和临时文件应放在 .omx/ 下。 对于含糊的绿地开发请求，请先运行 $deep-interview，再运行 $autopilot。对于高保障的完成循环，请在 $ralph 之前使用 $plan 或 $ralplan。

---

6. CLI 命令

核心启动命令

omx                   # Launch Codex with OMX runtime
omx --madmax --high   # Recommended default (bypass + high reasoning)
omx --xhigh           # Extra-high reasoning effort

启动标志

标志	说明
--yolo	快速执行，尽量减少验证
--high	高推理强度
--xhigh	超高推理强度
--madmax	绕过审批/沙盒（--dangerously-bypass-approvals-and-sandbox）
--dry-run	预览但不执行
--verbose	详细输出

操作命令

omx setup             # Install prompts, skills, config, AGENTS scaffolding
omx doctor            # Verify installation
omx doctor --team     # Team/swarm diagnostics
omx status            # Show active modes
omx cancel            # Cancel execution modes
omx hud --watch       # Live HUD status monitor
omx reasoning <mode>  # Set: low/medium/high/xhigh
omx help              # Show help

探索与检查

omx explore --prompt "find where team state is written"   # Read-only repo lookup
omx sparkshell git status                                  # Bounded shell inspection
omx sparkshell --tmux-pane %12 --tail-lines 400           # Tail tmux pane output

---

说明

1. 识别意图 — 将请求匹配到最合适的工作流技能（$autopilot、$plan、$ralph、$team、$deep-interview）
2. 从推荐的启动方式开始 — 大多数会话使用 omx --madmax --high
3. 使用角色提示词进行分析 — 实施前使用 /prompts:architect "..."
4. 按需升级 — 完整的自主构建任务使用 $autopilot，协同工作使用 $team，独立的突发工作使用 $ulw，QA 分派使用 $ultraqa
5. 对含糊的请求使用 $deep-interview — 当意图、范围或边界不清楚时
6. 指向参考资料 — 链接到相关的 references/ 文件，了解深入细节

---

示例

示例 1：标准会话

omx --madmax --high

/prompts:architect "analyze the current auth flow"
$plan "implement OAuth safely"

示例 2：持续执行

$ralph "fix all failing tests and make them pass"

循环执行：执行 → 验证 → 修复，直到所有测试通过。

示例 3：并行团队协作

omx team 3:executor "refactor the API layer with proper tests"

示例 4：Claude ultrawork / ultraqa 对等用法

$autopilot "build the task API end to end"
$ulw "parallelize the independent cleanup tasks"
$ultraqa "review the auth flow across tests, security, and performance"

示例 5：编码前先澄清

$deep-interview "I want to add a payment system"

每次只问一个问题，通过苏格拉底式循环直到意图明确，然后交由 $plan 或 $ralph 处理。

---

最佳实践

• Codex 优先 — OMX 是工作流层，而非 Codex 的替代品；从 omx --madmax --high 开始
• 先用 $plan，再用 $ralph — 范围不清楚时先制定计划；用 ralph 确保执行
• 使用 $ralplan 达成共识 — 在确定方案前需要多种规划视角时使用
• $deep-interview 把关执行 — 含糊的绿地或棕地开发任务一律使用
• 团队模式为可选项 — 使用 $team 进行协同工作，使用 $ulw 进行独立的突发工作，使用 $ultraqa 分派 QA 工作
• 跨模型咨询 — 使用 $ask-claude 和 $ask-gemini 获取设计或架构方面的第二意见
• 使用 omx explore 安全查询 — 只读，不会修改任何内容
• 遇到问题时运行 omx doctor — 在手动调试前诊断安装问题

---

快速参考

命令/技能	操作
omx --madmax --high	推荐的启动方式
/prompts:architect "..."	分析和设计评审
$autopilot "..."	从创意到可运行代码的全自动流程
$plan "..."	战略规划
$deep-interview "..."	澄清模糊的请求
$ralph "..."	持续循环直至完成
$ralplan "..."	共识规划
$team N:role "..."	并行协作的 Agent
$ulw "..."	最大限度并行
$ultraqa "..."	并行 QA/评审突击
omx explore --prompt "..."	只读式代码库探索
omx sparkshell <cmd>	有界的 shell 检查
omx setup	安装/重新安装 OMX
omx doctor	诊断问题
omx cancel / $cancel	取消活动模式

→ 网站 · GitHub · npm

---

参考资料

文件	内容
references/agents-catalog.md	全部 30 多种 Agent 配置及其使用场景
references/skills-reference.md	完整技能列表，包含触发条件和说明
references/cli-reference.md	完整 CLI：omx team/explore/sparkshell/reasoning
references/parallel-quality-workflows.md	Codex/OMX 的 Claude team/autopilot/ultrawork/ultraqa 对等功能