OmniFlow Studio エージェントスキル は何をしますか？
このスキルは、AIコーディングエージェントおよびオーケストレーションエージェントに OmniFlow Studio への直接制御権限を付与します。OmniFlow Studioは、ローカルAIエージェントとGoogle Chrome上の高忠実度生成メディアキャンバスを接続する自律型ブリッジです。
このスキルを使用すべきタイミング
以下の場合にこのスキルを使用します:
- ユーザーが映画的なAI動画、Bロール映像、コンセプトアート、ストーリーボードの生成を依頼したとき。
- 自律型マルチショット短編映画や広告クリエイティブの構築・ディレクションを行うとき。
- 複数のビデオシーン間でキャラクター参照シート（ターンアラウンド一貫性）を生成するとき。
- 分単位のAPI料金を支払わずにバッチ画像/動画生成キューを自動化するとき。
- 現在のOmniFlowブリッジステータス、生成クォータ、アクティブなキューの進捗状況について問い合わせがあったとき。
🚀 エージェント向けクイック実行プロトコル
メディアジョブをディスパッチする前に、すべてのエージェントは以下の3ステップの確認ループを実行する必要があります:
ステップ1: ヘルス & ブリッジチェック
ローカルのOmniFlowブリッジデーモンが http://127.0.0.1:8792 で実行中であることを確認します:
node scripts/check-bridge.js
# またはcurlで直接:
curl -s http://127.0.0.1:8792/status
- オフラインの場合: ユーザーに指示するか、以下を実行します:
omniflow bridge start（またはブリッジバックグラウンドタスクを起動）。 - オンラインの場合:
extensionConnectedがtrue、tabVisibleがtrueであることを確認します（ChromeでGoogle Flowが開いていることを意味します）。
ステップ2: 生成ジョブの送信
エージェントはREST APIまたは提供されたヘルパースクリプトを使用してジョブを送信できます:
# ヘルパースクリプト（最も簡単）:
node scripts/submit-shot.js --mode flow-text-to-video --prompt "映画的なドローン俯瞰、ネオンサイバーパンク東京、雨、8K" --aspectRatio 16:9 --duration 6s
# または直接HTTP POST:
curl -s -X POST http://127.0.0.1:8792/jobs \
-H "Content-Type: application/json" \
-d '{
"mode": "flow-text-to-video",
"prompt": "映画的なドローン俯瞰、ネオンサイバーパンク東京、雨、8K",
"params": {
"aspectRatio": "16:9",
"duration": "6s",
"videoModel": "veo-3.1-fast",
"downloadSubfolder": "MyProject"
}
}'
ステップ3: ダウンロード済みメディアの監視と取得
ジョブステータスが completed に変わるまでポーリングします:
node scripts/list-jobs.js
# または:
curl -s http://127.0.0.1:8792/jobs
status === "completed" になったら、files 配列からローカルファイルパスを取得します（例: Downloads/MyProject/...mp4）。
🛠️ サポートされている生成モード
| モードID | 説明 | 主要パラメータ |
|---|---|---|
flow-text-to-video | テキスト記述からモーション動画を生成 | prompt, aspectRatio (16:9, 9:16, 1:1), duration (4s, 6s, 8s) |
flow-text-to-image | フォトリアリスティックまたはスタイライズドな静止画像を生成 | prompt, aspectRatio, imageModel (nano-banana-pro) |
flow-frame-to-video | 静止画像またはキーフレームを連続動画に拡張 | prompt, duration, 参照アセットトークン |
flow-create-character | 顔の一貫性のための4アングルターンアラウンドシートを生成 | characterName, visualDescription, voicePreset |
🎛️ MCPツール呼び出し（MCPサーバーがアクティブな場合）
エージェント環境でOmniFlowのMCPサーバーが接続されている場合、以下のネイティブツールを直接呼び出せます:
omniflow_status: ブリッジとブラウザの接続ステータスを確認します。omniflow_generate_shot: カメラムーブメント（drone-wide,close-up,tracking）を指定した単一ショットをキューイングします。omniflow_produce_movie: 順序付けられたショットからなる完全なスクリーンプレイ配列を渡し、短編映画全体を順次生成します。omniflow_create_character: 正面とプロフィールのターンアラウンド一貫性を備えたキャラクタタグをロックします。omniflow_list_jobs: アクティブ、キュー中、完了した生成ジョブをディスクダウンロードパスとともに一覧表示します。
💡 シネマティックプロンプトのベストプラクティス
Veo 3.1でフォトリアリスティックな動画出力を行う場合:
- カメラの動きを指定: 例:
[Camera: drone-wide],[Camera: slow push-in],[Camera: tracking shot]。 - 照明と雰囲気を指定: 例:
volumetric rim lighting,golden hour anamorphic haze,35mm film grain。 - 専門用語を避ける: Google Flowはソフトウェアタグよりも明確な視覚的な物語記述に最もよく反応します。
詳細は references/api-reference.md および examples/cinematic-short-film.json を参照してください。これらのファイルには、すぐに実行できるマルチシーンテンプレートが含まれています。