Back to Details

omc

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

omc (oh-my-claudecode) — Claude Code Multi-Agent Orchestration

omc (oh-my-claudecode) — Claude Code 多Agent编排

When to use this skill

何时使用该技能

  • You want Teams-first multi-agent orchestration inside Claude Code
  • You need 29+ specialized agents with smart model routing (Haiku → Opus)
  • Complex tasks that benefit from parallel agent execution with verify/fix loops
  • Any Claude Code workflow that needs persistent, guaranteed-completion execution
  • You want skill layers: Guarantee (ralph) → Enhancement (ultrawork) → Execution
  • You need 3-model synthesis with Codex + Gemini + Claude (CCG mode)
  • 你想在Claude Code内部使用优先团队模式的多Agent编排
  • 你需要29+个配备智能模型路由（Haiku → Opus）的专用Agent
  • 适合通过Agent并行执行+验证/修复循环提升效率的复杂任务
  • 任何需要持久化、保证完成执行的Claude Code工作流
  • 你需要技能分层：保障层（ralph）→ 增强层（ultrawork）→ 执行层
  • 你需要Codex + Gemini + Claude的三模型合成（CCG模式）

1. Installation (3 Steps)

1. 安装（3步）

Step 1: Install plugin
bash
/plugin marketplace add https://github.com/Yeachan-Heo/oh-my-claudecode
/plugin install oh-my-claudecode
Step 2: Run setup
bash
/oh-my-claudecode:omc-setup
Step 3: Build something
text
autopilot: build a REST API for managing tasks
npm alternative: 
npm install -g oh-my-claude-sisyphus
Enable native teams (
~/.claude/settings.json
):
json
{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}
步骤1：安装插件
bash
/plugin marketplace add https://github.com/Yeachan-Heo/oh-my-claudecode
/plugin install oh-my-claudecode
步骤2：运行初始化配置
bash
/oh-my-claudecode:omc-setup
步骤3：构建项目
text
autopilot: build a REST API for managing tasks
npm替代安装方式: 
npm install -g oh-my-claude-sisyphus
开启原生团队功能 (
~/.claude/settings.json
):
json
{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

2. Orchestration Modes

2. 编排模式

ModeWhat it isUse For
Team (canonical)5-stage pipeline: 
plan → prd → exec → verify → fix
Coordinated agents on shared task list
AutopilotFull autonomous 5-stage pipelineEnd-to-end feature work (idea → code)
UltraworkMaximum parallelism burstFast fixes/refactors across codebase
RalphPersistent loop: execute → verify → fixTasks that must complete fully, no partials
PipelineSequential staged processingStrict ordering / multi-step transforms
CCG3-model synthesis (Codex + Gemini + Claude)Mixed backend + UI work
omc team (CLI)tmux workers with Codex/Gemini/ClaudeCross-model code review, security, design
模式说明适用场景
Team（标准模式）5阶段流水线：
plan → prd → exec → verify → fix
协调多个Agent处理共享任务列表
Autopilot完全自主的5阶段流水线端到端功能开发（想法 → 代码）
Ultrawork最大并行度爆发模式跨代码库快速修复/重构
Ralph持久化循环：执行 → 验证 → 修复必须100%完成、不允许部分交付的任务
Pipeline顺序阶段处理严格顺序执行/多步骤转换场景
CCG三模型合成（Codex + Gemini + Claude）后端+UI混合开发工作
omc team (CLI)搭载Codex/Gemini/Claude的tmux工作进程跨模型代码评审、安全检查、设计工作

Skill Layer Composition

技能层结构

┌──────────────────────────────────────────┐
│ GUARANTEE LAYER (optional)               │
│ ralph — won't stop until verified done   │
└──────────────────────────────────────────┘
                    │
                    ▼
┌──────────────────────────────────────────┐
│ ENHANCEMENT LAYER (0–N skills)           │
│ ultrawork (parallel) | git-master (VCS)  │
└──────────────────────────────────────────┘
                    │
                    ▼
┌──────────────────────────────────────────┐
│ EXECUTION LAYER (primary skill)          │
│ default (build) | planner | orchestrate  │
└──────────────────────────────────────────┘
┌──────────────────────────────────────────┐
│ 保障层（可选）                           │
│ ralph — 验证通过前不会停止               │
└──────────────────────────────────────────┘
                    │
                    ▼
┌──────────────────────────────────────────┐
│ 增强层（0–N个技能）                      │
│ ultrawork（并行） | git-master（VCS）    │
└──────────────────────────────────────────┘
                    │
                    ▼
┌──────────────────────────────────────────┐
│ 执行层（核心技能）                       │
│ default（构建） | planner | orchestrate  │
└──────────────────────────────────────────┘

3. Magic Keywords (Auto-Detection)

3. 魔法关键词（自动识别）

KeywordEffect
autopilot
, 
build me
, 
I want a
Full autonomous pipeline
ralph
, 
don't stop
, 
must complete
Persistent loop until verified
ulw
, 
ultrawork
Maximum parallelism
ccg
, 
claude-codex-gemini
3-model synthesis
ralplan
Consensus-based iterative planning
deep interview
, 
ouroboros
Socratic requirements clarification
deepsearch
Codebase-focused deep search
deepanalyze
, 
deep-analyze
Deep analysis mode
ultrathink
Deep reasoning mode
tdd
, 
test first
TDD workflow
deslop
, 
anti-slop
Clean AI expression patterns
cancelomc
, 
stopomc
Cancel active execution mode
plan
Planning interview
关键词效果
autopilot
, 
build me
, 
I want a
启动全自主流水线
ralph
, 
don't stop
, 
must complete
启动持久化循环直到验证通过
ulw
, 
ultrawork
最大并行度模式
ccg
, 
claude-codex-gemini
三模型合成模式
ralplan
基于共识的迭代规划
deep interview
, 
ouroboros
苏格拉底式需求澄清
deepsearch
面向代码库的深度搜索
deepanalyze
, 
deep-analyze
深度分析模式
ultrathink
深度推理模式
tdd
, 
test first
TDD工作流
deslop
, 
anti-slop
生成干净的AI输出模式
cancelomc
, 
stopomc
取消正在运行的执行模式
plan
规划访谈

4. Team Mode (Canonical)

4. 团队模式（标准）

bash
/oh-my-claudecode:team 3:executor "fix all TypeScript errors"
5-stage pipeline:
team-plan → team-prd → team-exec → team-verify → team-fix (loop)
  • team-plan: Planning agent creates task list
  • team-prd: Architect designs solution
  • team-exec: N parallel executor agents implement
  • team-verify: Verifier confirms completion
  • team-fix: If verification fails, fix loop repeats
bash
/oh-my-claudecode:team 3:executor "fix all TypeScript errors"
5阶段流水线:
team-plan → team-prd → team-exec → team-verify → team-fix (loop)
  • team-plan: 规划Agent生成任务列表
  • team-prd: 架构师设计解决方案
  • team-exec: N个并行执行Agent实现需求
  • team-verify: 验证专员确认完成度
  • team-fix: 如果验证失败，重复修复循环

5. Agent System (29+ Specialized Agents)

5. Agent系统（29+个专用Agent）

Build / Analysis Lane: 
explore
(haiku) · 
analyst
(opus) · 
planner
(opus) · 
architect
(opus) · 
debugger
(sonnet) · 
executor
(sonnet) · 
verifier
(sonnet) · 
tracer
(sonnet)
Review Lane: 
code-reviewer
(opus) · 
security-reviewer
(sonnet) · 
critic
(opus) · 
code-simplifier
(opus)
Domain Specialists: 
test-engineer
· 
designer
· 
writer
· 
qa-tester
· 
scientist
· 
git-master
· 
document-specialist
Invoke via: 
/oh-my-claudecode:<agent-name>
or delegated through Task tool.
See references/agents-catalog.md for full profiles.
构建/分析赛道: 
explore
(haiku) · 
analyst
(opus) · 
planner
(opus) · 
architect
(opus) · 
debugger
(sonnet) · 
executor
(sonnet) · 
verifier
(sonnet) · 
tracer
(sonnet)
评审赛道: 
code-reviewer
(opus) · 
security-reviewer
(sonnet) · 
critic
(opus) · 
code-simplifier
(opus)
领域专家: 
test-engineer
· 
designer
· 
writer
· 
qa-tester
· 
scientist
· 
git-master
· 
document-specialist
调用方式: 
/oh-my-claudecode:<agent-name>
或通过任务工具委派。
查看 references/agents-catalog.md 获取完整配置。

6. CLI Tools

6. CLI工具

omc team (tmux Workers)

omc team（tmux工作进程）

bash
omc team 2:codex "review auth module for security"
omc team 2:gemini "redesign UI components"
omc team status <session>
omc team shutdown <session>
bash
omc team 2:codex "review auth module for security"
omc team 2:gemini "redesign UI components"
omc team status <session>
omc team shutdown <session>

omc ask (Provider Advisor)

omc ask（服务商咨询工具）

bash
omc ask claude "review this migration plan"
omc ask codex --prompt "identify architecture risks"
omc ask gemini --prompt "propose UI polish ideas"
bash
omc ask claude "review this migration plan"
omc ask codex --prompt "identify architecture risks"
omc ask gemini --prompt "propose UI polish ideas"

omc wait (Rate Limit Auto-Resume)

omc wait（限流自动恢复）

bash
omc wait              # Check status
omc wait --start      # Enable auto-resume daemon
omc wait --stop       # Disable daemon
bash
omc wait              # 查看状态
omc wait --start      # 启用自动恢复守护进程
omc wait --stop       # 关闭守护进程

Notifications

通知配置

bash
omc config-stop-callback telegram --enable --token <bot> --chat <id>
omc config-stop-callback discord --enable --webhook <url>
omc config-stop-callback slack --enable --webhook <url>
bash
omc config-stop-callback telegram --enable --token <bot> --chat <id>
omc config-stop-callback discord --enable --webhook <url>
omc config-stop-callback slack --enable --webhook <url>

7. Updating

7. 更新

bash
undefined
bash
undefined

Sync latest version

同步最新版本

/plugin marketplace update omc
/plugin marketplace update omc

Re-run setup

重新运行初始化配置

/oh-my-claudecode:omc-setup
/oh-my-claudecode:omc-setup

If issues after update

如果更新后出现问题

/oh-my-claudecode:omc-doctor

---
/oh-my-claudecode:omc-doctor

---

8. Optional: Multi-AI Orchestration

8. 可选：多AI编排

ProviderInstallWhat it enables
Gemini CLI
npm install -g @google/gemini-cli
Design review, UI consistency (1M token context)
Codex CLI
npm install -g @openai/codex
Architecture validation, code review cross-check
服务商安装命令启用功能
Gemini CLI
npm install -g @google/gemini-cli
设计评审、UI一致性检查（1M token上下文）
Codex CLI
npm install -g @openai/codex
架构校验、代码评审交叉核对

Instructions

使用说明

  1. Detect intent — match user request to the best orchestration mode (Team, Autopilot, Ralph, Ultrawork, CCG)
  2. Provide install path — if OMC is not yet installed, give the 3-step install sequence
  3. Show the invocation — give the exact command or magic keyword for the chosen mode
  4. Set expectations — explain what the mode does (pipeline stages, loop behavior, parallelism)
  5. Surface relevant CLI — mention 
    omc team
    , 
    omc ask
    , or 
    omc wait
    if they apply
  6. Link to references — point to the appropriate references/ file for deep-dive details
  1. 识别意图 — 将用户请求匹配到最合适的编排模式（Team、Autopilot、Ralph、Ultrawork、CCG）
  2. 提供安装路径 — 如果OMC还未安装，给出3步安装流程
  3. 展示调用方式 — 给出所选模式的精确命令或魔法关键词
  4. 说明预期效果 — 解释该模式的工作逻辑（流水线阶段、循环行为、并行度）
  5. 展示相关CLI命令 — 适用的话提及
    omc team
    、
    omc ask
    或
    omc wait
  6. 关联参考文档 — 指向对应的参考文件以获取深度细节

Examples

示例

Example 1: Multi-agent team task

示例1：多Agent团队任务

User: "여러 에이전트가 병렬로 TypeScript 에러 전부 고쳐줘" Response: Use Team mode — 
/oh-my-claudecode:team 3:executor "fix all TypeScript errors"
. Runs 3 parallel executors through plan→prd→exec→verify→fix pipeline.
用户: "让多个Agent并行修复所有TypeScript错误" 响应: 使用Team模式 — 
/oh-my-claudecode:team 3:executor "fix all TypeScript errors"
。运行3个并行执行器，走计划→需求→执行→验证→修复流水线。

Example 2: Guaranteed completion

示例2：保障完成任务

User: "테스트 전부 통과할 때까지 멈추지 마" Response: Use Ralph mode — 
ralph: fix all failing tests
. Persistent execute→verify→fix loop until all tests pass. Won't stop until verified.
用户: "直到所有测试通过前都不要停止" 响应: 使用Ralph模式 — 
ralph: fix all failing tests
。启动持久化的执行→验证→修复循环直到所有测试通过，验证通过前不会停止。

Example 3: New installation

示例3：全新安装

User: "OMC 설치하고 싶어" Response: 3-step install: 
/plugin marketplace add https://github.com/Yeachan-Heo/oh-my-claudecode
→ 
/plugin install oh-my-claudecode
→ 
/oh-my-claudecode:omc-setup
. Enable native teams in 
~/.claude/settings.json
.
用户: "我想安装OMC" 响应: 3步安装: 
/plugin marketplace add https://github.com/Yeachan-Heo/oh-my-claudecode
→ 
/plugin install oh-my-claudecode
→ 
/oh-my-claudecode:omc-setup
。在
~/.claude/settings.json
中开启原生团队功能。

Best practices

最佳实践

  • Default to Team mode for multi-agent work — swarm/ultrapilot are legacy and route to Team
  • Enable 
    CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
     in 
    ~/.claude/settings.json
    before using Team mode
  • Use ralph for critical tasks — it composes automatically with ultrawork for parallel+persistent execution
  • Use CCG for mixed workloads — backend execution (Codex) + large-context analysis (Gemini) + orchestration (Claude)
  • Re-run 
    /oh-my-claudecode:omc-setup
     after every plugin update to refresh hooks and CLAUDE.md
  • npm package name differs — it's 
    oh-my-claude-sisyphus
    , not 
    oh-my-claudecode
  • Cancel safely — use 
    cancelomc
    keyword or 
    /oh-my-claudecode:cancel
    ; state is preserved for resume
  • 多Agent工作优先使用Team模式 — swarm/ultrapilot是旧版本模式，会自动路由到Team模式
  • 使用Team模式前请先在
    ~/.claude/settings.json
    中开启**
    CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
    **
  • 关键任务使用ralph模式 — 它会自动和ultrawork组合实现并行+持久化执行
  • 混合工作负载使用CCG模式 — 后端执行（Codex）+ 大上下文分析（Gemini）+ 编排（Claude）
  • 每次插件更新后重新运行
    /oh-my-claudecode:omc-setup
    以刷新钩子和CLAUDE.md
  • npm包名有差异 — 包名为
    oh-my-claude-sisyphus
    ，不是
    oh-my-claudecode
  • 安全取消任务 — 使用
    cancelomc
    关键词或
    /oh-my-claudecode:cancel
    ；任务状态会被保留以便恢复

Quick Reference

快速参考

ActionCommand
Install
/plugin marketplace add https://github.com/Yeachan-Heo/oh-my-claudecode
Setup
/oh-my-claudecode:omc-setup
Team mode
/oh-my-claudecode:team N:executor "task"
Autopilot
autopilot: <task>
Ralph loop
ralph: <task>
Ultrawork
ulw <task>
CCG synthesis
ccg: <task>
Deep interview
deep interview: <topic>
Cancel
cancelomc
Update
/plugin marketplace update omc && /oh-my-claudecode:omc-setup
Debug
/oh-my-claudecode:omc-doctor
→ Full documentation · GitHub
操作命令
安装
/plugin marketplace add https://github.com/Yeachan-Heo/oh-my-claudecode
初始化配置
/oh-my-claudecode:omc-setup
团队模式
/oh-my-claudecode:team N:executor "task"
自动驾驶模式
autopilot: <task>
Ralph循环
ralph: <task>
Ultrawork模式
ulw <task>
CCG合成模式
ccg: <task>
深度访谈
deep interview: <topic>
取消
cancelomc
更新
/plugin marketplace update omc && /oh-my-claudecode:omc-setup
调试
/oh-my-claudecode:omc-doctor
→ 完整文档 · GitHub

References

参考资料

FileContents
references/agents-catalog.mdAll 29+ agent profiles, tiers, delegation rules
references/modes-reference.mdMode deep-dives, skill layer composition
references/hooks-reference.mdHook events, injection patterns, kill switches
references/cli-reference.mdFull CLI syntax: omc team/ask/wait/config
文件内容
references/agents-catalog.md全部29+个Agent的配置、等级、委派规则
references/modes-reference.md模式深度说明、技能层结构
references/hooks-reference.md钩子事件、注入模式、终止开关
references/cli-reference.md完整CLI语法：omc team/ask/wait/config