Communitygithub.com

simpletibr/simplicio-loop-marketing

マーケティングエンジンのピースブリーフを、`hyperframes`スキルが期待する入力形状(コンポジション仕様)と、`hyperframes-cli` スキルがレンダリングに必要なフラグに変換します。ルーティングマトリックスが `hyperframes` プロバイダーに解決された際に、`video-prompt-builder` によって選択されます。

simplicio-loop-marketing とは?

このスキルは、マーケティングエンジンのピースモデル(`brief`、`task_kind`、`provider_override`)と HyperFrames コンポジションコントラクトを橋渡しする専門家です。`video-prompt-builder` ディスパッチャーによって選択され、ピースの動画プロバイダーが `hyperframes` に解決された場合に呼び出されます。`motion-typography`、`data-viz-reel`、`programmatic-short` という HyperFrames ネイティブのタスクをサポートし、ブリーフ、クライアントブランドコンテキスト(`design.md`)、タスク種別に基づいてコンポジション仕様とレンダリング引数を構築します。主な機能には、変数の宣言による再レンダリング容易性の確保、厳格な変数チェックによるエラー防止、`design.md` がない場合や不正なタスク種別の場合の適切なフォールバックとエラー処理が含まれます。`hyperframes` および `hyperframes-cli` スキルに依存し、`lint → inspect → render` の順序を強制します。

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

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

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

ドキュメント

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 を呼び出さずにコンポジション仕様とレンダリング引数を返します。

プロセス

  1. ブランドコンテキストを読み込む。 clients/<client_slug>/design.md を読み込み、{ colors, type_pairing, spacing_scale, brand_voice } を解決します。存在しない場合は処理を拒否し、欠落しているパスを表示します。ブランド違反は後続処理で修正できません。
  2. オーバーライドを解決する。 piece_path が設定されており、フロントマターに provider_override.video がある場合は、それが hyperframes であることを確認します。そうでなければ、このスキルは実行されるべきではありません。
  3. task_kind をコンポジションテンプレートにマッピングする。
    • motion-typography → kinetic-type テンプレート、単一シーン、タイプ駆動。
    • data-viz-reel → nyt-graph テンプレート、宣言された数値変数を持つボディシーン。
    • programmatic-short → play-mode テンプレート、フック/ボディ/CTA、すべてのクライアントコピーが変数として宣言されます。
  4. 変数を宣言する。 再レンダリングのたびに変更される可能性があるブリーフ内のすべての要素(ヘッドライン、ボディ、KPI 数値、CTA、日付スタンプ)は、明示的な型、ラベル、デフォルト値とともに variables に入れます。変数で十分な場合にハードコードされたコピーは禁止です。
  5. コンポジション仕様を構築する。 hyperframes が期待する形状 { composition_id, aspect, duration_seconds, scenes, design_tokens, variables, assets, output_dir } に従います。composition_id は <piece-id> から計算します(スラッグセーフ)。
  6. レンダリング引数を構築する。 hyperframes-cli が期待する形状 { project_path, mode: "render", render_opts: { fps, quality, format, variables, strict: true, strict_variables: true, output } } に従います。昇格されたピースには quality: "high"、初回レビュー用には "draft" を選択します。
  7. コスト見積もり。 ローカルレンダリング — duration_seconds × workers × $0.00 から推定(実費ゼロ、代わりにウォールタイムを latency_estimate_min として報告)。
  8. 解決結果をログに記録する。 data/video-usage.jsonl に { ts, provider: "hyperframes", piece_id, task_kind, composition_id, dry_run } を追記します。
  9. 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 を選択する可能性があります。

Individual skills in this repo

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

関連スキル