教程概述

oh-my-claudecode 提供四种核心编排模式，每种模式针对不同的工作场景优化。理解这些模式的差异，能帮助你选择最合适的执行策略。

你将学到

• ✅ 四种编排模式的对比矩阵
• ✅ Autopilot 全自主执行模式
• ✅ Ralph 持久验证循环模式
• ✅ Ultrawork 最大并行度模式
• ✅ CCG 三模型顾问模式
• ✅ 模式选择指南

编排模式概览

模式对比矩阵

quadrantChart
    title 编排模式选择矩阵
    x-axis 低自主性 --> 高自主性
    y-axis 低验证 --> 高验证
    quadrant-1 高自主高验证
    quadrant-2 低自主高验证
    quadrant-3 低自主低验证
    quadrant-4 高自主低验证
    Autopilot: [0.8, 0.4]
    Ralph: [0.6, 0.9]
    Ultrawork: [0.5, 0.3]
    Team: [0.7, 0.7]
    CCG: [0.3, 0.6]

核心差异

触发方式

flowchart TD
    A[用户输入] --> B{检测关键词}
    B -->|autopilot| C[Autopilot 模式]
    B -->|ralph| D[Ralph 模式]
    B -->|ulw/ultrawork| E[Ultrawork 模式]
    B -->|ccg| F[CCG 模式]
    B -->|team| G[Team 模式]

    style A fill:#e1f5ff
    style C fill:#e8f5e9
    style D fill:#fff3e0
    style E fill:#f3e5f5
    style F fill:#e0f7fa

Autopilot 模式

特点

• 全自主执行：从规划到完成无需干预
• 单代理模式：一个 lead agent 完成所有工作
• 快速交付：适合时间敏感任务

工作流程

flowchart LR
    A[接收任务] --> B[自动规划]
    B --> C[自动执行]
    C --> D[自动验证]
    D --> E{完成？}
    E -->|否| F[自动修复]
    F --> C
    E -->|是| G[报告完成]

    style A fill:#e1f5ff
    style G fill:#e8f5e9

触发方式

# 方式 1：关键词触发
autopilot: build a REST API for managing tasks

# 方式 2：显式调用
/oh-my-claudecode:autopilot "build a REST API for managing tasks"

适用场景

实际案例

autopilot: create a user registration system with email verification

执行过程：

1. Lead 分析需求，创建实现计划
2. 创建数据库迁移文件
3. 实现用户模型和 Repository
4. 实现注册 API 端点
5. 实现邮件发送逻辑
6. 编写测试用例
7. 运行测试验证
8. 报告完成

配置选项

# ~/.omc/config.yaml
autopilot:
  max_iterations: 10
  auto_commit: false
  require_tests: true

Ralph 模式

特点

• 持久执行：不达目的不罢休
• 验证循环：执行 → 验证 → 修复 → 重复
• 内置 Ultrawork：自动包含并行能力

工作流程

flowchart TD
    A[接收任务] --> B[规划阶段]
    B --> C[执行阶段]
    C --> D[验证阶段]
    D --> E{验证通过？}
    E -->|否| F[修复阶段]
    F --> G{迭代次数？}
    G -->|< 最大| C
    G -->|>= 最大| H[报告失败]
    E -->|是| I[Architect 审核]
    I --> J{审核通过？}
    J -->|否| F
    J -->|是| K[报告完成]

    style A fill:#e1f5ff
    style K fill:#e8f5e9
    style H fill:#ffebee

触发方式

# 方式 1：关键词触发
ralph: refactor the authentication module

# 方式 2：显式调用
/oh-my-claudecode:ralph "refactor the authentication module"

验证循环详解

sequenceDiagram
    participant User
    participant Ralph
    participant Executor
    participant Verifier

    User->>Ralph: ralph: fix all tests
    Ralph->>Executor: 执行修复
    Executor->>Verifier: 提交验证
    Verifier->>Ralph: 报告失败
    Ralph->>Executor: 重新执行
    Executor->>Verifier: 提交验证
    Verifier->>Ralph: 报告通过
    Ralph->>User: 完成确认

迭代限制

ralph:
  max_iterations: 10  # 最大迭代次数
  verification_tier: architect  # 验证级别

适用场景

实际案例

ralph: fix all failing tests in the test suite

执行过程：

1. 运行测试，收集失败列表
2. 分析失败原因
3. 逐个修复
4. 运行测试验证
5. 如果还有失败，继续修复
6. 直到全部通过或达到最大迭代

Ultrawork 模式

特点

