Communitygithub.com

simpletibr/simplicio-loop-marketing

ビデオ生成プロンプトのアセンブリを行い、PROVIDERS.mdに基づいてプロバイダを選択し、対応するプロバイダ固有のビルダーに処理を委譲します。

simplicio-loop-marketing とは?

このスキルは、ビデオ生成パイプラインにおけるプロバイダ非依存のディスパッチャーとして機能します。`.specs/architecture/PROVIDERS.md`に定義されたルーティングマトリックスを読み取り、タスクの種類(`cinematic_reel`、`ugc_product_holder`など)に応じて適切なプロバイダ(Higgsfield、Topview、Wavespeed、Hyperframes)を選択し、対応する専門スキル(`higgsfield-prompt-builder`など)にプロンプト構築を委譲します。入力としてビジュアルブリーフとタスク種類を受け取り、環境変数の確認、プロバイダ固有のパラメータ変換、MCPツールの呼び出しを行います。ドライラン機能も備えており、最終的な出力として使用されたプロバイダ、パラメータ、生成されたビデオのアーティファクト参照を返します。主にClaude CodeなどのAIエージェント環境でのビデオ生成パイプラインの統合ポイントとして利用され、A/Bテストやプロバイダ切り替えを容易にします。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/simpletibr/simplicio-loop-marketing/tree/HEAD/.skills/video-prompt-builder

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

ビデオプロンプトビルダー

汎用的な、プロバイダ非依存のビデオ生成プロンプトディスパッチャーです。.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を呼び出さずに解決されたプロバイダとパラメータを返します。

プロセス

  1. .specs/architecture/PROVIDERS.mdを読み込み、ビデオマトリックスをtask_kind → providerマップに解析します。
  2. piece_pathが設定されており、provider_override.videoを含む場合、そのオーバーライドを使用します。
  3. そうでない場合、マトリックス内でtask_kindを検索します。不明な場合は、cinematic_reelのマトリックスデフォルトにフォールバックします。
  4. 選択されたプロバイダに必要な環境変数(HIGGSFIELD_MCP_ACTIVE、TOPVIEW_API_KEY、WAVESPEED_API_KEY、HYPERFRAMES_ACTIVE)が設定されていることを確認します。
  5. プロバイダを専門スキルにマッピングします:Higgsfield → higgsfield-prompt-builder、Topview → topview-prompt-builder、Wavespeed → wavespeed-batch、Hyperframes → hyperframes-prompt-builder。
  6. briefフィールドを専門スキルが期待する入力形状に変換します。
  7. 専門スキルを呼び出し、そのparamsとmcp_tool出力を取得します。
  8. dry_runの場合、解決されたプロバイダ、パラメータ、MCPツールを返します。そうでない場合、MCPを呼び出してアーティファクト参照を返します。
  9. 実行を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: 最終ビデオをプラットフォーム仕様に対して検証します。

Individual skills in this repo

This repo contains 5 individual skills — each has its own dedicated page.

関連スキル