omc-teams

OMC Teams 技能

在 tmux 窗格中启动 N 个 CLI 工作者进程，以并行执行任务。支持 claude、codex、gemini、antigravity、grok 和 cursor Agent 类型。Cursor 工作者仅支持执行器风格的任务。

/omc-teams 是用于兼容旧版 CLI 优先运行时的技能：请使用 omc team ... 命令（而不是已弃用的 MCP 运行时工具）。

用法

/oh-my-claudecode:omc-teams N:claude "task description"
/oh-my-claudecode:omc-teams N:codex "task description"
/oh-my-claudecode:omc-teams N:gemini "task description"
/oh-my-claudecode:omc-teams N:antigravity "task description"
/oh-my-claudecode:omc-teams N:grok "task description"
/oh-my-claudecode:omc-teams N:cursor "implementation task description"

参数

• N —— CLI 工作者数量（1-10）
• agent-type —— 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 Agent CLI；仅适用于执行器风格的任务）
• 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"

要求

• 运行时必须已安装并可找到 tmux 二进制文件（command -v tmux）；从普通终端运行时如此。经典 tmux 会话会复用当前 tmux 界面。
• cmux 界面为可选项，可用于原生原位拆分（设置 CMUX_SURFACE_ID 且未设置 $TMUX）。普通终端仍会使用分离式 tmux 回退方式。
• claude CLI：按照官方设置说明安装并验证 Claude Code；旧版 Anthropic npm 包安装方式不再建议用于普通用户安装。
• codex CLI：npm install -g @openai/codex
• gemini CLI：npm install -g @google/gemini-cli（企业/API 密钥版本）
• antigravity CLI：按照官方说明安装（提供 agy 二进制文件）——使用 agy --version 验证；这是 Google 推出的 Gemini CLI 后继产品
• grok CLI：安装并验证你的环境所使用的 Grok CLI
• cursor CLI：安装并验证 cursor-agent；如果不可用，请说明此设置要求，而不要悄悄回退到仅使用 Claude 执行

工作流

阶段 0：验证前置条件

在声称缺少 tmux 之前，先检查当前使用的多路复用器。如果 $TMUX 和 CMUX_SURFACE_ID 均为空，请明确检查 tmux：

command -v tmux >/dev/null 2>&1

• 如果普通终端的 tmux 检查失败，请说明 未安装 tmux 并停止。
• 如果设置了 $TMUX，omc team 可以直接复用当前 tmux 窗口/窗格。
• 如果 $TMUX 为空但设置了 CMUX_SURFACE_ID，请说明用户正在 cmux 中运行。不要说缺少 tmux，也不要说用户「不在 tmux 中」；omc team 会为工作者创建 原生 cmux 分屏。
• 如果 $TMUX 和 CMUX_SURFACE_ID 均未设置，请说明用户正在 普通终端 中运行。omc team 仍可启动 分离式 tmux 会话，但如果用户明确需要原位窗格/窗口布局，应先从经典 tmux 会话启动。
• 如果需要确认当前 tmux 会话，请使用：

tmux display-message -p '#S'

阶段 1：解析并验证输入

提取：

• N —— 工作者数量（1-10）
• agent-type —— claude|codex|gemini|grok|cursor
• task —— 任务描述

在拆分任务或运行任何内容之前进行验证：

• 预先拒绝不支持的 Agent 类型。/omc-teams 仅支持 claude、codex、gemini、antigravity、grok 和 cursor。
• Cursor 工作者仅视为执行器风格。接受 N:cursor 和 N:cursor:executor；对于审查者、批评者、安全审查者、裁决或最终批准工作，应拒绝或改为使用原生 Claude/OMC 审查者 Agent。
• 如果用户要求使用 expert 等不受支持的类型，请说明 /omc-teams 仅启动外部 CLI 工作者。
• 如需使用原生 Claude Code 团队 Agent/角色，请引导用户改用 /oh-my-claudecode:team。

阶段 2：拆分任务

将工作拆分为 N 个相互独立的子任务（按文件或关注点划分），以避免写入冲突。

第 2.5 阶段：为多仓库计划确定工作区根目录

omc team 会使用同一个工作目录启动所有工作器。对于单仓库任务，当前仓库通常是正确的。对于多仓库任务，尤其是计划位于一个仓库，但实现涉及同级仓库的情况，请在启动前确定工作目录：

