プラグインのインストール: セットアップや更新コマンドを実行する前に、このスキルが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でチェーンしてワークフローを中断させないでください。以下のいずれかの分岐を適用します:
- 協調: ユーザーがサインインするか、明示的に
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、一行でURLを確認し、クロールします。URL/サイトがない場合(またはブリーフがスクレイピングしないと言っている場合)-> キャプチャなしパス。
キャプチャを実行: npx hyperframes capture "<URL>" -o ./capture --json。呼び出し元がより短い期限を所有していない限り、デフォルトのナビゲーション後予算を維持します。その場合は、ダウンストリーム作業の時間を残す正の--capture-budget <ミリ秒>を渡します。--timeoutはページナビゲーションのみを制御します。--skip-visionは、オプションの画像キャプションを意図的に無効にする場合にのみ使用します。
コマンドの結果と出力ディレクトリをすぐに検査します。ゼロ以外の終了、JSONのok: false、またはcapture/BLOCKED.mdは、キャプチャパスにとってハードストップです。記録された理由を報告し、部分的なスクリーンショット、DOM、トークン、またはアセットを消費しないでください。失敗したURLキャプチャの後に、合成の「キャプチャなし」フォールバックを作成しないでください。元のブリーフがソースマテリアルを提供した場合、またはユーザーが失敗後に提供されたスクリーンショットやブリーフに明示的に切り替えた場合にのみ、キャプチャなしパスを続行します。
very little text contentのような警告と空のアセットカタログは、使用可能なページの証拠にはなりません。サイトツアーまたは「そのまま見せる」ブリーフの場合、信頼できるキャプチャされた構造または提供されたスクリーンショットが必要です。どちらも存在しない場合は、停止します。キャプチャが使用できないという理由だけで、ページを発明したり再構築したりしないでください。
サイトツアーまたは「そのまま見せる」ブリーフの場合、キャプチャされたページが視覚的な信頼できる情報源です。スクリーンショットを、ウェブサイト全体をHTMLで再構築する代わりに使用します。ショットに内部的な動きが必要な場合、スクリーンショットをベースとして保持し、測定された位置に実際のキャプチャアセットをオーバーレイするか、動くコンポーネントのみを再構築します。スクロールショットの場合、capture/screenshots/full-page.png上でビューポートをアニメーション化します — ドキュメント全体の1倍プレート、1920幅のビューポートがそれを下って移動するためのピクセル精度です。ページが1枚でキャプチャするには高すぎた場合、これは存在しません。同じディレクトリ内の重なり合うスクロール位置ショットにフォールバックします。1: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を指定している場合 — ユーザーがインテントレイヤーでショーケースから目視で選択したもの — それを使用します。判断はブリーフが沈黙している場合のみあなたに委ねられます。その後、あなたは唯一の呼び出しを行います — どのプリセットか: ../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/references/storyboard-format.md、および../hyperframes/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/references/review-loop.md § 1: 計画を提案として提示し、2つの質問をします — 承認するか変更するか、そして最初にスケッチ(推奨)かスキップか。フィードバックはチャット返信として到着します。承認されるまでループします。これはチェックポイントゲートです(ブリーフ契約 § 1): 自律モードでは
…
[翻訳用に切り詰められました]