最初に、このスキルを最新の状態に保ってください — 確認せずに実行:
npx hyperframes skills update product-launch-video。すべてが最新の場合は高速で何も行いません。それ以外の場合は、このスキルと、それが依存するコアドメインスキルを、それらに依存する前に更新します。
media-use: オーディオ/画像/ロゴを調達する前に、
/media-useを呼び出して、HeyGen カタログから BGM/SFX/画像を解決し、ブランドロゴを公式ソースから解決します。最初に--adoptを実行して既存のアセットを登録します。/media-useスキルを参照してください。
figma ソース: ソースが figma.com の URL の場合、最初に
/figmaを実行してください — アセットのエクスポート、ブランドトークン、および必要に応じてコンポーネント/ストーリーボードの再構築 — 次に、その出力からこのワークフローを構築します。未加工の MCP ツールを介して直接 Figma を操作しないでください。SVG サニタイゼーション、.media/manifest.jsonlの来歴、およびブランドトークンvar()バインディングをスキップすることになり、後でブランドを変更しても完全な再インポートなしでは伝播できなくなります。
Product Launch to HyperFrames
このスキルを使用して、製品をキャプチャし、そのブランドを理解し、ローンチビデオを計画し、HyperFrames でフレームごとに構築します。
玄関は
/hyperframesです。 あなたはオーケストレーターです。各ステップを実行し、そのゲートを確認し、その後にのみ次のステップに進みます。このスキルは、マーケティング、ローンチ、プロモーション、または公開される製品を対象としています。これには、「私たちのサイトのプロモ」などのリクエストも含まれます。サイトツアー/ショーケースの依頼もここにとどまります。BRIEF.mdがそのまま表示する意図を持ち、キャプチャされたスクリーンショットがビデオで紹介されるアセットになります。他の意図、単なる「ビデオを作成」、または不確かな場合は、最初に/hyperframesを読んでください — インテントレイヤーがすべてのルート決定を所有し、ここにBRIEF.mdなしで到着した新しい作成も、とにかくそれを通過します(Setup の開始ルール)。
あなたはオーケストレーターです。videos/<project>/ で作業します。ステップを順番に実行し、次のステップに進む前に各ゲートを通過します。ユーザーゲートのステップは、ステップ 0、ステップ 3、およびステップ 6 です。ステップ 0 の前に ../hyperframes-core/references/brief-contract.md を読んでください — ゲートタイプと、BRIEF.md の flow/storyboard がステップ 3/4/6 のゲートを管理するモードをどのように導出するかを定義しています。ステップ 5 を除くすべてのステップを自分で実行します。ステップ 5 では、フレームごとに 1 つのサブエージェントをディスパッチします。設計やモーションのルールはここに配置しないでください。それらはフレームワーカーサブエージェント、このスキルのローカル ../hyperframes-animation/rules/ + ../hyperframes-animation/blueprints/、および hyperframes-creative にあります。
ワークフロー: ステップ 0 セットアップ -> hyperframes.json; ステップ 1 キャプチャ -> capture/; ステップ 2 デザインシステム -> frame.md; ステップ 3 ストーリーボード/スクリプト -> STORYBOARD.md および SCRIPT.md; ステップ 3.1 オーディオ -> audio_meta.json; ステップ 4 ビジュアルデザイン -> 拡張された STORYBOARD.md; ステップ 5 フレーム -> compositions/frames/NN-*.html および index.html; ステップ 6 最終レンダリング -> renders/video.mp4。
ステップ 0: セットアップ
目標: 確定したブリーフを入力し、HyperFrames プロジェクトを作成し、ブリーフを永続化します。
ブリーフは、ここで質問することによってではなく、インテントレイヤーによって確定されます。 開始ルール、順序: (1) BRIEF.md が存在する -> それを読み、何も質問しないでください — ブリーフは確定しており、その flow/storyboard がモードを導出します(ブリーフ契約 § 1)。(2) BRIEF.md は存在しないが、プロジェクトは存在する(ディスク上の hyperframes.json / STORYBOARD.md)-> ストーリーボードのフロントマターと記録された設定から再開します。構築途中のプロジェクトを再び尋問しないでください。(3) どちらでもない — 直接ここに到着した新しい作成リクエスト -> /hyperframes を読み、そのインテントレイヤー(references/intent-interview.md)を実行します。レシピと記憶されたデフォルトをチェックし、このルートの質問(../hyperframes/references/routes/product-launch-video.md)を実施し、ロックされたブリーフを返します。編集リクエストはこれらすべてをスキップします — 編集を実行してください。
hyperframes.json がない場合にのみ初期化します。ブランドまたはドメインから <project> をケバブケースで命名します(例: acme-promo)。ワークスペース名やタイムスタンプは使用しないでください。
npx hyperframes init "videos/<project>" --non-interactive --example=blank --skill=product-launch-video — init はインストールされたスキルを GitHub の最新バージョンと照合し、古いものがあればグローバルセットを更新します。
初期化後、<PROJECT_ROOT> を videos/<project> とし、後続のすべての相対パスコマンドをそのディレクトリを作業ディレクトリとして実行します。以下のコマンドでは、. は <PROJECT_ROOT> を意味します。.media、capture、または出力ファイルを呼び出し元のディレクトリに書き込まないでください。
初期化の直後に BRIEF.md を書き込みます(決して前には書き込まないでください — init は空でないディレクトリを拒否します)。インテントレイヤーのロックされたブリーフ。形状は ../hyperframes-core/references/brief-format.md に従います。<MEDIA_DIR> をインストールされた /media-use スキルディレクトリとして解決します。次に、各設定に基づく回答を node <MEDIA_DIR>/scripts/prefs.mjs record --hyperframes . で記録します(brief-format.md はサブセットを指定します)。インテントレイヤーがレシピを採用した場合、node <MEDIA_DIR>/scripts/recipe.mjs use --hyperframes . --name <name> を実行します。これにより、frame.md がプロジェクトにコピーされ(ステップ 2 はスキップされます)、ステップ 3 のドラフトが作成するスケルトンが返されます。レシピは回答を設定しますが、承認は設定しません。レビューゲートは引き続き実行されます。
セットアップを通過する前にサインインステータスを表示します — npx hyperframes auth status を実行し、その出力をそのまま中継します。ボイス/BGM が HeyGen を使用するかローカルエンジンを使用するか、およびサインアウトしている場合のサインイン方法を報告します。終了コード契約に注意してください。auth status は、サインインしていない場合(および保存された認証情報が拒否された場合)に終了コード 1 で終了します — このゼロ以外の終了は通常のサインアウト状態であり、コマンドの失敗ではありません。そのため、エラーとして扱わず、再試行せず、&&/set -e でチェーンしてワークフローを中断させないでください。1 つのブランチを適用します:
- 協調的: ユーザーがサインインするか、明示的に
offline/goを選択するまで待機します。 - 自律的: ステータスを述べ、利用可能なローカルエンジンで続行します。
必要な機能についてオフラインプロバイダーが存在しない場合、黙って省略しないでください。ブロッカーを表面化します。この決定を別の質問に折りたたんだり、リポジトリごとの .env にキーを書き込んだりしないでください。認証の所有権とオフラインフォールバック: /media-use references/setup-providers.md § Providers。
ゲート: hyperframes.json と BRIEF.md が存在すること。設定に基づく回答が記録されていること(ブリーフ契約 § 2)。サインインステータスが表示されていること(サインインしているか、オフラインで続行していること)。
ステップ 1: アセットのキャプチャ
目標: ソースマテリアル、ブランドシグナル、およびビデオに使用可能なアセットを収集します。
入力を分類し、パスを選択します。明示的な URL -> それをキャプチャし、サイトをナレーションとアセットに使用します。貼り付けられたスクリプト/ブリーフ -> user_script.txt としてそのまま保存します。VO_MODE(逐語的または再構築)は BRIEF.md から取得します — インテントレイヤーはスクリプトが到着したときにそれを尋ねます(ブリーフに何らかの理由で欠けている場合、ここで一度だけ尋ねます)。次に、キャプチャターゲットを解決します: テキスト内の URL -> それを使用します。ブランド名のみ -> WebSearch、1 行で URL を確認し、クロールします。URL/サイトなし(またはブリーフがスクレイプしないように指示している場合)-> キャプチャなしパス。
キャプチャを実行: npx hyperframes capture "<URL>" -o ./capture --json。デフォルトのナビゲーション後予算を維持します。ただし、呼び出し元がより短い期限を所有している場合は除きます。その場合は、ダウンストリーム作業の時間を残す正の --capture-budget <ミリ秒> を渡します。--timeout はページナビゲーションのみを制御します。--skip-vision は、オプションの画像キャプションを意図的に無効にする場合にのみ使用します。
コマンドの結果と出力ディレクトリをすぐに検査します。ゼロ以外の終了、JSON ok: false、または capture/BLOCKED.md は、キャプチャパスにとって ハードストップ です。記録された理由を報告し、部分的なスクリーンショット、DOM、トークン、またはアセットを消費しないでください。URL キャプチャが失敗した後、合成された「キャプチャなし」フォールバックを作成しないでください。元のブリーフがソースマテリアルを提供した場合、またはユーザーが提供されたスクリーンショットまたはブリーフに明示的に切り替えた場合にのみ、「キャプチャなし」パスを続行します。
「テキストコンテンツが非常に少ない」などの警告と空のアセットカタログは、使用可能なページの証拠にはなりません。サイトツアーまたは「そのまま表示」のブリーフの場合、信頼できるキャプチャされた構造または提供されたスクリーンショットが必要です。どちらも存在しない場合は停止します。キャプチャが使用できないという理由だけで、ページを発明したり再構築したりしないでください。
サイトツアーまたは「そのまま表示」のブリーフの場合、キャプチャされたページが視覚的な真実のソースです。完全なウェブサイトを HTML で再構築する代わりに、実際のスクリーンショットを使用します。ショットに内部的な動きが必要な場合は、スクリーンショットをベースとして保持し、測定された位置に実際のキャプチャされたアセットをオーバーレイするか、動くコンポーネントのみを再構築します。スクロールショットの場合、capture/screenshots/full-page.png 上でビューポートをアニメーション化します — ドキュメント全体の 1x プレートで、1920 幅のビューポートがそれに沿って移動するピクセル完全なものです。これは、ページが高すぎて 1 枚でキャプチャできなかった場合には存在しません。その場合は、同じディレクトリにある重複するスクロール位置のショットにフォールバックします。1:1 を超えて押し込む場合は、代わりにその領域の独自の 2x キャプチャが必要です。プレートには 1x を超える余裕がないためです。ユーザーが明示的にスタイリングされた解釈を要求した場合にのみ、ページ全体を再作成します。使用できないキャプチャだけでは許可されません。
GEMINI_API_KEY、GOOGLE_API_KEY、または OpenRouter キーが存在する場合、キャプチャはアセットを自動キャプションして capture/extracted/asset-descriptions.md に追加します。これはレビューゲートではありません。ビジョンキーがない場合は、DOM コンテキストを使用して続行します。
キャプチャなしパス: capture/extracted/tokens.json、capture/extracted/visible-text.txt、capture/extracted/asset-descriptions.md、および capture/assets/ を手動で作成します。tokens.json は { "title": "", "description": "", "colors": [], "fonts": [] } とします。可能な場合はブリーフからタイトル/説明を入力します。visible-text.txt には完全なブリーフまたはスクリプトを含めます。asset-descriptions.md は、ユーザーがアセットに関するメモを提供しない限り、アセットがキャプチャされなかったことを示す必要があります。
ゲート: キャプチャ JSON が ok: true を報告したこと。capture/BLOCKED.md が存在しないこと。capture/extracted/tokens.json、capture/extracted/visible-text.txt、capture/extracted/asset-descriptions.md、および capture/assets/ が存在すること。ブランドを 1 つの明確な文で述べることができること。asset-descriptions.md を主要なアセットインベントリとして扱います。実際のキャプチャ後に欠落している場合は、停止してキャプチャが不完全であることを報告します。劣化したオプションフェーズに関する警告は、この構造的なゲートがまだ通過する場合にのみ許容されます。
ステップ 2: デザインシステム
目標: 1 つの出荷済みフレームプリセットを選択します。スクリプトがそれをこのビデオの frame.md + キャプションスキンに変換します。
BRIEF.md が style_preset を指定している場合 — ユーザーがインテントレイヤーのショーケースから目で選んだもの — それを使用します。判断は、ブリーフが沈黙している場合にのみあなたに委ねられます。次に、1 つの呼び出しを行います — どのプリセットか: ../hyperframes-creative/references/design-spec.md を読み、ブランドとブリーフに最も適した外観のプリセットを選択します。次に実行:
node <SKILL_DIR>/scripts/build-frame.mjs --preset <name> --hyperframes .
スクリプトは残りを決定論的に実行します: プリセットの FRAME.md を frame.md にコピーし、それを capture/extracted/tokens.json のブランドトークンに リミックス します(ブランドカラーは、役割(インク、キャンバス、アクセント)によってプリセットのカラーキーにマッピングされ、キー/構造/コンポーネントは保持されます。プリセットの表示 + 本文フォントはブランドのフォントに置き換えられます)。プリセットのキャプションスキンを .hyperframes/caption-skin.html にコピーし、自己検証します(壊れたマッピングでは終了コード 1 で終了します)。終了コード 0 で終了したらすぐに次のステップに進みます — 仕様の手動編集は行いません。
ブランドカラー/フォントがない tokens.json(例: キャプチャなし)-> スクリプトはプリセット独自のパレットを保持します。これは完全に出荷可能なデザインです。ブリーフがキャプチャで見逃したブランドカラー/フォントを指定している場合は、実行前にそれらを capture/extracted/tokens.json に追加します(またはユーザーの design.md を使用してそれを設定します)。マッピングが本当に必要な場合にのみ、後で手動で frame.md を調整します。
ゲート: build-frame.mjs が終了コード 0 で終了したこと — frame.md が名前付きプリセットから存在すること、および(プリセットが出荷する場合).hyperframes/caption-skin.html がキャプションスキンソースとして存在すること。選択されたプリセットが設定として記録されたこと(--key style_preset --workflow <このワークフロー>、ブリーフ契約 § 2)。
ステップ 3: ストーリーボードとスクリプト
目標: ブリーフとキャプチャされたマテリアルを、承認されたフレームごとのストーリープランに変換します。
../hyperframes-creative/references/story-spine.md(フック言語、証拠より先に価値、提案としてのストーリーボード)、references/story-design.md、../hyperframes-animation/blueprints-index.md、../hyperframes-core/references/storyboard-format.md、および ../hyperframes-core/references/script-format.md を読んでください。それらを使用して STORYBOARD.md を作成し、ナレーションが必要な場合は SCRIPT.md を作成します。フロントマターの duration: はブリーフの length から設定します — 大まかな期待値で、編集がそれに対してどこにあるかをアセンブリが報告します。
story-design.md をストーリーブループリント、フック、説得ロジック、ビート、VO_MODE、およびアセットの選択に使用します。ソフトガイドとして、../hyperframes-animation/blueprints-index.md の役割→ブループリントメニューを参照します: 各ビートについて、適合する場合に候補ブループリント ID をメモします。ストーリーの真実は依然としてどのビートが存在するかを決定します — ブループリントに合わせるためにビートを強制したり、証明された形状が利用可能だからといってビートを発明したりしないでください。各ビジュアルフレームの asset_candidates を capture/extracted/asset-descriptions.md(標準インベントリ)から選択します — 生の capture/assets/ を参照しないでください。そのインベントリが欠落しているか使用できない場合を除き、ユーザーにアセットを選ばせないでください。ストーリーボードおよびスクリプトリファレンスの必須フィールドを正確に使用します。
ドラフト後、レビューループの計画パスを実行します — ../hyperframes-core/references/review-loop.md § 1: ボードを開き(開くかどうか尋ねない)、計画を提案として提示し、2 つの質問をします — 承認するか変更するか、そして スケッチを先に(推奨)またはスキップするか。フィードバックは承認されるまでチャットまたはボードのコメントファイルを通じてループします。これは チェックポイントゲート です(ブリーフ契約 § 1)。自律モードではボードはなく、何も尋ねることはありません — 同じ要約をヘッズアップとして投稿し、続行します。スケッチはビルドに統合され、1 つのプレビュー質問はステップ 6 で行われます。
ゲート: STORYBOARD.md が存在すること、SCRIPT.md が必要に応じて存在すること、承認された計画(協調モードの場合)があること、または自律モードで続行されたこと。
ステップ 3.1: オーディオ
目標: このビデオに必要なすべてのオーディオアセットを特定し、選択し、予約します。
このステップは、プロジェクトのオーディオがまだ選択/確定されていない場合にのみ実行します。audio_meta.json がすでに存在する場合は、スキップしてステップ 4 に進みます。
../hyperframes-core/references/audio-contract.md を読んで、オーディオ選択の期待値と出力形式を理解してください。
ナレーション: SCRIPT.md が存在する場合、それはナレーションが必要であることを意味します。../hyperframes-animation/blueprints-index.md で述べられているように、適切な音声モデル(例: 明るいプロモーション用のトーン)を選択します。音声選択を audio_meta.json に記録します。ユーザーが特定の声を要求しない限り、声の選択はあなたの判断に任せられます。ユーザーが声を指定した場合は、それを使用します。
音楽: 説明されている感情的な弧とビートに合った BGM トラックを選択します。/media-use スキルからの利用可能な音楽アセットを参照します。audio_meta.json に音楽の選択を記録します。
サウンドエフェクト: ストーリーボードの任意のビートに SFX が必要な場合、それらを特定し、audio_meta.json の該当するフレームエントリにリストします。
出力: audio_meta.json ファイルを <PROJECT_ROOT>/ に作成します。形式は ../hyperframes-core/references/audio-contract.md に従います。
ゲート: audio_meta.json が存在し、必要なすべてのオーディオタイプ(ナレーション用の声、BGM、該当する場合は SFX)のエントリが含まれていること。オーディオ契約に従って検証します。
ステップ 4: ビジュアルデザイン
目標: ストーリーボードを、各フレームの具体的なビジュアル記述で拡張します。
../hyperframes-core/references/creative-brief.md(創造的な方向性と制約)を読んでください。このステップでは、../hyperframes-animation/blueprints/ から関連するブループリントで STORYBOARD.md の各ビートを拡張します。ブリーフ契約 § 1 の「ブループリント」ゲートタイプに注意してください — ステップ 5 に進む前に、このゲートはそれ自体を通過する必要があります。
各ビートについて:
- ビートの目的に最も適したブループリントを
../hyperframes-animation/blueprints/から特定します。 - ブループリントからの視覚的なコンポーネント(レイアウト、アニメーション、トランジション)をビートに適用します。
- アセットの割り当てを指定します(
capture/からのアセット、生成されたアセット、またはプレースホルダー)。 - フレームの視覚的なスタイルと構成を説明します。
frame.mdのデザイントークン(色、タイポグラフィ、間隔)を使用します。
STORYBOARD.md を拡張された情報で更新します。ブループリント参照で定義されているように、フレームレイアウトフィールドを追加します。必要な場合を除き、ビート番号を変更したり、新しいビートを導入したりしないでください。
hyperframes-core/references/storyboard-format.md に従って、各フレームに frame_layout フィールドを追加します。これには、レイアウトタイプ、アセット参照、および ../hyperframes-animation/blueprints-index.md のブループリント定義からのアニメーションヒントが含まれます。
注: ビジュアルデザイン出力をデフォルトで STORYBOARD.md に挿入します。編集せず、ユーザーに尋ねないでください。設計とモーションのルールは STORYBOARD.md 内の frame_layout フィールドにカプセル化する必要があります。
ゲート: すべてのストーリーボードビートに frame_layout フィールドが入力され、ブループリントが割り当てられ、視覚的な説明があること。ゲートは自律的に通過します。
ステップ 5: フレーム
目標: 各フレームを compositions/frames/NN-*.html として構築します。
このタスクはフレームごとのスコープに委任されます。関連するブループリント、../hyperframes-animation/rules/ のルール、および frame.md を使用して各フレームをレンダリングするために、フレームごとに 1 つのサブエージェントをディスパッチします。各フレームのアセットの割り当てに従います。frame.md とブループリントの色とタイポグラフィを使用します。frame.md のレイアウト仕様に従います。frame.md とブループリントで指定されたアニメーションを使用します。アセットがない場合は、プレースホルダーまたは生成されたグラフィックを使用します。結果を compositions/frames/NN-*.html に保存します。ここで、NN は先頭ゼロが埋め込まれたフレーム番号です。
すべてのフレームが完了したら、compositions/index.html を作成します。これは HyperFrame プレーヤーを含み、順番に各フレームをロードするオーケストレーションページです。../hyperframes-animation/rules/builder-rules.md を参照して、indev.html をアセンブルするための「フレームアセンブリ」セクションを確認します。
最終的なフレーム出力を確認します:
- すべてのフレームが意図したすべてのビートをカバーしていますか?
- すべてのフレームにアセットがありますか?(不明な部分がない)
- すべてのフレームが正しいデザインスキームに従っていますか?
- オーケストレーションページ(index.html)はありますか?
- すべてのフレームが
STORYBOARD.mdによって指定された順序になっていますか?
ゲート: compositions/frames/ 内のすべてのフレームが存在し、index.html が存在し、すべてのフレームが指定された設計およびレイアウトルールに従っていること。
ステップ 6: 最終レンダリング
目標: 完成したビデオをレンダリングし、プレビューを提供します。
compositions/ ディレクトリからビデオをレンダリングします:
npx hyperframes render ./compositions --output ./renders/video.mp4
レンダリング後、出力を確認します:
- ファイルが存在すること
- 長さが
STORYBOARD.mdの見積もりと一致する(完全にではないにしても近い)こと - 品質が許容可能であること
プレビューと承認のためにリンクをユーザーに提示します。 これにより、ユーザーはレンダリングされたビデオを確認し、フィードバックを提供できます。フィードバックに基づいて調整を行います(これは、フレーム、ストーリーボード、デザイン、キャプチャ、およびセットアップのレベルでのイテレーションを含むことができます)。
ゲート: レンダリングされたビデオが存在すること。ユーザーが承認したこと(協調モードの場合)、または自律的に通過したこと。