SuperAPI AI 工具集

omx

智能体与模型

查看项目

更新于 10-16 08:26

技能介绍

用途

OMX(oh-my-codex)是面向 OpenAI Codex CLI 的多智能体编排层,用于在 Codex CLI 中组织复杂的多智能体工作流。它适合需要并行团队协作、分阶段流水线执行、持久化状态与记忆、以及角色化智能体分工的开发场景。

主要能力

角色提示词(30 个智能体)

  • 核心开发: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,用于产品规划。

工作流技能(40+)

  • autopilot($autopilot):从想法到可运行代码的全自主执行。
  • ralph($ralph):带验证器校验的自引用循环,直至完成。
  • ultrawork($ulw):通过并行智能体编排实现最大并行度。
  • team($team):使用 Codex CLI 原生团队协调 N 个智能体。
  • plan($plan):带共识与审查模式的战略规划。
  • research($research):并行科学家智能体进行综合研究。
  • tdd($tdd):测试先行开发,红-绿-重构循环。
  • build-fix($build-fix):修复构建错误、类型错误与工具链故障。
  • code-review($code-review):跨所有质量维度的综合代码审查。
  • security-review($security-review):聚焦漏洞与信任边界的安全审计。
  • cancel($cancel):停止执行模式并清除活动状态。

MCP 服务器

  • omx_state:持久化模式生命周期状态。
  • omx_memory:面向长时间运行会话的记忆与记事本界面。
  • omx_code_intel:代码智能与上下文。
  • omx_trace:执行追踪与调试。

使用方式

安装与设置

前置条件:macOS 或 Linux(Windows 通过 WSL2)、Node.js >= 20、已安装 Codex CLI(npm install -g @openai/codex)、已配置 Codex 认证。

安装命令:

npm install -g oh-my-codex omx setup omx doctor

推荐启动配置:

omx --xhigh --madmax

角色提示词(在 Codex 内)

/prompts:architect "analyze current auth boundaries" /prompts:executor "implement input validation in login" /prompts:security-reviewer "audit OAuth flow"

工作流技能

$plan "ship OAuth callback safely" $autopilot "implement user registration" $team 3:executor "fix all TypeScript errors"

团队模式(终端)

omx team 4:executor "parallelize a multi-module refactor" omx team status <team-name> omx team resume <team-name> omx team shutdown <team-name>

启动标志

  • --yolo:快速执行,最少验证。
  • --high:高推理强度。
  • --xhigh:超高推理强度。
  • --madmax:映射到 Codex --dangerously-bypass-approvals-and-sandbox。
  • --force:强制操作。
  • --dry-run:预览而不执行。
  • --verbose:详细输出。

分阶段流水线

OMX 实现结构化执行流水线:team-plan → team-prd → team-exec → team-verify → team-fix。

  • Plan:工作的战略分解。
  • PRD:产品需求定义。
  • Exec:团队工作者的并行执行。
  • Verify:交付物验证。
  • Fix:自动化错误解决。

钩子扩展(v0.4.0+)

原生生命周期事件:session-start / session-end / session-idle、turn-complete。

插件工作流:

OMX_HOOK_PLUGINS=1 omx hooks test omx hooks init omx hooks status omx hooks validate omx hooks test

插件文件:.omx/hooks/*.mjs

配置

AGENTS.md 注入:默认情况下,OMX 注入项目级 AGENTS.md:

-c model_instructions_file="<cwd>/AGENTS.md"

环境控制:

OMX_BYPASS_DEFAULT_SYSTEM_PROMPT=0 omx OMX_MODEL_INSTRUCTIONS_FILE=/path/to/instructions.md omx

快速参考

  • omx:启动带 HUD 的 Codex。
  • omx setup:安装提示词、技能、配置接线。
  • omx doctor:安装/运行时诊断。
  • omx doctor --team:团队/集群诊断。
  • omx team <n>:<role> "<task>":启动团队工作者。
  • omx team status <name>:显示团队状态。
  • omx team shutdown <name>:关闭团队。
  • omx status:显示活动模式。
  • omx cancel:取消执行模式。
  • omx reasoning <mode>:设置推理强度(low/medium/high/xhigh)。
  • omx hud:HUD 显示选项。
  • omx help:显示帮助。

适用场景

  • 使用 OpenAI Codex CLI 编排复杂的多智能体工作流。
  • 在 tmux 中运行并行团队工作者以协调任务执行。
  • 使用持久化 MCP 服务器进行状态、记忆与代码智能管理。
  • 执行分阶段流水线(plan → prd → exec → verify → fix)。
  • 利用基于角色的智能体提示词完成专项任务。

限制

  • 需要 macOS 或 Linux(Windows 需通过 WSL2)。
  • 需要 Node.js >= 20。
  • 需要预先安装并配置 Codex CLI 及认证。
  • 其他平台、收费、价格等信息暂未提供。

资源

  • 网站:https://yeachan-heo.github.io/oh-my-codex-website/
  • GitHub:https://github.com/Yeachan-Heo/oh-my-codex
  • npm:https://www.npmjs.com/package/oh-my-codex
  • 许可证:MIT License