• 如果任务引用了某个仓库下的计划文件（例如 tool/.omc/plans/task-1200-gwd-gifs.md），同时目标路径位于同级仓库（例如 api/ 和 admin/），请选择包含所有相关仓库的共享工作区根目录（例如父级 inter/ 目录）。
• 在任务文本中使用绝对计划路径，这样即使 --cwd 更改了启动目录，工作器仍能找到计划。
• 在任务文本和子任务中明确写出仓库路径或仓库名称。
• 如果目标仓库是同级仓库，请勿将启动 cwd 固定为仅包含 .omc/plans/... 的仓库；否则，codex、claude、gemini、antigravity、grok 和 cursor 工作器会留在计划所在仓库，而不是实现工作区中。
• 如果无法确定安全的共享工作区根目录，请勿启动 /omc-teams。 请说明单一 cwd 的限制，并询问预期的工作区根目录，或根据现有证据推断该目录。

第 3 阶段：启动 CLI 团队运行时

激活模式状态（推荐）：

state_write(mode="team", current_phase="team-exec", active=true)

通过 CLI 启动工作器：

omc team <N>:<claude|codex|gemini|antigravity|grok|cursor> "<task>"

对于在第 2.5 阶段确定的多仓库情况，请从共享工作区根目录启动，遵循现有的 --cwd 约定，并保留绝对计划引用：

omc team <N>:<claude|codex|gemini|antigravity|grok|cursor> "<task with absolute plan path and explicit repo paths>" --cwd <workspace-root>

团队名称默认根据任务文本生成 slug（例如：review-auth-flow）。

启动后，请确认命令确实已执行，不要假设按下 Enter 键就会执行。检查窗格输出，并确认命令或工作器引导文本出现在窗格历史记录中：

tmux list-panes -a -F '#{session_name}:#{window_index}.#{pane_index} #{pane_id} #{pane_current_command}'
tmux capture-pane -pt <pane-id> -S -20

除非窗格输出显示命令已提交，否则不要声称团队已成功启动。

第 4 阶段：监控 + 生命周期 API

omc team status <team-name>
omc team api list-tasks --input '{"team_name":"<team-name>"}' --json

使用 omc team api ... 进行任务认领、任务状态转换、邮箱投递和工作器状态更新。

第 5 阶段：关闭（仅在需要时）

omc team shutdown <team-name>
omc team shutdown <team-name> --force

在需要主动取消或清理过期状态时使用关闭功能。优先尝试非强制关闭。

第 6 阶段：报告 + 关闭状态

报告任务结果，概述完成或失败情况以及任何遗留风险。

state_write(mode="team", current_phase="complete", active=false)

已弃用的运行时说明

旧版 MCP 运行时工具已弃用，不再用于执行：

• omc_run_team_start
• omc_run_team_status
• omc_run_team_wait
• omc_run_team_cleanup

如果遇到这些工具，请改用 omc team ... CLI 命令。

错误参考

错误	原因	解决方法
not inside tmux	在非 tmux 环境中请求了原地窗格拓扑	启动 tmux 并重新运行，或让 omc team 使用其分离会话回退方案
cmux surface detected	在没有 $TMUX 的情况下运行于 cmux 中	使用常规的 omc team ... 流程；OMC 会创建原生 cmux 工作进程分屏
Unsupported agent type	请求的 Agent 不是 claude/codex/gemini/antigravity/grok/cursor	使用 claude、codex、gemini、antigravity、grok 或 cursor；若要使用原生 Claude Code Agent，请使用 /oh-my-claudecode:team
codex: command not found	未安装 Codex CLI	npm install -g @openai/codex
gemini: command not found	未安装 Gemini CLI	npm install -g @google/gemini-cli（企业版/API 密钥层级）
agy: command not found	未安装 Antigravity CLI	按照官方说明安装
Team <name> is not running	运行时状态过期或缺失	执行 omc team status <team-name>，若状态过期，再执行 omc team shutdown <team-name> --force
status: failed	工作进程退出，未完成工作	检查运行时输出，缩小范围，然后重新运行

与 /team 的关系

方面	/team	/omc-teams
工作进程类型	Claude Code 隐式 Agent 团队成员	在 tmux 中运行的 claude / codex / gemini / antigravity CLI 进程
调用方式	使用不同 name 值启动 Agent/Task；Claude Code 2.1.178+ 中没有 TeamCreate/TeamDelete	omc team [N:agent] + status + shutdown + api
协调方式	原生隐式团队消息传递和分阶段流水线	tmux 工作进程运行时 + CLI API 状态文件
适用场景	希望在会话中使用 Claude 原生 Agent 编排	希望执行外部 CLI 工作进程