omc-teams

OMC Teams スキル

tmux ペインで N 個の CLI ワーカープロセスを起動し、タスクを並列に実行します。claude、codex、gemini、antigravity、grok、cursor のエージェントタイプに対応しています。Cursor ワーカーは実行者スタイルのタスクのみを対象とします。

/omc-teams は、CLI ファーストのランタイム向けのレガシー互換スキルです。非推奨の MCP ランタイムツールではなく、omc team ... コマンドを使用してください。

使用方法

/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、Gemini CLI の後継となる Google の CLI）、grok（xAI Grok CLI）、または cursor（Cursor エージェント 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 サーフェスは任意です（$TMUX が設定されていない場合に CMUX_SURFACE_ID を設定）。通常のターミナルでは、引き続きデタッチされた tmux にフォールバックします。
• claude CLI：通常のユーザーインストールではレガシーの Anthropic npm パッケージのインストール方法は非推奨です。公式セットアップ手順に従って Claude Code をインストールし、認証してください。
• codex CLI：npm install -g @openai/codex
• gemini CLI：npm install -g @google/gemini-cli（エンタープライズ／API キー向けプラン）
• antigravity CLI：公式手順に従ってインストールしてください（agy バイナリがインストールされます）。agy --version で確認してください。Gemini CLI の後継となる Google の 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 — タスクの説明

タスクを分割したり実行したりする前に、次の項目を検証してください。

• サポートされていないエージェントタイプは、最初に拒否してください。/omc-teams がサポートするのは claude、codex、gemini、antigravity、grok、cursor のみです。
• Cursor ワーカーは実行者スタイルのみとして扱ってください。N:cursor と N:cursor:executor は受け付けます。レビュー担当、批評担当、セキュリティレビュー担当、判定、最終承認の作業は拒否するか、ネイティブの Claude／OMC レビュー担当エージェントに割り当て直してください。
• ユーザーが expert などのサポートされていないタイプを求めた場合は、/omc-teams が外部 CLI ワーカーのみを起動することを説明してください。
• ネイティブの Claude Code チームエージェント／ロールを使用する場合は、代わりに /oh-my-claudecode:team を案内してください。

フェーズ 2：タスクの分割

書き込みの競合を避けるため、作業を N 個の独立したサブタスクに分割してください（ファイル単位または関心事単位）。

Phase 2.5: 複数リポジトリの計画でワークスペースのルートを解決する

omc team は、すべてのワーカーを共通の作業ディレクトリで起動します。単一リポジトリのタスクでは、通常、現在のリポジトリで問題ありません。複数リポジトリにまたがるタスク、特に計画が1つのリポジトリにあり、実装対象が兄弟リポジトリにある場合は、起動前に作業ディレクトリを解決してください。

• タスクで、あるリポジトリ内の計画アーティファクト（例：tool/.omc/plans/task-1200-gwd-gifs.md）と、兄弟リポジトリ内の対象パス（例：api/ と admin/）が指定されている場合は、関係するすべてのリポジトリを含む共通のワークスペースルート（例：親ディレクトリの inter/）を選択します。
• --cwd によって起動ディレクトリが変わってもワーカーが計画を見つけられるよう、タスク文では絶対パスの計画パスを使用します。
• タスク文とサブタスクに、リポジトリのパスまたは名前を明記します。
• 対象リポジトリが兄弟リポジトリの場合、起動時の cwd を .omc/plans/... があるリポジトリだけに設定しないでください。そうすると、codex、claude、gemini、antigravity、grok、cursor のワーカーが実装ワークスペースではなく計画リポジトリに取り残されます。
• 安全な共通ワークスペースルートを特定できない場合は、/omc-teams を起動しないでください。単一 cwd の制約を説明し、意図するワークスペースルートを尋ねるか、根拠から判断してください。

Phase 3: CLI チームランタイムを開始する

モード状態を有効にします（推奨）。

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

CLI からワーカーを起動します。

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

Phase 2.5 で解決した複数リポジトリのケースでは、既存の --cwd の仕様に従い、共通のワークスペースルートから起動し、計画への参照には絶対パスを使用します。

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

チーム名は、タスク文から生成されたスラッグがデフォルトで使用されます（例：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

ペインの出力にコマンドが送信されたことが示されない限り、チームの起動が成功したと報告しないでください。

Phase 4: モニタリングとライフサイクル API

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

タスクの引き受け、タスクの状態遷移、メールボックスへの配信、ワーカー状態の更新には、omc team api ... を使用します。

Phase 5: シャットダウン（必要な場合のみ）

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

意図的なキャンセルや古い状態のクリーンアップにはシャットダウンを使用します。まずは強制しないシャットダウンを優先してください。

Phase 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	指定されたエージェントは claude/codex/gemini/antigravity/grok/cursor のいずれでもありません	claude、codex、gemini、antigravity、grok、cursor のいずれかを使用してください。ネイティブの Claude Code エージェントには /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 の暗黙的なエージェントチームのメンバー	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 ネイティブのセッション内エージェントオーケストレーションを使用したい場合	外部 CLI ワーカーの実行を使用したい場合