oma-image

Image Agent - Multi-Vendor Image Router

スケジューリング

目標

認証済みのマルチベンダールーティングを通じて画像やビジュアルアセットを生成しながら、プロンプトの明確さ、参照画像に基づく再生成、コスト管理、再現可能な出力マニフェストを維持します。

インテントシグネチャ

• 画像、ビジュアルアセット、イラスト、商品写真、コンセプトアート、モックアップ、または AI アートの生成を求めている。
• 別のスキルが共通の画像生成インフラストラクチャを必要としている。
• 新しいバリエーションの生成用に参照画像を提供している、またはベンダー間の比較を求めている。

使用する場合

• 画像、ビジュアルアセット、イラスト、商品写真、コンセプトアートを生成する場合
• 同じプロンプトに対する複数の画像モデルの出力を比較する場合
• エディターワークフロー（Claude Code、Codex、Gemini CLI）内でプロンプトから画像を生成する場合
• 画像生成インフラストラクチャを必要とする他のスキルで使用する場合（共有呼び出し）
• 提供された参照画像の被写体、スタイル、ライティング、または構図に沿った新しい画像を再生成する場合

使用しない場合

• ピクセル単位の編集、マスキング、インペインティング、オブジェクトの削除、合成、トリミング、サイズ変更、または形式変換 -> 対象範囲外です。画像エディター、またはその操作を明示的にサポートするツールを使用してください。
• 動画または音声の生成 -> 対象範囲外です
• 構造化データからのインラインベクターアート／SVG の作成 -> テンプレートスキルを使用してください
• アセットの単純なサイズ変更または形式変換 -> 専用の画像ライブラリを使用してください

想定される入力

• 画像プロンプトまたはクリエイティブブリーフ
• 任意のベンダー、サイズ、品質、枚数、出力ディレクトリ、参照画像
• Codex、Pollinations、または Gemini の認証／環境状態

想定される出力

• .agents/results/images/ または指定された出力ディレクトリ内の生成画像ファイル
• プロンプト、ベンダー、モデル、再現性メタデータを含む manifest.json
• --vendor all の使用時は、ベンダー比較結果

依存関係

• oma image generate CLI とベンダー認証
• Codex による画像生成、Pollinations API、または Gemini API／CLI 戦略
• resources/vendor-matrix.md、resources/prompt-tips.md、および .agents/oma-config.yaml の image: セクション

制御フロー機能

• プロンプトの曖昧さ、ベンダー認証、コストしきい値、参照画像に基づく再生成のサポート、パスの安全性、安全性／タイムアウトの終了コードに応じた分岐
• 外部ベンダーの API／CLI を呼び出します
• 参照画像を読み込み、生成画像とマニフェストを書き込みます

構造フロー

エントリー

1. リクエストに、被写体、設定、スタイル、用途、アスペクト比を判断するのに十分な情報が含まれていることを確認します。
2. 提供された画像が、新しいバリエーションを生成するための参照画像なのか、サポート対象外のピクセル／マスク編集の依頼なのかを分類します。
3. 認証、コストガードレール、出力パス、枚数制限を確認します。

遷移

• 被写体や意図する結果を推測できない場合は、不足している情報を確認します。それ以外の場合は、妥当なデフォルト値を使って続行します。
• --vendor all が指定された場合は、指定されたすべてのベンダーが利用可能であることを必須とします。
• 参照画像に基づく再生成の依頼で、選択したベンダーが参照画像をサポートしている場合は、自動的に渡します。
• ピクセル、マスク、トリミング、サイズ変更、または形式の編集が必要な場合は、生成を開始せずに停止し、サポート対象外の操作と適切なエディターの使用方法を提示します。
• 推定コストがガードレールを超える場合は、バイパスが指定されていない限り、確認を求めます。

失敗と復旧

• 認証が不足している場合は、ベンダーごとの認証要件を報告します。
• 選択したベンダーで参照画像がサポートされていない場合は、具体的な対処方法を示してリクエストを拒否します。
• ローカル CLI が古い場合は、ユーザーに oma update の実行を求めます。
• 生成がタイムアウトした場合、またはブロックされた場合は、終了コードとプロバイダーのステータスを提示します。

終了

• 成功：出力ディレクトリに画像とマニフェストが存在します。
• 部分的な成功：比較モードで一部のベンダーが失敗し、失敗内容が報告されます。
• 失敗：画像は生成されず、ルート／コスト／認証／安全性に関する阻害要因が明示されます。

論理操作

ツールと機能

