返回

oh-my-codex 教程系列:为 Codex CLI 添加超能力

oh-my-codex 是 OpenAI Codex CLI 的多代理协调层,提供角色提示、工作流技能和状态管理。本系列将详细讲解 8 个核心主题,帮助你掌握 Codex 的高级用法。

系列前言

如果你正在使用 OpenAI Codex CLI,那么 oh-my-codex (OMX) 可以让你的体验提升一个档次。

oh-my-codex 是什么?

oh-my-codex 是 Codex CLI 的增强层

  • Codex 执行实际的代理工作
  • OMX 提供可重用的角色提示和工作流
  • .omx/ 目录存储计划、日志和状态

与 Superpowers 的关键区别

特性 Superpowers oh-my-codex
触发方式 自动触发 显式命令
运行平台 Claude Code, Cursor, Codex 等 仅 Codex CLI
核心抽象 Skills(技能) Workflows(工作流)
状态管理 内存/临时文件 .omx/ 持久化
多代理 子代理开发模式 tmux 协调的并行团队

8 个核心主题概览

主题 命令/功能 核心作用
安装与入门 omx setup 初始化配置和 AGENTS.md
意图澄清 $deep-interview 模糊需求的苏格拉底式追问
规划工作流 $plan 生成可执行的 PRD 计划
角色系统 /prompts:* architect/executor/debugger/critic
持久执行 $ralph 自引用循环直到完成
多代理协调 $team tmux 并行团队执行
状态管理 .omx/ plans/logs/memory/state
高级功能 HUD/OpenClaw 监控面板和通知网关

前置要求

  • Node.js 20+
  • Codex CLI 已安装: npm install -g @openai/codex
  • tmux(macOS/Linux)或 psmux(Windows)

快速开始

# 安装
npm install -g oh-my-codex

# 初始化
omx setup

# 启动(推荐模式)
omx --madmax --high

# 尝试第一个技能
$plan "实现用户认证系统"

系列教程导航

  1. 安装配置与快速入门 - omx setup, --madmax --high
  2. $deep-interview:意图澄清工作流 - 苏格拉底式追问
  3. $plan:规划驱动的实现路径 - PRD 生成
  4. /prompts 角色系统详解 - 多角色协作
  5. $ralph 与执行模式 - 持久执行
  6. $team 多代理协调 - 并行团队
  7. .omx/ 状态管理与 Hooks - 状态持久化
  8. HUD、OpenClaw 与自定义技能 - 高级功能

下一篇教程 1:oh-my-codex 安装配置与快速入门

仓库地址github.com/yeachan-heo/oh-my-codex