HyperFrames プロンプトビルダー
マーケティングエンジンのピースモデル(brief、task_kind、provider_override)と HyperFrames コンポジションコントラクトを橋渡しする専門家です。形状において higgsfield-prompt-builder や topview-prompt-builder と同様で、同じディスパッチャーを持ちながら異なるターゲットを扱うため、video-prompt-builder は自身のロジックを変更することなくプロバイダーを切り替えることができます。
呼び出しタイミング
video-prompt-builderがあるピースの動画プロバイダーをhyperframesに解決した場合。task_kindがmotion-typography、data-viz-reel、programmatic-shortのいずれかである場合(PROVIDERS.mdに定義された HyperFrames ネイティブタスク)。- ピースのフロントマターで
provider_override.video: hyperframesが宣言されている場合。 - 承認済みの静止画(
gpt-imageからのクォートカードやtopviewからのカルーセル)を動画に昇格させ、型システムが元のデータをバイト単位で忠実に保持する必要がある場合。 - オーケストレーターが、AI ジェネレーターに再プロンプトすることなく、新しい変数値(週次 KPI リール、日次価格更新、A/B テスト用コピー)で同じコンポジションを再レンダリングする必要がある場合。
入力
brief: オブジェクト。最低でもheadline、body?、cta?、aspect、duration_secondsを含むピースブリーフ。task_kind:"motion-typography" | "data-viz-reel" | "programmatic-short"。piece_path: 文字列、省略可能。.specs/pieces/<piece-id>.mdへのパス。フロントマターにはprovider_override、compliance_flags、variablesを含めることができます。client_slug: 文字列。.marketing-engine/clients/<slug>/design.md(またはエンジンレポジトリ内のclients/<slug>/design.md)を読み込むために使用されます。output_dir: 文字列。プロジェクトと最終的な MP4 が保存される場所のデフォルトはoutputs/<client>/<date>/<piece-id>/です。dry_run: ブール値、省略可能。true の場合、hyperframes-cliを呼び出さずにコンポジション仕様とレンダリング引数を返します。
プロセス
- ブランドコンテキストを読み込む。
clients/<client_slug>/design.mdを読み込み、{ colors, type_pairing, spacing_scale, brand_voice }を解決します。存在しない場合は処理を拒否し、欠落しているパスを表示します。ブランド違反は後続処理で修正できません。 - オーバーライドを解決する。
piece_pathが設定されており、フロントマターにprovider_override.videoがある場合は、それがhyperframesであることを確認します。そうでなければ、このスキルは実行されるべきではありません。 - task_kind をコンポジションテンプレートにマッピングする。
motion-typography→kinetic-typeテンプレート、単一シーン、タイプ駆動。data-viz-reel→nyt-graphテンプレート、宣言された数値変数を持つボディシーン。programmatic-short→play-modeテンプレート、フック/ボディ/CTA、すべてのクライアントコピーが変数として宣言されます。
- 変数を宣言する。 再レンダリングのたびに変更される可能性があるブリーフ内のすべての要素(ヘッドライン、ボディ、KPI 数値、CTA、日付スタンプ)は、明示的な型、ラベル、デフォルト値とともに
variablesに入れます。変数で十分な場合にハードコードされたコピーは禁止です。 - コンポジション仕様を構築する。
hyperframesが期待する形状{ composition_id, aspect, duration_seconds, scenes, design_tokens, variables, assets, output_dir }に従います。composition_idは<piece-id>から計算します(スラッグセーフ)。 - レンダリング引数を構築する。
hyperframes-cliが期待する形状{ project_path, mode: "render", render_opts: { fps, quality, format, variables, strict: true, strict_variables: true, output } }に従います。昇格されたピースにはquality: "high"、初回レビュー用には"draft"を選択します。 - コスト見積もり。 ローカルレンダリング —
duration_seconds × workers × $0.00から推定(実費ゼロ、代わりにウォールタイムをlatency_estimate_minとして報告)。 - 解決結果をログに記録する。
data/video-usage.jsonlに{ ts, provider: "hyperframes", piece_id, task_kind, composition_id, dry_run }を追記します。 dry_runの場合は、hyperframes-cliを呼び出さずに戻ります。それ以外の場合は、hyperframes(プロジェクト作成用)を呼び出し、続けてhyperframes-cli(モードlint→inspect→render)を順に呼び出します。
出力
provider_used:"hyperframes"。composition_spec: オブジェクト。hyperframesスキルに渡される入力。render_args: オブジェクト。hyperframes-cliスキルに渡される入力(モードrender)。expected_artifact: 文字列。render後に存在する MP4 へのパス。latency_estimate_min: 数値。レンダリングのウォールタイム見積もり。cost_estimate_usd: 0(ローカルレンダリング、運用費のみ)。
例
例 1: 週次 KPI リール(programmatic-short)
入力: { brief: { headline: "Semana 21 em números", aspect: "9:16", duration_seconds: 12 }, task_kind: "programmatic-short", client_slug: "saas-consultoria-imagem", piece_path: ".specs/pieces/2026-05-22-kpi.md" }
出力: composition_id: "kpi-weekly-2026-05-22" を持つコンポジション仕様、3つのシーン(フック/ボディ/CTA)、数値変数(leads、delta_pct)、--strict --strict-variables --quality high --variables '{"leads":42,"delta_pct":12}' を持つレンダリング引数。
例 2: モーションクォートカード(motion-typography)
入力: { brief: { headline: "Coloque a sua marca onde os olhos já estão.", aspect: "1:1", duration_seconds: 6 }, task_kind: "motion-typography", client_slug: "saas-consultoria-imagem" }
出力: 単一のキネティックタイプシーン、マスクテキストエントランス、アクティブなクライアントの design.md から取得したデザイントークンを持つコンポジション仕様、outputs/saas-consultoria-imagem/<date>/<piece-id>/final.mp4 をターゲットにしたレンダリング引数。
例 3: プロバイダーオーバーライド
入力: provider_override.video: hyperframes を持つが、task_kind がマトリックスに含まれていないピース。
出力: それでもここにルーティングされ、task_kind をデフォルトで programmatic-short に設定し、フォールバックをログに記録します。
絶対的なルール
- 決してデザイントークンを発明しないでください。
design.mdがない場合は処理を拒否してください。 - たとえ静的に見える場合でも、ピースごとのコピーは常に
variableとして宣言してください。コンポジションはコード編集なしで再レンダリング可能でなければなりません。 - レンダリング引数では常に
--strict-variablesを渡してください。変数 ID のタイポは致命的な失敗です。 lint → inspect → renderシーケンスを迂回してhyperframes-cliを直接呼び出さないでください。
障害モード
- 未知の
task_kind: デフォルトでprogrammatic-shortに設定し、警告をログに記録して続行します。 design.mdがない: 停止します。パレットを選択せず、オペレーターにファイルを追加するよう依頼します。- ブリーフにブランドで禁止されたクレームが含まれている場合(
compliance-<アクティブなクライアント>による): 作成前にブロックします。コンプライアンスはレンダリングの上流で実行されます。 - HyperFrames CLI がインストールされていない: インストールコマンド(
npm i -g hyperframesまたはnpx hyperframes@latest)を表示して停止します。
関連スキル
hyperframes: コンポジション作成ルール(このスキルから利用されます)。hyperframes-cli: lint/inspect/render の実行(このスキルから利用されます)。video-prompt-builder: このスキルを選択するディスパッチャー。qa-tech-specs: 最終的な MP4 に対して実行されます。compliance-<アクティブなクライアント>/compliance-generic: 解決された変数とレンダリングされたアーティファクトに対して実行されます。llm-router: ここでは直接使用されませんが、このスキルがコンポジション仕様を組み立てる前に、ヘッドライン/ボディを作成する LLM を選択する可能性があります。