ビデオプロンプトビルダー
汎用的な、プロバイダ非依存のビデオ生成プロンプトディスパッチャーです。.specs/architecture/PROVIDERS.mdのルーティングマトリックスを読み取り、どのプロバイダが処理を実行すべきかを判断し、適切な専門スキル(higgsfield-prompt-builder、topview-prompt-builder、wavespeed-batch、hyperframes-prompt-builder)に委譲します。
呼び出しタイミング
- パイプライン内の任意のビデオ生成ステップ(
ブリーフ → スクリプト → クリエイティブでクリエイティブタイプがビデオの場合)。 - ピースファイル(
.specs/pieces/*.md)でtype: videoが宣言されている場合。 - 複数のプロバイダでビデオフックのA/Bテストを行っており、オーケストレーターが単一のエントリポイントを必要とする場合。
- A/Bテストの勝者決定後、同じブリーフを別のプロバイダで再実行する場合。
- 上流のエージェントがブリーフを持っているが、どのプロバイダを選択すべきか不明な場合。
入力
brief: オブジェクト。少なくともsubject、motion、mood、aspect、duration_secondsを含むビジュアルブリーフ。task_kind: 文字列。cinematic_reel、motion_control、ugc_product_holder、product_demo、talking_head、batch_hook_test、motion_typography、data_viz_reel、programmatic_shortのいずれか。piece_path: 文字列、オプション。ピースファイルへのパス。provider_override.videoを含む場合があります。dry_run: ブール値、オプション。trueの場合、MCPを呼び出さずに解決されたプロバイダとパラメータを返します。
プロセス
.specs/architecture/PROVIDERS.mdを読み込み、ビデオマトリックスをtask_kind → providerマップに解析します。piece_pathが設定されており、provider_override.videoを含む場合、そのオーバーライドを使用します。- そうでない場合、マトリックス内で
task_kindを検索します。不明な場合は、cinematic_reelのマトリックスデフォルトにフォールバックします。 - 選択されたプロバイダに必要な環境変数(
HIGGSFIELD_MCP_ACTIVE、TOPVIEW_API_KEY、WAVESPEED_API_KEY、HYPERFRAMES_ACTIVE)が設定されていることを確認します。 - プロバイダを専門スキルにマッピングします:Higgsfield →
higgsfield-prompt-builder、Topview →topview-prompt-builder、Wavespeed →wavespeed-batch、Hyperframes →hyperframes-prompt-builder。 briefフィールドを専門スキルが期待する入力形状に変換します。- 専門スキルを呼び出し、その
paramsとmcp_tool出力を取得します。 dry_runの場合、解決されたプロバイダ、パラメータ、MCPツールを返します。そうでない場合、MCPを呼び出してアーティファクト参照を返します。- 実行を
data/video-usage.jsonlにタイムスタンプ、プロバイダ、task_kind、結果とともに記録します。
出力
provider_used: 文字列。params: オブジェクト。MCP呼び出し用の最終パラメータオブジェクト。mcp_tool: 文字列。MCPツール名。artifact_ref: 文字列。ドライランでない場合。生成されたビデオへのパスまたはURL。cost_estimate_usd: 数値。
例
例1: cinematic reelがHiggsfieldにルーティングされる
入力: { brief: { subject: "モデルがリネンのスーツを着用", motion: "トラッキングショット", mood: "エディトリアル", aspect: "9:16", duration_seconds: 6 }, task_kind: "cinematic_reel" }
出力: { provider_used: "higgsfield", mcp_tool: "higgsfield_seedance_generate", params: {...} }
例2: UGC広告がTopviewにルーティングされる
入力: { brief: { subject: "アバターが持つスキンケアボトル", motion: "静止", mood: "フレンドリー", aspect: "9:16", duration_seconds: 15 }, task_kind: "ugc_product_holder" }
出力: { provider_used: "topview", mcp_tool: "topview_avatar_generate", params: {...} }
例3: 週次KPIリールがHyperframesにルーティングされる
入力: { brief: { headline: "Semana 21 em números", aspect: "9:16", duration_seconds: 12, variables: { leads: 42, delta_pct: 12 } }, task_kind: "programmatic_short" }
出力: { provider_used: "hyperframes", mcp_tool: "hyperframes_render", params: { composition_spec: {...}, render_args: {...} } } — hyperframes + hyperframes-cliスキルによるローカルレンダリング。
障害モード
- task_kindがマトリックスにない場合:警告をログに記録し、cinematic_reelデフォルトを使用します。
- 選択されたプロバイダに必要な環境変数がない場合:マトリックス内の次のプロバイダにフォールバックし、警告を表示します。
- 専門スキルがエラーを返した場合:それを表示し、呼び出し元が明示的にオプトインしない限り、異なるプロバイダでの自動再試行は行いません。
- 期間がプロバイダの制限を超えた場合:プロバイダの最大値にトリミングし、その旨を通知します。
関連スキル
higgsfield-prompt-builder: Soul、DoP、Seedance向け専門スキル。topview-prompt-builder: UGCおよびアバター主導の広告向け専門スキル。wavespeed-batch: 低コストのバッチフックテスト向け専門スキル。hyperframes-prompt-builder: HTMLレンダリングによるモーションティポグラフィ、データ可視化リール、パラメータ化されたプログラムmaticショート向け専門スキル。llm-router: テキスト生成用の別個のディスパッチャー。同じパターンで異なるドメイン。qa-tech-specs: 最終ビデオをプラットフォーム仕様に対して検証します。