OpenCode oh-my-openagent 使用チュートリアル

Oh My OpenAgent（略称OmO）はオープンソースのAIプログラミングアシスタント拡張プラグインで、前身はoh-my-opencode。

oh-my-openagent はOpenCodeというAIプログラミングツール上で動作し、それを11人の専門AI Agentからなる開発チームに変えます。

一言で説明すると：

あなたが要件を送る → OmO が複数のAIを自動的にスケジュールして並行作業 → 単一のAIより数倍速い

現在GitHubでは54k+ Starsを獲得しており、最も人気のあるOpenCodeプラグインです。

インストール

以下のプロンプトをあなたのLLMツール（OpenCode、Claude Code、AmpCode、Cursor など）にコピー＆ペーストしてください：

按照此链接说明安装并配置 oh-my-opencode：https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/refs/heads/dev/docs/guide/installation.md

実行すると自動でインストールされます。インストール中にAPIキーの設定オプションが表示される場合がありますが、設定しても設定しなくても構いません：

11人のAIチームメンバー（Agent）を知る

OmO には11の専用Agentが内蔵されており、それぞれが役割を担っています：

コア Agent

Agent 役割 デフォルトモデル いつ使うか
Sisyphus 主調整役、オールラウンド開発 Claude Opus すべてのタスクの入り口であり、他のAgentを自動的にスケジュール
Prometheus 戦略プランナー Claude Opus / GPT-5.4 複雑なタスクの計画立案
Atlas TODOタスク管理 Kimi K2.5 マルチステップタスクの進捗追跡

専門 Agent

Agent 役割 デフォルトモデル 得意なこと
Hephaestus 深層自律ワーカー GPT-5.3-codex 長時間・高強度の独立したコーディングタスク
Oracle アーキテクチャコンサルタント／デバッグ専門家 GPT-5.4 システム設計、難解なバグの特定
Momus 高精度レビュアー GPT-5.4 コードレビュー、出力検証
Metis プランレビュー Claude Opus Prometheus のプランに漏れがないか確認

ツール型 Agent（高速・低コスト）

Agent 役割 デフォルトモデル なぜ安いモデルを使うのか
Explore コードベースの高速検索 MiniMax / Grok Code Fast 検索タスクは高い知能を必要とせず、速度がより重要
Librarian ドキュメント／コード検索 MiniMax（無料） ドキュメント検索は深い推論を必要としない
Multimodal Looker スクリーンショット／視覚分析 Kimi K2.5 Kimi はマルチモーダル理解が得意

💡 初心者向けヒント：Agentを手動で選択する必要はありません。Sisyphus がタスクの種類に応じて適切なAgentの組み合わせを自動的にスケジュールします。

3つの作業モード

モード1：ultrawork（最も簡単）

プロンプトに を追加しultrawork 或 ulw、すべて自動化されます：

ultrawork 帮我把这个 React 组件改成 TypeScript

適している：日常の開発タスク、AIに全自動で完了させたいシーン。

モード2：Prometheus プランモード（最も正確）

按 Tab キーで Prometheus モードに入ります。AI はまず対話であなたの要件を理解し、詳細な実行計画を生成し、確認後に実行を開始します。

フロー：

  1. 按 TabPrometheus モードに切り替える
  2. 要件を説明すると、AI がいくつか明確化の質問をします
  3. AI が実行計画を生成し、あなたが確認する
  4. 入力/start-work実行を開始

適している：複雑な機能開発、アーキテクチャリファクタリングなど、正確な計画が必要なシーン。

モード3：通常対話（最も柔軟）

キーワードを追加せずに、質問や要件を直接入力します：

解释一下 src/auth.ts 里的 JWT 验证逻辑

適している：質問、コード解説、小規模な修正などの軽量タスク。

設定ファイルの詳細

OmO には2つの設定ファイルがあり、優先度が異なります：

  • プロジェクトレベル設定（優先度が高い）：.opencode/oh-my-opencode.jsonc
  • ユーザーレベル設定（グローバルデフォルト）：~/.config/opencode/oh-my-opencode.jsonc

設定ファイルはコメント（JSONC形式）をサポートし、JSON Schemaによる自動補完もサポートしています：

{
  "$schema": "https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/dev/assets/oh-my-opencode.schema.json",
  
  "agents": {
    // 主协调 Agent，建议用 Claude Opus 系列或 Kimi
    "sisyphus": {
      "model": "anthropic/claude-opus-4-6"
    },
    // 架构顾问，建议用 GPT 系列
    "oracle": {
      "model": "openai/gpt-5.4",
      "variant": "high"
    }
  }
}

初心者へのアドバイス：インストール完了後は設定を変更しないでください。デフォルト設定で十分に優れています。

よく使うコマンド早見表

コマンド 説明
opencode OmO を起動
bunx oh-my-opencode install プラグインのインストール／再設定
bunx oh-my-opencode doctor 設定の問題を診断
opencode auth login AIプロバイダーアカウントにログイン
opencode models 利用可能なすべてのモデルを表示
bunx oh-my-opencode refresh-model-capabilities モデル能力キャッシュを更新

会話インターフェース内：

ショートカットキー／コマンド 説明
Tab Prometheus プランモードに切り替え
/start-work Prometheus モードで計画の実行を開始
ultrawork / ulw プロンプトに を追加すると、全機能並列モードが有効化されます

よくある問題のトラブルシューティング

Q：インストール後に実行してもopencodeOmOの機能が表示されない

解決方法：設定ファイルにプラグインが正しく登録されているか確認してください：

cat ~/.config/opencode/opencode.json

確認pluginフィールドに が含まれていること"oh-my-opencode"。含まれていない場合は、再度 を実行してくださいbunx oh-my-opencode install。

Q：実行時に "Using legacy package name" の警告が表示される

解決方法：opencode.json内のプラグイン名を"oh-my-opencode"に更新"oh-my-openagent"：

{
  "plugin": ["oh-my-openagent"]
}

Q：Sisyphus Agent の効果が非常に悪く、普通の Claude とあまり変わらない感じがする

原因：Claude Opus モデルを使用していないか、プロンプトに を追加していない可能性がありますultrawork。

解決方法：

  1. Claude Pro/Max アカウントにログインしていることを確認
  2. プロンプトにultraworkキーワードを追加
  3. を実行してbunx oh-my-opencode doctorモデル設定を確認

Q：タスクの実行が途中で止まった

解決方法：続けてultrawork 继续之前的任务とプロンプトすると、Sisyphus がTodoシステムを通じて進捗を回復します。

Q：匿名テレメトリーデータを無効にしたい

OmO はデフォルトで匿名テレメトリーを有効にしています（PostHogを使用、データはハッシュ化されます）。無効にするには：

export OMO_SEND_ANONYMOUS_TELEMETRY=0
# 或
export OMO_DISABLE_POSTHOG=1
その他の拡張機能