ohmg

ohmg — ベンダー横断で使えるポータブルなマルチエージェントハーネス（oh-my-agent v10.4.1）

このスキルを使う場面

• oh-my-agent を、あらゆる AI IDE で使えるポータブルなマルチエージェントハーネスとして採用したい場合
• Claude Code、Codex、Gemini、Antigravity、Cursor、Grok Build、Kimi Code、OpenCode、Pi、Qwen Code、Reasonix、Amp、GitHub Copilot、Kiro CLI に展開できる、単一の**.agents/ を信頼できる唯一の情報源**として使いたい場合
• どのランタイムでも Claude の /team、/autopilot、/ultrawork、/ultraqa に相当する OMA の機能が必要な場合
• ランタイム間で一貫性を保てる、専門分野のエージェント（フロントエンド、バックエンド、アーキテクチャ、QA、PM、DB、モバイル、インフラ、デバッグ、デザインなど）が必要な場合
• ネイティブの生成済みエージェントファイルを使う場面と、oma agent:spawn によるフォールバックが必要な場面を説明する必要がある場合
• Claude 優先のフルスタック（omc）や Codex 優先のフルスタック（omx）に縛られず、ベンダーに依存しないハーネスの使い方をしたい場合

手順

ステップ 1：ランタイムと希望する管理モデルを特定する

ユーザーが次のどれを実際に求めているかを判断します。

1. ポータブルなハーネスを優先 — サポート対象のあらゆるランタイムに展開できる、単一の .agents/ を信頼できる唯一の情報源として使いたい
2. 特定のランタイムを優先 — メインの IDE は決まっているが、OMA によるマルチエージェント対応が必要
3. 代わりに Claude Code のネイティブ機能を使う — omc に案内する
4. 代わりに Codex CLI のネイティブ機能を使う — omx に案内する

リクエストがClaude Code ネイティブのオーケストレーションに関するものであれば、omc に案内します。 リクエストがCodex CLI ネイティブのオーケストレーションに関するものであれば、omx に案内します。 ユーザーがベンダー横断で使えるポータブルなハーネスを求めている場合、またはランタイムが Claude Code でも Codex でもない場合は、ohmg を使います。

ステップ 2：現在のアップストリームの基本概念を説明する

ohmg は、現在のアップストリームの構成に沿って説明します。

