media-use: オーディオ/画像を取得する前に、
/media-useを呼び出してHeyGenカタログからBGM/SFX/画像を解決してください。最初に--adoptを実行して既存のアセットを登録します。詳細は/media-useスキルを参照してください。
プロダクトローンチからHyperFramesへ
このスキルを使用して、製品をキャプチャし、そのブランドを理解し、ローンチビデオを計画し、HyperFramesでフレームごとに構築します。
ステップ0の前にルートを確認してください。 あなたはオーケストレーターです。各ステップを実行し、そのゲートを確認してから次のステップに進んでください。このスキルはマーケティング、ローンチ、プロモーション、または公開される製品を対象としています。「私たちのサイトのプロモ」などのリクエストもプロモーション目的であれば含まれます。それ以外の意図は別のルートに振り分けてください:一般的な(ローンチではない)ウェブサイトツアー →
/website-to-video;製品のないトピック解説 →/faceless-explainer;GitHub PR →/pr-to-video;既存の映像へのキャプション →/embedded-captions;短いナレーションなしのモーショングラフィック →/motion-graphics。ユーザーが単に「動画を作って」と言った場合やルートが不明な場合は、最初に/hyperframesを読んでください。
あなたはオーケストレーターです。videos/<project>/ で作業します。ステップを順番に実行し、各ゲートを通過してから続行してください。ユーザーゲートはステップ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 がない場合のみ初期化します。<project> はブランド名やドメインからケバブケースで命名します(例:acme-promo)。ワークスペース名やタイムスタンプは使用しないでください。
npx hyperframes init "videos/<project>" --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、URLを1行で確認し、クロール;URL/サイトなし -> キャプチャなしパス。
キャプチャの実行: npx hyperframes capture "<URL>" -o ./capture
GEMINI_API_KEY、GOOGLE_API_KEY、またはOpenRouterキーが存在する場合、capture はアセットを自動的にキャプションし、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/ が存在すること。ブランドを1つの明確な文で述べられること。asset-descriptions.md を主要なアセットインベントリとして扱います。実際のキャプチャ後にそれが欠落している場合は、停止してキャプチャが不完全であることを報告します。capture/BLOCKED.md が存在する場合は、それに従います。
ステップ2: デザインシステム
目標: 出荷済みのフレームプリセットを1つ選択します。スクリプトがそれをこのビデオの frame.md + キャプションスキンに変換します。
あなたは唯一の判断を下します — どのプリセット を使用するか。../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 がキャプションスインソースとして存在すること。
ステップ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 を読みます。メソッド(時間コード化ショットシーケンス、インラインのレイアウト語彙、必要な ## Video direction ブロック)については visual-design.md を使用します。各フレームのショット形状を選択するには ../hyperframes-animation/blueprints-index.md を使用します。モーションについては motion-language.md(モーション語彙 + モーション原則)および ../hyperframes-animation/rules-index.md(有効なルール名)を使用します — モーション名を発明しないでください。
すべてのビジュアルフレームについて、visual-design.md のメソッドに従って STORYBOARD.md に時間コード化ショットシーケンスを記述します:フレームのブループリントを選択(または構成)し、この製品のコンテンツでインスタンス化し、各シーンの表示をボイスオーバーに合わせてペーシングし、フレームが全期間にわたって展開され、最初に詰め込んでからフリーズしないようにします。レイアウトとモーションはシーンごとにインラインで記述します(語彙は visual-design.md と motion-language.md にあります)。1つのビデオ全体の ## Video direction ブロックを追加します。
ストーリー、スクリプト、アセットの選択肢、asset_candidates、transition_in、またはキャプチャされたソース素材は変更しないでください。このステップではHTMLを作成しないでください。
ビジュアルデザインが確定した後、名前付きアセットをステージングします:
node <SKILL_DIR>/scripts/stage-assets.mjs --storyboard ./STORYBOARD.md --hyperframes .
ゲート: すべてのビジュアルフレームに時間コード化ショットシーケンスがあり、その表示がボイスオーバーに合わせてペーシングされていること(先頭に詰め込んでいない);## Video direction が存在すること;assets/ に名前付きアセットが含まれていること。
ステップ5: フレームの構築
目標: すべてのストーリーボードフレームをHTMLコンポジションとして構築し、再生可能なビデオを組み立てます。
オーディオが開始された場合は、ステップ3.1のオーディオが終了するのを待ちます。その後、期間を同期し、SFXを取得します。無音の場合は両方をスキップします。
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 はプロジェクトの .hyperframes/caption-skin.html(ステップ2でコピー)をキャプションルックとして使用し、frame.md からのブランドトークンを注入します;スキンがない場合は、組み込みのデフォルトピルをレンダリングします。captions: skipped (<reason>) は有効です。明示的にスキップされた場合はキャプションなしで続行します。
ゲート: すべてのフレームが 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 <frame-midpoints>
snapshot はキャプチャされたフレームを1つのコンタクトシート(snapshots/contact-sheet.jpg)に結合します。一目で確認し、明らかに壊れているものがなければ先に進みます — ここで長居しないでください。
コマンドが失敗した場合は、stderrを表示して停止します — リカバリコマンドを積み重ねないでください。自分で修正します:compositions/frames/NN-*.html への最も安価で安全な編集を行い、失敗したチェックを再実行します。
チェックが通過した後、ユーザーレビューのために一時停止します。ビデオは組み立てられ、Studioで表示および編集可能です。ステップ3とステップ6でプレビューを1回だけ管理します:ユーザーが以前に要求した場合は開き、以前に断った場合は提供し、すでにStudioでレビューしている場合は再度尋ねません。
プレビュー:npx hyperframes preview
レンダリング...