content/04-ai-programming/omc-modes-guide.md

OMC 使用

定位

OMC 可以理解成一个多 Agent 研发编排系统。它的重点不是“能不能写代码”,而是用不同模式组织需求、实现、验证和人工介入。


第一部分:模式边界总览

这是最先要看的部分。先判断模式边界,再选具体模式。

维度手动模式AutopilotTeamRalphUltrawork
主导方式人主导单 Agent 主导多 Agent 协作自动闭环主导并行任务主导
需求处理人工澄清自动初判自动拆解自动拆解自动拆分
方案设计按任务而定
编码实现
测试验证很高中高
自动修复很高
多角色协作中强
并行能力低到中很高
人工控制力很高中低

快速结论

  • 要控制感,用手动模式
  • 要快速出一版,用 Autopilot
  • 要分工协作,用 Team
  • 要闭环验证,用 Ralph
  • 要批量并行,用 Ultrawork

第二部分:模式详解

1. 手动模式

模式定义

你逐步驱动,Agent 负责响应和执行。

核心能力

  • 精细修改
  • 调试和 review
  • 人工控制节奏和范围

流程图

flowchart TD
    A[人工输入任务] --> B[Agent 分析当前问题]
    B --> C[Agent 给出方案或直接修改]
    C --> D[人工检查结果]
    D -->|继续| E[人工追加指令]
    E --> B
    D -->|结束| F[人工提交或收口]

自动 / 人工节点

节点执行方
问题理解自动
局部代码修改自动
是否继续下一步人工
是否扩大任务范围人工
是否接受结果人工
commit / push人工

适用判断

适合小改动、探索和需求未定的任务。


2. Autopilot

模式定义

单 Agent 顺序执行,从理解到实现再到基础验证。

核心能力

  • 自动理解任务
  • 自动编码
  • 自动跑基础测试
  • 自动修复常规错误

适用场景

  • 新增一个明确功能
  • 修一个边界清晰的 bug
  • 做 PoC 或快速验证

流程图

flowchart TD
    A[人工下达目标] --> B[Autopilot 理解任务]
    B --> C[生成实现方案]
    C --> D[编码实现]
    D --> E[运行测试或构建]
    E --> F{是否通过}
    F -->|否| G[自动修复]
    G --> D
    F -->|是| H[输出结果给人工]
    H --> I[人工验收与收口]

自动 / 人工节点

节点执行方
需求初步理解自动
方案草拟自动
编码实现自动
基础测试 / 构建自动
常规报错修复自动
判断需求是否偏了人工
最终验收人工
commit / push人工

适用判断

适合边界清晰的单功能开发或 bug 修复。


3. Team 模式

模式定义

多 Agent 按角色分工,形成规划、实现、验证流水线。

核心能力

  • 多角色协同
  • 方案、实现、验证分离
  • 适合中等复杂任务

典型角色

  • planner:拆任务、排步骤
  • architect:给结构方案
  • executor:编码实现
  • verifier / reviewer:测试、检查、验证

流程图

flowchart TD
    A[人工输入目标] --> B[Planner 拆解任务]
    B --> C[Architect 产出实现方案]
    C --> D[Executor 编码实现]
    D --> E[Verifier 测试验证]
    E --> F[Reviewer 审查结果]
    F --> G{是否通过}
    G -->|否| H[回到 Executor 修复]
    H --> E
    G -->|是| I[人工验收]

自动 / 人工节点

节点执行方
任务拆解自动
技术方案自动
代码实现自动
测试验证自动
代码审查自动
判断目标是否拆对人工
判断方案是否符合业务人工
最终验收与合并人工

适用判断

适合跨文件、跨模块、需要角色分工的任务。


4. Ralph 模式

模式定义

自动执行后持续验证,不通过就回环修复。

核心能力

  • 自动执行
  • 自动验证
  • 自动诊断失败
  • 自动回环修复

适用场景

  • 改动风险高
  • 测试要求高
  • 你希望它尽量自修复,不要每一步都停下来问你

流程图

flowchart TD
    A[人工下达完整目标] --> B[自动规划与执行]
    B --> C[自动测试与验证]
    C --> D{是否满足完成条件}
    D -->|否| E[自动诊断失败原因]
    E --> F[自动修复]
    F --> C
    D -->|是| G[提交候选结果]
    G --> H[人工最终验收]

自动 / 人工节点

节点执行方
任务执行自动
测试运行自动
失败诊断自动
回环修复自动
完成证据整理自动
判断验收标准是否合理人工
死循环 / 误修复时介入人工
最终上线决策人工

适用判断

适合高风险改动和强验证任务。


5. Ultrawork

模式定义

把多个相对独立的任务并行推进。

核心能力

  • 并行执行多个子任务
  • 后台管理长任务
  • 高吞吐处理
  • 适合批量任务

适用场景

  • 一批独立 bug 修复
  • 多文件批量调整
  • 多项检查 / 生成任务并行跑

流程图

flowchart TD
    A[人工输入批量目标] --> B[系统拆成多个独立任务]
    B --> C1[任务1自动执行]
    B --> C2[任务2自动执行]
    B --> C3[任务3自动执行]
    C1 --> D[汇总结果]
    C2 --> D
    C3 --> D
    D --> E[人工统一验收]

自动 / 人工节点

节点执行方
子任务拆分自动
并行执行自动
后台任务管理自动
结果汇总自动
判断任务之间是否真独立人工
冲突处理人工
最终收口人工

适用判断

适合批量、独立、可并行的任务。


第三部分:上手顺序

如果你现在正在实际使用 OMC,建议按这个顺序理解和上手:

  1. 先掌握手动模式,理解 OMC 的基本行为边界
  2. 再用 Autopilot,体验单 Agent 自动开发
  3. 然后用 Team,理解多 Agent 分工
  4. 再使用 Ralph,理解闭环验证
  5. 最后再上 Ultrawork,处理批量并行任务

原因很简单:先理解单 Agent,再理解多 Agent,最后再理解闭环与并行。


第四部分:选型建议

场景优先模式
明确 bug 修复Autopilot
中等复杂新功能Team
高风险重构Ralph
批量独立任务Ultrawork
需求还没想清楚手动模式

第五部分:自动化边界

适合自动化的节点

  • 任务拆解
  • 方案草拟
  • 编码实现
  • 测试执行
  • 常规修复
  • 初步 review

必须人工把关的节点

  • 需求方向
  • 业务优先级
  • 范围变更
  • 修复副作用
  • 最终合并与发布

第六部分:推荐工作流

如果你是日常开发,不建议一上来就全自动。更稳妥的流程是:

flowchart TD
    A[人工描述目标] --> B[手动模式澄清需求]
    B --> C[选择合适模式]
    C -->|简单明确| D[Autopilot]
    C -->|中型复杂| E[Team]
    C -->|高风险闭环| F[Ralph]
    C -->|批量并行| G[Ultrawork]
    D --> H[人工验收]
    E --> H
    F --> H
    G --> H
    H --> I[人工 commit / merge / release]

第七部分:一句话总结

OMC 的模式选择,本质上是在回答三件事:谁主导、要不要闭环验证、要不要并行处理。

评论