• 製品／ランタイム名：oh-my-agent
• 一般的な CLI：oma / oh-my-agent
• 信頼できる唯一の情報源：プロジェクト内の .agents/
• ネイティブに生成されるベンダー別ビュー：
  • .gemini/agents/*.md
  • .claude/agents/*.md
  • .codex/agents/*.toml
• ディスパッチのルール：
  • 同一ベンダーのランタイム → ネイティブに生成されたベンダー別エージェントファイルを優先
  • ベンダー横断のタスク → oma agent:spawn / oma agent:parallel にフォールバック

古い oh-my-ag という名称、/coordinate、.agent/skills/ のパスから説明を始めないでください。

ステップ 3：適切なインストール／ブートストラップ方法を案内する

Gemini CLI／汎用的なポータブル設定

# one-liner installer (macOS/Linux)
curl -fsSL https://raw.githubusercontent.com/first-fluke/oh-my-agent/main/cli/install.sh | bash

# or launch directly
bunx oh-my-agent@latest

# or install globally
bun install --global oh-my-agent

インストール後、対話形式の oma フローを使ってプリセットを選び、プロジェクトローカルのハーネスを生成します。

便利な運用者向けコマンド：

oma doctor
oma link
oma dashboard
oma dashboard:web

インストールに制約がある場合

対話形式のセットアップが適切でない場合は、手動での手順を説明します。

1. .agents/ をプロジェクトに配置する
2. oma link を実行して、ランタイム固有のビューを再生成する
3. 生成された Gemini／Claude／Codex のファイルが、想定された場所にあることを確認する

ステップ 4：Gemini ネイティブと Antigravity の動作の違いを正しく説明する

Gemini CLI の場合

ランタイムのベンダーが対象のベンダーと一致する場合、Gemini は .gemini/agents/*.md の生成済みネイティブエージェントファイルを使用できます。

次の方針で説明します。

• .agents/ を正規の情報源として維持する
• .gemini/agents/*.md を生成／更新する
• 可能な場合は、Gemini にネイティブの生成済みエージェント定義を使用させる

Antigravity の場合

Antigravity は .agents/agents/ を直接使用できますが、Gemini／Claude／Codex のランタイムと同じようなカスタムサブエージェントの生成には対応していません。

次の方針で説明します。

• Antigravity はハーネスのポータブルな利用先である
• Gemini ネイティブのマルチエージェント生成機能と同等であるかのように誇張しない
• タスクで明示的なベンダー横断処理やカスタム生成の動作が必要な場合は、Antigravity がネイティブに担えるかのように説明せず、代わりに CLI／ランタイムのフォールバック方法を案内する

ステップ 5：実際のワークフローの使い方を示す

現在の oh-my-agent のドキュメントに沿った、上流のワークフロー用語を使用します。

• /plan — PM によるタスクの分解と、API コントラクトを重視した計画
• /work — 段階ごとの承認を挟むマルチエージェント実行
• /orchestrate — CLI ベースの並列エージェント実行
• /ultrawork — より高い品質を重視するワークフロー
• /review — セキュリティ／パフォーマンス／アクセシビリティのレビュー
• /debug — 構造化されたデバッグ
• /scm — SCM および Git ワークフローのサポート

便利な CLI の例：

oma agent:spawn backend "Build auth API" session-01
oma agent:parallel -i backend:"Auth API" frontend:"Login form"
oma dashboard
oma dashboard:web

これらは 移植可能なハーネスの例として使用し、すべてのランタイムで同じネイティブ UI が使えるという保証として扱わないでください。

ステップ 5.5：Claude の team／autopilot／ultrawork／ultraqa を OMA に対応付ける

ユーザーが Claude OMC のワークフローを Gemini または Antigravity に導入したい場合は、references/parallel-quality-workflows.md を読んでください。

Claude / OMC の意図	OMA / Gemini の形式	Antigravity の制約
/team N:role "task"	/orchestrate "task" または oma agent:parallel -i role:"task"	Antigravity は .agents/agents/ を利用できますが、明示的な起動には OMA CLI によるフォールバックが必要な場合があります
/autopilot "task" または autopilot: task	/plan "task" の後に /work を実行します。作業を明示的なレーンに分割する必要がある場合に限り、/orchestrate を使用します	Antigravity は生成されたハーネスに従えますが、ローカルの投影で利用可能になっていない限り、ネイティブな Claude 形式の /autopilot コマンドを約束しないでください
/ultrawork "task"	/ultrawork "task" または独立したレーンを使った oma agent:parallel	.agents/ を正規のソースとして維持し、oma link でビューを再生成します
/ultraqa "target"	/review "target" または QA／セキュリティ／パフォーマンスのレーンを使った /ultrawork "QA target"	ローカルの投影で利用可能になっていない限り、ネイティブな /ultraqa コマンドを約束しないでください

ステップ 6：ベンダー間の質問には、明確な制約を示して対応する

次の振り分け方針を使用します。

• ohmg を使用するケース：

  • oh-my-agent の Gemini CLI セットアップ
  • Antigravity との互換性
  • .agents/ の正規ソース構造
  • Gemini ネイティブの生成エージェント
  • ベンダーごとのランタイムレイヤーを選ぶ前に導入する、移植可能なハーネス

• omc を使用するケース：

  • Claude Code のプラグイン／セッション内オーケストレーション
  • /team、/autopilot、/ralph、/ccg、または Claude を第一とするランタイム操作

• omx を使用するケース：

  • $deep-interview、$autopilot、$ralplan、$team、$ralph などの Codex CLI ワークフロースキル
  • .omx/ のランタイム状態と、Codex を第一とするオーケストレーションの動作

ユーザーが、後から Gemini ＋ Claude ＋ Codex にも利用できる 単一の移植可能なハーネスを求める場合は、ohmg を基盤とし、omc／omx は .agents/ の正規ソースの代替ではなく、下流のベンダー優先レイヤーとして案内してください。

ステップ 7：よくある設定のずれをトラブルシューティングする

まず、次の点を確認してください。

1. 製品名の誤り — 古い oh-my-ag ではなく、oh-my-agent／oma を使用します
2. 正規ソースのパスの誤り — レガシーの .agent/ ではなく、.agents/ を優先します
3. 生成ファイルが古い、または不足している — oma link を再実行します
4. 環境の不一致 — Gemini ネイティブの動作と Antigravity の機能は異なります
5. モニタリングに関する混乱 — ダッシュボードはエージェント／メモリの動作を監視するものであり、オーケストレーションモデル全体を表すものではありません
6. 複数ベンダーにまたがる期待の不一致 — ネイティブなディスパッチでタスクを実行できない場合は、oma agent:spawn／oma agent:parallel を説明します
7. Claude ワークフローとの同等性に関する混乱 — team、autopilot、ultrawork、ultraqa は、同一のコマンド実装ではなく、ワークフロー上の意図として対応付けます

例

例 1：Gemini CLI の導入

ユーザー：「Gemini CLI 用に oh-my-agent をセットアップしてください。」

回答： ohmg を使います。oh-my-agent をインストールし、.agents/ を信頼できる唯一の情報源として維持したうえで、実行環境のベンダーが一致する場合に Gemini が .gemini/agents/*.md を使えるよう、Gemini ネイティブのエージェントファイルを再生成します。まずは curl -fsSL https://raw.githubusercontent.com/first-fluke/oh-my-agent/main/cli/install.sh | bash または bunx oh-my-agent@latest を実行し、その後 oma doctor と oma link を実行するとよいでしょう。

例 2：Antigravity との互換性

ユーザー：「Gemini と同じマルチエージェント構成を Antigravity に使わせたいです。」

回答： ohmg を使います。ただし、機能の境界を明確に説明してください。Antigravity は同じポータブルハーネスの .agents/agents/ を利用できますが、Gemini ネイティブや CLI フォールバック経由の場合と同じ方法でカスタムサブエージェントを起動することには対応していません。.agents/ を正規の情報源として維持し、Antigravity は互換性のある利用先として使ってください。

例 3：後から Claude／Codex に処理を振り分けるポータブルハーネス

ユーザー：「今は Gemini ネイティブのエージェントが必要ですが、後で Claude や Codex に処理を振り分けるかもしれません。」

回答： ohmg が適切な基盤です。まず oh-my-agent と .agents/ をプロジェクト内の信頼できる唯一の情報源として使います。今は Gemini に生成されたネイティブのエージェントファイルを使わせ、後から同じハーネスを .claude/agents/ または .codex/agents/ に反映します。後で Claude を優先する実行時オーケストレーションが必要になった場合は、その実行時の詳細について omc を案内してください。Codex を優先するワークフローのスキルが必要な場合は、omx を案内してください。

例 4：ohmg、omc、omx の選択

ユーザー：「ohmg、omc、omx のどれを使うべきですか？」

回答： .agents/ を中心とする、Gemini／Antigravity と互換性のあるポータブルハーネスを主な目的とする場合は ohmg を使います。Claude を優先するオーケストレーションには omc、Codex を優先するオーケストレーションには omx を使います。ohmg はポータブルハーネスの導入向けで、omc と omx はベンダーを優先する実行時オーバーレイです。

ベストプラクティス

1. 現在のアップストリームの名称を使う — oh-my-agent／oma を使い、oh-my-ag は使わないでください
2. .agents/ を正規の情報源として維持する — 生成される Gemini／Claude／Codex 向けの構成は、ここから派生させてください
3. まず同じベンダーのネイティブなディスパッチを優先する — ベンダー／実行環境の不一致によって必要な場合に限り、CLI による起動に切り替えてください
4. Antigravity の制限を明確に伝える — 互換性はありますが、Gemini ネイティブのカスタムサブエージェントの動作と同一ではありません
5. ベンダー優先の実行時に関する質問を適切に案内する — Claude を優先する実行時の詳細は omc に、Codex を優先する実行時の詳細は omx に案内してください
6. 構成を変更したら oma link を実行する — 古い生成済みファイルは、混乱のよくある原因です
7. ダッシュボードは可観測性を補助するものとして扱う — ワークフローを支援しますが、ワークフローそのものではありません
8. QA の対応付けは慎重に行う — OMA の /review または /ultrawork で ultraqa の意図を満たせる場合がありますが、そのワークフローがローカルに存在するときだけ /ultraqa と呼んでください

参考資料

• インストール、構成、生成されるファイル
• 実行時の境界：Gemini と Antigravity と OMC／OMX
• ワークフローとコマンドのパケット
• 並列処理と品質ワークフロー
• アップストリームの README
• 対応エージェントの一覧