プラグインのインストール: セットアップやフレッシュネスコマンドを実行する前に、このスキルがHyperFramesプラグイン内にある場合は、プラグインインストールルールに従ってください。スタンドアロンインストールの場合は、以下の更新手順をそのまま使用します。
最初に、このスキルを最新に保つ — ユーザーに確認してから以下を実行:
npx hyperframes skills update product-launch-video。すべてが最新の場合は高速で何も実行されません。そうでない場合は、このスキルと、それが依存するコアドメインスキルを、それらに依存する前に更新します。
media-use: オーディオ/画像/ロゴを調達する前に、
/media-useを呼び出して、HeyGenカタログからのBGM/SFX/画像と、公式ソースからのブランドロゴを解決します。既存のアセットを登録するには、最初に--adoptを実行します。/media-useスキルを参照してください。ホストアプリが独自の音楽や効果音ツールを提供している場合は、音楽と効果音にそれらを使用します。
figma source: ソースが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、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枚でキャプチャできない場合は存在しません。その場合は、同じディレクトリ内の重複するスクロール位置のショットにフォールバックします。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を指定している場合 — ユーザーがインテントレイヤーのショーケースから目で選んだもの — それを使用します。判断は、ブリーフが沈黙している場合にのみあなたが行います。次に、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つの質問をします — 承認するか変更するか、およびスケッチを先に(推奨)するかスキップするか。フィードバックは次のように到着します
...
[訳注:原文が途中で切れています。翻訳はここまでとします。]