• oma image generate、oma image doctor、oma image vendor list
• Codex、Pollinations、Gemini のプロバイダーパス
• プロンプトのヒント、ベンダーマトリクス、画像設定

標準コマンドパス

oma image doctor
oma image generate "<prompt>" --vendor auto --size auto --quality auto --output json

参照画像を使用する場合：

oma image generate --reference "<absolute-path>" --vendor codex "<prompt>"

リソースの範囲

範囲	リソースの対象
LOCAL_FS	参照画像、生成画像、マニフェスト
PROCESS	プロバイダーの CLI と画像ルーターのコマンド
NETWORK	Pollinations/Gemini またはプロバイダーの API
CREDENTIALS	プロバイダーの認証情報と API キー

前提条件

• プロンプトが十分に具体的であるか、ユーザーが内容の補足を承認していること。
• 必要なベンダー認証情報と出力権限があること。
• 参照画像を使用する場合、そのパスにアクセスできること。

影響と副作用

• 画像ファイルとマニフェストを作成します。
• 有料またはレート制限のあるプロバイダー API を呼び出す場合があります。
• 添付画像や参照画像を読み取る場合があります。

ガードレール

1. 依頼内容を明確にする：提示された詳細と妥当なクリエイティブ上のデフォルトを使用します。不足している選択肢によって依頼された結果が大きく変わる場合に限り、質問します。生成がすでに許可されている場合は、拡張したプロンプトへの承認を求めないでください。
2. 認証状態を考慮したディスパッチ：利用可能なベンダー CLI を検出し、利用可能なものだけを実行します。--vendor all の場合、指定されたすべてのベンダーが利用可能である必要があります（厳格）。注意：antigravity のヘルスチェックで確認するのはインストール状況のみです（agy --version）。サインアウト済みの agy はヘルスチェックに合格しますが、生成時に agy 独自のエラーで失敗します。
3. コストのガードレール：推定コストが $0.20 以上（設定可能）の実行を始める前に確認します。--yes / OMA_IMAGE_YES=1 を指定すると確認を省略できます。キーワードの有無ではなく、依頼された結果に基づいて生成方法を選択します。非対話型の環境（エージェント、CI など、stdin に TTY がない環境）では、CLI から確認を求められないため、しきい値以上の実行は --yes の指定を示すメッセージを出して終了コード 1 で終了します。コストの見積もりには --dry-run を使用します。既存の予算承認を再利用し、それ以外の場合は -y を付けて再実行する前に追加費用の承認を得てください。
4. パスの安全性：$PWD の外部に出力するには、--allow-external-output が必要です。
5. キャンセル可能：SIGINT/SIGTERM により、実行中のプロバイダー呼び出しとオーケストレーターを中断します。
6. 決定的な出力：再現性を確保するため、実行ごとに画像と同じ場所へ manifest.json を書き込みます。
7. n の最大値は 5：実行時間を制限します。
8. 終了コードは oma search fetch と同じです（0、1、2=安全性、3=見つからない、4=無効な入力、5=認証が必要、6=タイムアウト）。

クリエイティブブリーフ

指定された被写体と制約を使用します。指定がない場合は、設定、スタイル、照明、アスペクト比を推測し、明示されたテキストと参照の意図を維持します。未解決の選択肢が結果に大きく影響する場合に限り、質問します。なじみのない画像カテゴリの場合は、resources/prompt-tips.md を参照してください。

参照資料

• プロバイダーの呼び出し、参照、出力レイアウト：resources/invocation.md（選択したベンダー、または参照画像を扱う操作のみ）。

設定

プロジェクト固有の設定は .agents/oma-config.yaml の image: セクションにあります。このセクションは oma update によって保持されます。配布時のデフォルト設定は CLI 内にあります（cli/commands/image/config.ts の DEFAULTS）。変更するキーのみを記述してください。従来の config/image-config.yaml は CLI で参照されなくなりました。マイグレーション 022 は、ここで変更した設定を oma-config に移し、一度も編集されていない場合はこのファイルを削除します。 環境変数：OMA_IMAGE_DEFAULT_VENDOR、OMA_IMAGE_DEFAULT_OUT、OMA_IMAGE_YES、POLLINATIONS_API_KEY

• 実行手順（選択したタスクに従ってください）：resources/execution-protocol.md
• ベンダーマトリクス：resources/vendor-matrix.md
• プロンプトのヒント：resources/prompt-tips.md
• チェックリスト（引き渡し前に実行）：resources/checklist.md
• コンテキストの読み込み：../_shared/core/context-loading.md