用途
omc-teams 是一个 CLI 团队运行时技能,用于在 tmux 窗格中启动 N 个 CLI 工作进程,并行执行任务。它面向需要基于进程的并行执行的场景,支持 claude、codex、gemini、antigravity、grok 和 cursor 六种代理类型。其中 cursor 工作进程仅支持执行器风格任务。
该技能是 CLI 优先运行时的旧版兼容技能,应使用 omc team ... 命令,而非已弃用的 MCP 运行时工具。
主要能力
- 在 tmux 窗格中并行启动 1-10 个 CLI 工作进程。
- 支持多种代理类型:claude(Claude CLI)、codex(OpenAI Codex CLI)、gemini(Google Gemini CLI,企业/API 密钥层级)、antigravity(Antigravity CLI agy,Google 对 Gemini CLI 的继任者)、grok(xAI Grok CLI)、cursor(Cursor 代理 CLI,仅执行器风格任务)。
- 将任务拆分为 N 个独立子任务(按文件或关注点划分),避免写入冲突。
- 提供团队状态查询、任务认领、任务状态转换、邮箱投递和工作进程状态更新等生命周期 API。
- 支持多仓库计划的工作区根目录解析,通过 --cwd 指定共享工作区根目录。
使用方式
调用格式:
/oh-my-claudecode:omc-teams N:agent-type "task description"
参数:
- N:CLI 工作进程数量(1-10)。
- agent-type:claude、codex、gemini、antigravity、grok 或 cursor。
- task:要分发到所有工作进程的任务描述。
示例:
/omc-teams 2:claude "implement auth module with tests" /omc-teams 2:codex "review the auth module for security issues" /omc-teams 3:gemini "redesign UI components for accessibility" /omc-teams 3:antigravity "redesign UI components for accessibility" /omc-teams 1:grok "prototype an implementation approach" /omc-teams 1:cursor "apply the implementation plan"
CLI 启动命令:
omc team <N>:<claude|codex|gemini|antigravity|grok|cursor> "<task>"
多仓库场景:
omc team <N>:<agent> "<task with absolute plan path and explicit repo paths>" --cwd <workspace-root>
生命周期命令:
omc team status <team-name> omc team api list-tasks --input '{"team_name":"<team-name>"}' --json omc team shutdown <team-name> omc team shutdown <team-name> --force
工作流程
- 阶段 0:验证前置条件。检查当前多路复用器,确认 tmux 是否可用;若 $TMUX 已设置可直接复用当前 tmux 窗口/窗格;若 $TMUX 为空但 CMUX_SURFACE_ID 已设置,则运行在 cmux 中,OMC 会创建原生 cmux 分割;若两者均未设置,则为普通终端,omc team 仍可启动分离的 tmux 会话。
- 阶段 1:解析并验证输入。提取 N、agent-type、task,拒绝不支持的代理类型,cursor 仅限执行器风格任务。
- 阶段 2:分解任务为 N 个独立子任务。
- 阶段 2.5:为多仓库计划解析工作区根目录,使用绝对计划路径,并在任务文本中包含明确的仓库路径。
- 阶段 3:启动 CLI 团队运行时,激活模式状态并启动工作进程,验证命令确实执行。
- 阶段 4:监控与生命周期 API。
- 阶段 5:关闭(仅在需要时),优先使用非强制关闭。
- 阶段 6:报告并关闭状态。
适用场景
- 需要基于进程的并行执行,将任务分发到多个外部 CLI 工作进程。
- 希望使用 Claude 之外的外部 CLI(如 codex、gemini、antigravity、grok、cursor)执行任务。
- 需要 tmux 窗格拓扑进行并行工作。
- 多仓库实现任务,需要共享工作区根目录。
限制
- 需要安装 tmux 二进制文件(普通终端场景)。
- 各 CLI 需单独安装并认证:codex 使用 npm install -g @openai/codex;gemini 使用 npm install -g @google/gemini-cli(企业/API 密钥层级);antigravity 按官方说明安装(提供 agy 二进制);grok 需安装并认证环境所用的 Grok CLI;cursor 需安装并认证 cursor-agent。
- cursor 工作进程仅支持执行器风格任务,不接受审查者、批评者、安全审查、裁决或最终批准类工作。
- 不支持 expert 等类型,/omc-teams 仅启动外部 CLI 工作进程;原生 Claude Code 团队代理/角色应使用 /oh-my-claudecode:team。
- 所有工作进程使用一个共享工作目录。
- 旧版 MCP 运行时工具(omc_run_team_start、omc_run_team_status、omc_run_team_wait、omc_run_team_cleanup)已弃用,应改用 omc team ... CLI 命令。
与 /team 的关系
/team 使用 Claude Code 隐式代理团队队友,通过 Agent/Task 生成,使用原生隐式团队消息和分阶段流水线;/omc-teams 使用 tmux 中的 claude/codex/gemini/antigravity CLI 进程,通过 omc team [N:agent] + status + shutdown + api 调用,使用 tmux 工作进程运行时 + CLI API 状态文件。前者适用于 Claude 原生会话内代理编排,后者适用于外部 CLI 工作进程执行。