プラグインのインストール: セットアップや更新コマンドの前に、このスキルがHyperFramesプラグイン内にある場合は、プラグイン実行ルールに従ってください。スタンドアロンインストールの場合は、以下の更新手順をそのまま使用します。
まず、このスキルを最新に保つ — ユーザーに確認してから実行:
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()バインディングをスキップするため、後でブランドが変更された場合、完全な再インポートなしでは伝播できません。
製品ローンチからHyperFramesへ
このスキルを使用して、製品をキャプチャし、ブランドを理解し、ローンチビデオを計画し、HyperFramesでフレームごとに構築します。
正面玄関は
/hyperframesです。 あなたはオーケストレーターです。各ステップを実行し、ゲートを確認してから次のステップに進みます。このスキルはマーケティング、ローンチ、プロモーション、または公開される製品向けであり、「私たちのサイトのプロモーション」のようなリクエストも、その目的がプロモーションである限り含まれます。サイトツアー/ショーケースのリクエストもここに留まります:BRIEF.mdは「ありのまま表示」の意図を保持し、キャプチャされたスクリーンショットがビデオで紹介されるアセットになります。その他の意図、単なる「ビデオを作って」、または不確実な場合 → 最初に/hyperframesを読んでください — インテントレイヤーがすべてのルート決定を所有し、BRIEF.mdなしでここに到着した新規作成も、とにかくそれを通過します(セットアップの開始ルール)。
あなたはオーケストレーターです。videos/<project>/で作業します。手順を順番に実行し、各ゲートを通過してから続行します。ユーザーゲートはステップ0、ステップ3、およびステップ6です。ステップ0の前に../hyperframes/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上の最新と比較し、いずれかが古い場合はグローバルセットを更新します。
initの後、<PROJECT_ROOT>をvideos/<project>とし、後続のすべての相対パスコマンドをそのディレクトリを作業ディレクトリとして実行します。以下のコマンドでは、.は<PROJECT_ROOT>を意味します。呼び出し元ディレクトリに.media、capture、または出力ファイルを書き込まないでください。
initの直後にBRIEF.mdを書き込みます(決して前ではありません — initは空でないディレクトリを拒否します):インテントレイヤーのロックされた概要、形状は../hyperframes/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 § プロバイダー。
ゲート: 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キャプチャが失敗した後、合成されたキャプチャなしフォールバックを作成しないでください。キャプチャなしパスは、元の概要がソースマテリアルを提供した場合、またはユーザーが失敗後に提供されたスクリーンショットまたは概要に明示的に切り替えた場合にのみ続行します。
非常に少ないテキストコンテンツなどの警告と空のアセットカタログは、使用可能なページの証拠ではありません。サイトツアーまたは「ありのまま表示」の概要の場合、信頼できるキャプチャ構造または提供されたスクリーンショットが必要です。どちらも存在しない場合は停止します。キャプチャが使用できないという理由だけで、ページを発明または再構築しないでください。
サイトツアーまたは「ありのまま表示」の概要の場合、キャプチャされたページが視覚的な真実のソースです。完全なWebサイトをHTMLで再構築する代わりに、実際のスクリーンショットを使用します。ショットに内部動作が必要な場合は、スクリーンショットをベースとして保持し、測定された位置に実際のキャプチャされたアセットをオーバーレイするか、動く1つのコンポーネントのみを再構築します。スクロールショットの場合、capture/screenshots/full-page.png上でビューポートをアニメーション化します — ドキュメント全体の1倍プレート、1920幅のビューポートがそれを下って移動するピクセル精度。ページが高すぎて一度にキャプチャできなかった場合は存在しません。その場合は、同じディレクトリ内の重複するスクロール位置ショットにフォールバックします。1倍を超えてズームインするには、その領域の独自の2倍キャプチャが必要です。プレートには1倍を超える余裕がないためです。ユーザーが明示的に様式化された解釈を要求した場合にのみ、ページ全体を再作成します。使用できないキャプチャだけでは許可されません。
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 <名前> --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/references/storyboard-format.md、および../hyperframes/references/script-format.mdを読んでください。それらを使用してSTORYBOARD.mdを書き、ナレーションが必要な場合はSCRIPT.mdを書きます。フロントマターのduration:を概要のlengthから設定します — 大まかな期待値。アセンブリは、カットがそれに対してどこに着地するかを報告します。
ストーリーボード、フック、説得ロジック、ビート、VO_MODE、およびアセットの選択にはstory-design.mdを使用します。ソフトガイドとして、../hyperframes-animation/blueprints-index.mdの役割→ブループリントメニューを参照します:各ビートについて、適切なブループリントIDを候補としてメモします。どのビートが存在するかは、ストーリーの真実が依然として決定します — ブループリントに合わせるためにビートを強制したり、実績のある形状が利用可能だからといってビートを発明したりしないでください。各ビジュアルフレームのasset_candidatesをcapture/extracted/asset-descriptions.md(正規のインベントリ)から選択します — 生のcapture/assets/をブラウズしないでください。そのインベントリが欠落しているか使用できない場合を除き、ユーザーにアセットを選択するよう求めないでください。ストーリーボードとスクリプトリファレンスからの正確な必須フィールドを使用します。
下書き後、レビューループの計画パスを実行します — ../hyperframes/references/review-loop.md § 1:計画を提案として提示し、2つの質問をします — 承認するか変更するか、そして最初にスケッチ(推奨)またはスキップ。フィードバックはチャット返信として届きます。承認されるまでループします。これはチェックポイントゲートです(概要契約§1):自律モードでは、計画を提示し、応答を待ち、適用して続行します。協調モードでは、提案と共にブロックを一時停止します。どちらのモードでも、ゲートはユーザーに制御を譲ります。次のステップに進む前に、ストーリーボードが承認されていることを確認します(または編集モードで同意の下で作業していることを確認します)。
ステップ3.1: オーディオ
目標: ビデオ用の音声/ナレーション、BGM、およびSFXオプションを選択します。
../hyperframes-creative/references/audio-spec.mdを読み、その指示に従ってaudio_meta.jsonを記入します。capture/extracted/asset-descriptions.mdを潜在的なオーディオアセット(公式サウンドファイル?)として使用します。/media-useスキルを呼び出して、HeyGenカタログから利用可能なBGM/SFXオプションを取得します。audio_meta.jsonが存在する場合、ゲートは合格します。
ステップ4: ビジュアルデザイン
目標: STORYBOARD.mdを設計仕様で充実させ、各フレームのビジュアルルックを決定します。
../hyperframes-creative/references/visual-design-spec.mdを読みます。各フレームのストーリーボードエントリを以下で拡張します:レイアウト、配色(frame.mdから派生)、タイポグラフィ、アニメーションのヒント、およびアセットの配置。これにより、各フレームの構築に十分な詳細が得られます。
このステップには、スケッチ/モックアップ生成が含まれる場合があります。自律モードでは、自動的に生成して埋め込みます。協調モードでは、変更のためにユーザーに提示します。
ステップ5: フレーム
目標: 各フレームのHTMLファイルを生成します。
フレームごとに1つのサブエージェントをディスパッチします。各サブエージェントは、frame.md、拡張されたSTORYBOARD.mdからのそのフレームのエントリ、audio_meta.json、および../hyperframes-animation/rules/ + ../hyperframes-animation/blueprints/からのルールを受け取ります。サブエージェントはcompositions/frames/NN-<スラッグ>.htmlを生成します。各フレームが生成された後、品質をチェックし、必要に応じて修正します。
すべてのフレームが完了したら、compositions/index.htmlを生成し、すべてのフレームをまとめます。これはフレームシーケンサーとして機能し、自動進行と制御を可能にします。
ステップ6: 最終レンダリング
目標: 承認のためにビデオプレビューをレンダリングし、その後最終的な高品質ビデオをレンダリングします。
レビューループのレンダリングパスを実行します — ../hyperframes/references/review-loop.md § 2:compositions/index.htmlを提示し、承認または変更を求めます。このステップは最終レンダリング前にブロックします(チェックポイントゲート)。承認されたら、npx hyperframes render ./compositions/index.html -o ./renders/video.mp4を実行します。出力ファイルを確認します。
ゲート: renders/video.mp4が存在し、再生可能です。