• 最大并行度：所有独立任务同时执行
• 快速处理：批量任务的最佳选择
• 无验证循环：一次性执行

工作流程

flowchart TD
    A[接收任务] --> B[任务分解]
    B --> C1[Task 1]
    B --> C2[Task 2]
    B --> C3[Task 3]
    B --> C4[Task 4]

    C1 --> D[结果收集]
    C2 --> D
    C3 --> D
    C4 --> D

    D --> E[整合输出]

    style A fill:#e1f5ff
    style B fill:#e3f2fd
    style E fill:#e8f5e9

触发方式

# 方式 1：关键词触发
ulw fix all TypeScript errors

# 方式 2：显式调用
/oh-my-claudecode:ultrawork "fix all TypeScript errors"

并行策略

gantt
    title Ultrawork 并行执行
    dateFormat mm:ss

    section Worker 1
    Task A    :a1, 00:00, 2m

    section Worker 2
    Task B    :a2, 00:00, 3m

    section Worker 3
    Task C    :a3, 00:00, 2m

    section Worker 4
    Task D    :a4, 00:00, 4m

    section Integration
    整合结果   :a5, after a4, 1m

适用场景

实际案例

ulw add missing type annotations to all files in src/

执行过程：

1. 扫描 src/ 目录
2. 识别需要添加类型的文件
3. 并行处理所有文件
4. 整合结果
5. 报告完成

CCG 模式

特点

• 三模型合成：Codex + Gemini + Claude
• 多视角建议：架构、UI、实现三个维度
• Claude 综合：最终由 Claude 整合输出

工作流程

flowchart TD
    A["/ccg task"] --> B["/ask codex"]
    A --> C["/ask gemini"]

    B --> D[Codex 输出]
    C --> E[Gemini 输出]

    D --> F[Claude 综合]
    E --> F

    F --> G[最终结果]

    style A fill:#e1f5ff
    style F fill:#fff3e0
    style G fill:#e8f5e9

触发方式

# CCG 只能通过命令触发
/ccg Review this PR — architecture and UI components

模型分工

适用场景

实际案例

/ccg 设计一个支付系统

输出示例：

## Codex 建议（架构与安全）

1. 使用 Stripe API 作为支付网关
2. 实现幂等性防止重复扣款
3. 敏感数据使用 Vault 存储
4. 添加 webhook 验证机制

## Gemini 建议（UI/UX 与文档）

1. 支付表单设计：卡片输入、确认弹窗
2. 用户引导：首次使用提示
3. 错误处理：友好的失败提示
4. API 文档结构

## Claude 综合建议

基于以上建议，推荐以下实现方案：

1. **技术选型**：Stripe + PostgreSQL
2. **架构设计**：支付服务独立部署
3. **安全措施**：Webhook 签名验证 + 幂等性
4. **UI 实现**：使用 Gemini 设计的表单组件
5. **文档**：按 Gemini 结构编写 API 文档

模式选择指南

决策树

flowchart TD
    A[开始任务] --> B{需要验证？}
    B -->|是| C{多视角？}
    B -->|否| D{批量任务？}

    C -->|是| E[CCG 模式]
    C -->|否| F{必须完成？}

    F -->|是| G[Ralph 模式]
    F -->|否| H[Team 模式]

    D -->|是| I[Ultrawork 模式]
    D -->|否| J{需要协调？}

    J -->|是| H
    J -->|否| K[Autopilot 模式]

    style E fill:#e0f7fa
    style G fill:#fff3e0
    style I fill:#f3e5f5
    style K fill:#e8f5e9

场景映射

组合使用

# 先用 CCG 获取设计建议
/ccg 设计认证系统

# 再用 Ralph 持久实现
ralph: 实现刚才设计的认证系统

# 最后用 Ultrawork 批量优化
ulw optimize all API response times

模式切换

运行中切换

# 取消当前模式
/oh-my-claudecode:cancel

# 启动新模式
ralph: continue the task

状态持久化

模式状态保存在 .omc/state/：

# 查看当前状态
omc status

# 恢复上次任务
omc resume

性能对比

典型任务耗时对比

资源消耗

小结

选择正确的编排模式能大幅提升效率：

关键要点

• ✅ 根据任务类型选择模式
• ✅ 组合使用获得最佳效果
• ✅ 注意资源消耗和成本
• ✅ 理解各模式的验证强度

系列导航：

• ← 上一篇：教程 3：tmux CLI Workers 多 AI 协作
• → 下一篇：教程 5：Magic Keywords 与 Deep-Interview
• 返回：教程系列索引