media-use: オーディオ/画像をソースする前に、
/media-useを呼び出してHeyGenカタログからBGM/SE/画像を解決します。既存のアセットを登録するには、最初に--adoptを実行します。/media-useスキルを参照してください。
Product Launch to HyperFrames
このスキルを使用して、製品をキャプチャし、そのブランドを理解し、ローンチビデオを計画し、HyperFramesでフレームごとに構築します。
ステップ0の前にルートを確認します。 あなたはオーケストレーターです。各ステップを実行し、そのゲートを確認してから、次のステップに進みます。このスキルは、販売、ローンチ、プロモーション、または公開される製品を対象としています。これには、「当サイトのプロモーション」などのプロモーションを目的としたリクエストも含まれます。他の意図は別の場所にルーティングします。一般的な非ローンチのWebサイトツアー ->
/website-to-video、製品を伴わないトピック説明 ->/faceless-explainer、GitHub PR ->/pr-to-video、既存の映像へのキャプション ->/embedded-captions、短いナレーションなしのモーショングラフィック ->/motion-graphics。ユーザーが「ビデオを作って」とだけ言った場合、またはルートが不明な場合は、最初に/hyperframesを読んでください。
あなたはオーケストレーターです。videos/<プロジェクト>/ で作業します。ステップを順番に実行し、続行する前に各ゲートを通過します。ユーザーゲートのステップは、ステップ0、ステップ3、およびステップ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プロジェクトを作成します。
hyperframes.json が存在しない場合にのみ初期化します。ブランドまたはドメインから <プロジェクト> にケバブケースで名前を付けます(例: acme-promo)。ワークスペース名やタイムスタンプは使用しないでください。
npx hyperframes init "videos/<プロジェクト>" --non-interactive --example=blank — init は、インストールされているスキルをGitHubの最新版と照合し、古いものがあればグローバルセットを更新します。
概要の前にサインインステータスを表示します — npx hyperframes auth status を実行し、その出力をそのまま中継します(言い換えたり書き換えたりしないでください)。 これにより、音声/BGMがHeyGenを使用するかローカルエンジンを使用するか、およびサインインしていない場合のサインイン方法が報告されます。サインインしていない場合は、停止してユーザーが選択するのを待ちます — サインインするか、「go」/「offline」と言ってローカルエンジンで続行するか — その後に概要やその他を質問します。 これは単なる通過点ではなく、実際の決定ポイントとして扱ってください。選択を概要の質問に含めたり、キーをリポジトリごとの .env に書き込んだりしないでください。(自律モードでは、ステータスをメモしてオフラインで続行します。)../hyperframes-media → Preflight の信頼できるガイダンスを参照してください。
ゲート: hyperframes.json が存在し、アングル、長さ、アスペクト比、言語がロックされており、サインインステータスが表示されている(サインインしているか、オフラインで続行している)。
ステップ1: アセットのキャプチャ
目標: ビデオのソースマテリアル、ブランドシグナル、および使用可能なアセットを収集します。
入力を分類し、パスを選択します。明示的なURL -> それをキャプチャし、そのサイトをナレーションとアセットに使用します。ペーストされたスクリプト/概要 -> user_script.txt としてそのまま保存し、一度「そのまま使用するか、再構成するか?」と質問し、回答を VO_MODE として保存し、キャプチャターゲットを解決します: テキスト内のURL -> それを使用; ブランド名のみ -> WebSearch、1行でURLを確認してからクロール; URL/サイトなし -> キャプチャなしのパス。
キャプチャを実行: npx hyperframes capture "<URL>" -o ./capture
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 には、ユーザーがアセットに関するメモを提供しない限り、キャプチャされたアセットはないと記載する必要があります。
ゲート: capture/extracted/tokens.json、capture/extracted/visible-text.txt、capture/extracted/asset-descriptions.md、および capture/assets/ が存在し、ブランドを明確な一文で述べることができること。asset-descriptions.md を主要なアセットインベントリとして扱います。実際のキャプチャ後にこれがない場合は、停止してキャプチャが不完全であることを報告します。capture/BLOCKED.md が存在する場合は、それに従います。
ステップ2: デザインシステム
目標: 出荷済みのフレームプリセットを1つ選択します。スクリプトにより、これがこのビデオの frame.md + キャプションスキンに変換されます。
あなたは唯一の判断を下します — どのプリセットか。 ../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 がキャプションスキンソースとして存在する。
ステップ3: ストーリーボードとスクリプト
目標: 概要とキャプチャされたマテリアルを、承認されたフレームごとのストーリープランに変換します。
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 も作成します。
ストーリープラン、フック、説得ロジック、ビート、VO_MODE、およびアセットの選択には story-design.md を使用します。ソフトガイドとして、../hyperframes-animation/blueprints-index.md の役割→ブループリントメニューを参照します: 各ビートについて、該当するブループリントIDが存在する場合はそれをメモします。ストーリーの真実がどのビートが存在するかを決定します — ブループリントに合わせるためにビートを強制したり、実績のある形状が利用可能だからといってビートをでっち上げたりしないでください。各ビジュアルフレームの asset_candidates を capture/extracted/asset-descriptions.md(正規のインベントリ)から選択します — 生の capture/assets/ を閲覧しないでください。そのインベントリが欠落しているか使用できない場合を除き、ユーザーにアセットを選択するよう求めないでください。ストーリーボードとスクリプトのリファレンスから必要な正確なフィールドを使用します。
ドラフト後、フレームごとのサマリーを表示します。同じメッセージで、ユーザーに2つのことを尋ねます: (a) 承認するか変更をリクエストするか、(b) ストーリーボードスキャフォールドのライブプレビューが必要か(npx hyperframes preview) — 「はい」の場合のみ開きます。承認されるまで繰り返し、プレビューの選択をステップ6に引き継ぎます。
ゲート: STORYBOARD.md が存在し、すべてのビジュアルフレームに asset_candidates があり、ナレーションが必要な場合は SCRIPT.md が存在し、ユーザーがフレームごとのプランを承認した。
ステップ3.1: オーディオ
目標: 承認されたスクリプトから、ナレーション、単語のタイミング、音楽、およびオーディオメタデータを生成します。
ステップ3の承認後にオーディオを開始します。バックグラウンドで実行し、ステップ4に進みます。
node <SKILL_DIR>/scripts/audio.mjs --script ./SCRIPT.md --storyboard ./STORYBOARD.md --hyperframes . --out ./audio_meta.json &
オーディオスクリプトは、ナレーション、単語のタイミング、HeyGenの音楽ライブラリからのBGMルックアップ、およびタイミングメタデータを処理します。BGMのムードはストーリーボードの music: フィールドから取得されます。これは、生成ではなく取得にHeyGen Audio APIを使用し、TTSと同じ ~/.heygen 資格情報を使用します。プロバイダーの詳細については、../hyperframes-media/references/tts.md を読んでください。
ナレーションがなく、SCRIPT.md もない場合は、音声生成をスキップします。ストーリーボードに音楽のムードがある場合は、BGMが実行されることがあります。
ゲート: オーディオジョブが開始されたか、プロジェクトが無音としてマークされている。
ステップ4: フレームビジュアルデザイン
目標: 各ストーリーボードフレームに、ビジュアルディレクション、レイアウト意図、およびモーションの選択を追加します。
STORYBOARD.md をその場で編集します。別のストーリーボードを作成しないでください。色、タイポグラフィ、レイアウトの感触、スタイルについては、frame.md を信頼できる情報源として使用します。
references/visual-design.md、../hyperframes-animation/blueprints-index.md、references/motion-language.md、および ../hyperframes-animation/rules-index.md を読んでください。メソッド(タイムコード化されたショットシーケンス、インラインのLayout語彙、および必須の ## Video direction ブロック)については visual-design.md を使用します。各フレームのショット形状を選択するには、../hyperframes-animation/blueprints-index.md を使用します。モーションについては、motion-language.md(モーション語彙 + モーション原則)および ../hyperframes-animation/rules-index.md(有効なルール名)を使用します — モーション名をでっち上げないでください。
すべてのビジュアルフレームについて、visual-design.md のメソッドに従って、STORYBOARD.md にタイムコード化されたショットシーケンスを記述します: フレームのブループリントを選択(または構成)し、この製品のコンテンツでインスタンス化し、各Sceneのリビールをボイスオーバーにペーシングして、フレームが全期間にわたって展開され、最初に詰め込んでからフリーズしないようにします。レイアウトとモーションをSceneごとにインラインで記述します(語彙は visual-design.md および motion-language.md にあります)。ビデオ全体にわたる ## Video direction ブロックを1つ追加します。
ストーリー、スクリプト、アセットの選択、asset_candidates、transition_in、またはキャプチャされたソースマテリアルは変更しないでください。このステップではHTMLを作成しないでください。
ビジュアルデザインがロックされた後、名前付きアセットをステージングします:
node <SKILL_DIR>/scripts/stage-assets.mjs --storyboard ./STORYBOARD.md --hyperframes .
ゲート: すべてのビジュアルフレームに、リビールがボイスオーバーにペーシングされたタイムコード化されたショットシーケンスがある(最初に詰め込まない); ## Video direction が存在する; assets/ に名前付きアセットが含まれている。
ステップ5: フレームの構築
目標: すべてのストーリーボードフレームをHTMLコンポジションとして構築し、再生可能なビデオをアセンブルします。
オーディオが開始された場合は、ステップ3.1のオーディオが終了するのを待ちます。次に、持続時間を同期し、SEをフェッチします。サイレントの場合は両方をスキップします。
node <SKILL_DIR>/scripts/audio.mjs sync-durations --audio-meta ./audio_meta.json --storyboard ./STORYBOARD.md
node <SKILL_DIR>/scripts/audio.mjs fetch-sfx --storyboard ./STORYBOARD.md --hyperframes .
持続時間の同期は機械的です: 実際の音声の持続時間が優先されます。サイレントフレームは推定値を保持します。同期された持続時間を手動で編集しないでください。
ディスパッチの前に、sub-agents/frame-worker.md および ../hyperframes-core/references/subagent-dispatch.md を読んでください。フレームごとに1つのサブエージェントを、可能であれば並列でディスパッチします。それ以外の場合は、ワーカーをウェーブで実行します。各ワーカーは正確に1つのフレームを取得します。
各ワーカーのコンテキストには、PROJECT_DIR、frame_id、キャンバスサイズ、キャプションステータスと、キャプションが有効な場合のキープアウトバンド、および RULES_DIR としてこのスキルの ../hyperframes-animation/rules/ への絶対パスを含める必要があります。各ワーカーは、frame.md、STORYBOARD.md からの独自の ## Frame N ブロック、引用された各モーションのローカルルールレシピ(../hyperframes-animation/rules/<id>.md)、およびフレームのブループリントテンプレート(../hyperframes-animation/blueprints/<id>.md)を読み取ります。各ワーカーは compositions/frames/NN-*.html のみを書き込みます。ワーカーは STORYBOARD.md を編集してはなりません。
各ワーカーが戻ってくると、オーケストレーターはそのフレームを STORYBOARD.md で animated としてマークします。
オーディオタイミングが存在した後、バックグラウンドでキャプションを構築し、インデックスをアセンブルします:
node <SKILL_DIR>/scripts/captions.mjs build --storyboard ./STORYBOARD.md --audio-meta ./audio_meta.json --hyperframes . --out ./caption_groups.json &
node <SKILL_DIR>/scripts/assemble-index.mjs --storyboard ./STORYBOARD.md --hyperframes .
captions.mjs は、frame.md からのブランドトークンを注入して、プロジェクトの .hyperframes/caption-skin.html(ステップ2でコピー)をキャプションルックとして使用します。スキンが存在しない場合は、組み込みのデフォルトピルをレンダリングします。captions: skipped (<理由>) は有効です。明示的にスキップされた場合は、キャプションなしで続行します。
ゲート: すべてのフレームが animated としてマークされ、index.html が存在し、キャプションが構築されているか明示的にスキップされている。
ステップ6: 最終確定
目標: アセンブルされたビデオを確認し、ユーザーの承認を得て、最終的なMP4をレンダリングします。
トランジションを注入し、チェックを実行し、レビューのために一時停止し、レンダリングします。
node <SKILL_DIR>/scripts/transitions.mjs inject --storyboard ./STORYBOARD.md --hyperframes .
node <SKILL_DIR>/scripts/transitions.mjs verify --storyboard ./STORYBOARD.md --index ./index.html
npx hyperframes lint
npx hyperframes validate
npx hyperframes inspect
npx hyperframes snapshot --at <フレーム中間点>
snapshot は、キャプチャされたフレームを1枚のコンタクトシート(snapshots/contact-sheet.jpg)にまとめます。ちらりと見て、明らかに壊れているものがなければ、先に進みます — ここで長居しないでください。
コマンドが失敗した場合は、stderrを表示して停止します — リカバリコマンドを重ねないでください。自分で修正します: compositions/frames/NN-*.html への最も安全な編集を行い、失敗したチェックを再実行します。
チェックが通過した後、ユーザーレビューのために一時停止します。ビデオはアセンブルされ、Studioで表示および編集可能です。ステップ3とステップ6にわたってプレビューを1回だけ管理します: ユーザーが以前に要求した場合は開き、以前に断った場合は提供し、すでにStudioでレビューしている場合は再度尋ねません。
プレビュー: npx hyperframes preview
レンダリング
…
[翻訳のため省略]