media-use: 音声/画像を入手する前に、
/media-useを呼び出してHeyGenカタログからBGM/SFX/画像を解決してください。最初に--adoptを実行して既存のアセットを登録します。詳細は/media-useスキルを参照してください。
ウェブサイトからHyperFramesへ
ウェブサイトをキャプチャし、そこからプロフェッショナルな動画を生成します。
ステップ0の前にルートを確認してください。 このスキルは 一般的なサイト の動画を作成します。ユーザーが実際には 製品をマーケティング/ローンチ/プロモーション している場合(このURLからでも、「当サイトのプロモーション」でも) →
/product-launch-video。サイトのないトピック解説 →/faceless-explainer。GitHub PR →/pr-to-video。既存の動画ファイルの再編集/再着色/再構成 → 範囲外。漠然と「動画を作って」と指示された場合、またはローンチか一般サイトか判断できない場合 → 最初に/hyperframesを読んでください(完全なルーティングテーブル + § HyperFramesでできないこと)。
ユーザーは次のように言います:
- 「このウェブサイトをInstagram用の15秒のソーシャルクリップにして」
- 「https://... から30秒のサイトツアー/ショーケースを作って」
- 「私たちのホームページをキャプチャして、そのビジュアルから動画を構築して」
ワークフローは7つのステップで構成されています。各ステップは次のステップのためのアーティファクトを生成します。デフォルトは協調モードで、💬 とマークされたゲートはユーザーに確認してから進みます。ユーザーが自律モード(「決めて」、「驚かせて」)を指示した場合、💬 のユーザー設定ゲートはスキップされます。詳細は step-2-brief.md を参照してください。
自律モードは「すべてのゲートをスキップする」という意味ではありません。 自律モードはユーザー設定の質問(TTSプロバイダー、声、色の強調、ビート数、音楽の有無、キャプションの有無など、エージェントがユーザーに代わって決定するもの)をカバーします。品質検証ゲートはカバーしません。以下のゲートは自律モードでもスキップ不可です:
- アセット監査(ステップ3) — コンタクトシートを確認し、各アセットのUSE/SKIPを正当化する
- ビートごとのHTML読み取り(ステップ5) — ビートごとの構造化された証拠ブロック
- DoDチェックリスト(ステップ6) — アニメーションマップ、WCAG検証、音声/モーション再生を含む
- 正直な開示セクション(ステップ6) — 最終サマリーに「確認しなかったこと」を含める必要があります
「自律モードは行動を優先するから、Xをスキップしよう」と考える場合、Xが確認ゲートであり設定の質問でないなら、その推論は誤りです。行動へのバイアスは「何を構築するか」の決定に適用され、「検証するかどうか」の決定には適用されません。
ステップ0: キャプチャとブランド理解
参照: references/step-0-capture.md
サイトをキャプチャし、抽出されたデータを読んで ブランドと製品 を理解します — 何をしているのか、誰のためのものか、どんな声で語りかけているか、どんな雰囲気か。キャプチャされたアセットは後で使用するブランドツールキットであり、動画の構成要素ではありません。
ブリーフ前にサインイン状況を表示 — npx hyperframes auth status を実行し、その出力をそのまま中継します(言い換えたり書き換えたりしないでください)。 これにより、音声/BGMがHeyGenを使用するかローカルエンジンを使用するか、またサインインしていない場合のサインイン方法が報告されます。サインインしていない場合、STOPしてユーザーが選択するのを待ちます — サインインするか、ローカルエンジンで続行するために「go」/「offline」と言う — ブリーフやその他のことを尋ねる前に。 これを通過点としてではなく、実際の決定ポイントとして扱います。選択をブリーフの質問に折り込んだり、キーをリポジトリ内の .env に書き込んだりしないでください。(自律モードでは、ステータスを記録してオフラインで続行します。)正規のガイダンスについては ../hyperframes-media → プリフライトを参照してください。
ゲート: サイトサマリーが出力されている — アセット/カラー/フォントのインベントリより先に戦略(製品が何をするか、誰のためのものか、ブランドの声)を優先。サインイン状況が表示されている(サインイン済み、またはオフラインで続行)。
ステップ1: ブランドアイデンティティ
参照: references/step-1-design.md
DESIGN.md を作成 — ビジュアルアイデンティティをカバーするブランドチートシート:色、タイポグラフィ、コンポーネントスタイル、レイアウト原則。正確な計算値には design-styles.json を使用します。
スピードオプション: テンポの速い動画(ビルボードスタイル)の場合、DESIGN.md は色 + フォント + 推奨/非推奨の50行のサマリーで十分です。300行のドキュメントは不要です。ステップ5のサブエージェントプロンプトはブランド値を直接貼り付けるため、DESIGN.md の深さは複雑なコンポジションにのみ重要です。
ゲート: DESIGN.md が存在する(任意の長さ) — 最低限、カラーパレット、フォントの選択、および推奨/非推奨を含む。
ステップ2: 戦略とメッセージング
参照: references/step-2-brief.md、references/capabilities.md(目次をスキャン — 詳細セクションは必要な場合のみ深掘り)
ビジュアルやアセットの話に入る前に、ユーザーと 動画が伝えるべきメッセージ について合意します。ユーザーのプロンプトを解析します — おそらくすでに動画タイプやスタイルが指定されています。不足しているものだけを尋ねます:この動画が伝えるべき唯一のこと、ナラティブアーク、そして視聴者。
ゲート: 動画タイプ、長さ、フォーマット、そして — 重要 — メッセージとナラティブアークが確定している。これらがなければ、ステップ3でコンセプトファーストのストーリーボードを書くことはできません。
ステップ3: ストーリーボード + スクリプト 💬
参照: references/step-3-storyboard.md
コンセプトファーストでストーリーボードを作成:メッセージ → ナラティブアーク → アークに沿ったビート → ビートごとのテクニック → 最後にブランドアクセントパス。次に、それに合わせたナレーションスクリプトを作成します。両方をビートごとのサマリーとともにユーザーに提示します。承認されるまで繰り返します。
ゲート: STORYBOARD.md + SCRIPT.md が存在し、ユーザーが計画を承認している。
ステップ4: VO、タイミング + キャプション 💬
ステップ2でナレーションなしと指定された場合 — 背景音楽について尋ね、ステップ5にスキップ。それ以外の場合:ユーザーにどのTTSプロバイダー(HeyGen TTS、ElevenLabs、Kokoro)を使用するか尋ね、音声を生成し、文字起こしし、タイムスタンプをビートにマッピングします。その後、キャプションについて尋ねます。
ゲート: (a) ナレーションが要求されておらず、ストーリーボードに手動のビートタイミングがある、または (b) narration.wav + transcript.json が存在し、ビートタイミングが実際の長さで更新されている。
ステップ5: コンポジションの構築
参照: hyperframes スキル(すべてのルールが重要なのでロードすること)
参照: references/step-5-build.md
ステップ3のストーリーボードで選択されたアーキテクチャとペーシングに従って、index.html とコンポジションを構築します。サブエージェントは、各ビートについて報告する前に hyperframes lint と hyperframes snapshot を実行します。
ゲート: すべての compositions/beat-N.html が、メインエージェントによって DESIGN.md と STORYBOARD.md に照らして上から下まで読み取られている。ビートごとのチェックリストは step-5-build.md にあります。
ステップ6: 検証と納品
参照: references/step-6-validate.md
Lint、検証、動画長に応じたスケールでスナップショットを取得し(計算式: max(beats × 3, ceil(duration_seconds / 2)))、それぞれをレビューします。問題を修正してから納品します。localhost StudioプロジェクトURLを納品 — 明示的なユーザーリクエストがあった場合のみMP4にレンダリングします。そのStudio URLは 引き渡し時のみ 表示します — これが最終的な安定したプレビューです。ビルドフェーズのスナップショットはヘッドレスであるため、ビルド中にプレビューを表示しないでください。
誇りを持って納品できるものにしてください。 引き渡す前に、自問自答してください:これを自分の名前でソーシャルメディアに投稿しますか? そうでなければ、問題を修正してください。
ゲート: npx hyperframes lint と npx hyperframes validate がエラーゼロでパスし、最終レスポンスにアクティブなStudioプロジェクトURLが含まれている。
クイックリファレンス
動画タイプ
動画タイプ別の典型的な制約 — 開始点として使用し、公式として扱わないでください。ビート数は目標範囲からではなく、コンテンツとナレーションから導き出すべきです。
| タイプ | 標準的な長さ | 長さの決定要因 | ナレーション |
|---|---|---|---|
| ソーシャル広告(IG/TikTok) | 10–15秒 | プラットフォーム制限 | 任意 |
| 製品デモ | 30–60秒 | スクリプトの長さ | フルナレーション |
| 機能発表 | 15–30秒 | 機能の複雑さ | フルナレーション |
| ブランドリール | 20–45秒 | 音楽トラック | 任意、音楽重視 |
| ローンチティーザー | 10–20秒 | フックのエネルギー | 最小限 |
ビート数は意図的にこのテーブルに含まれていません — 「ソーシャル広告 = 3-4ビート」ではなく、ストーリーボードから導き出すべきです。複雑な製品のソーシャル広告には、5つの適切なタイミングのビートが必要かもしれません。1つの強力なビジュアルテーゼを持つブランドリールには3つで十分かもしれません。
フォーマット
- ランドスケープ: 1920x1080(デフォルト)
- ポートレート: 1080x1920(Instagramストーリーズ、TikTok)
- スクエア: 1080x1080(Instagramフィード)
参照ファイル
| ファイル | いつ読むか |
|---|---|
| step-0-capture.md | ステップ0 — キャプチャ、ブランドと製品を理解、戦略ファーストのサイトサマリーを作成 |
| step-1-design.md | ステップ1 — DESIGN.md ブランドチートシートを作成(5セクション、250-350行;ビルボードスタイルのソーシャル広告向けに50行の高速パス) |
| step-2-brief.md | ステップ2 — メッセージ、ナラティブアーク、視聴者についてユーザーと合意 |
| capabilities.md | ステップ2 & 5 — HyperFramesで可能なことの完全なインベントリ(24セクション)。ブリーフ中にTOCをスキャンし、ビルド中に特定セクションを深掘り |
| step-3-storyboard.md | ステップ3 — ストーリーボード + スクリプト(統合)、ユーザーレビューゲート付き |
| step-4-vo.md | ステップ4 — TTSプロバイダーの選択、生成、タイミング |
| step-5-build.md | ステップ5 — index.html + コンポジションを構築 |
| step-6-validate.md | ステップ6 — lint、検証、スナップショット(動画長にスケール)、プレビュー |
| techniques.md | ステップ3 & 5 — コードパターン付き13のプリミティブアニメーションテクニック(コピーペーストではなく適応) |
| html-in-canvas-patterns.md | ステップ5 — HTML-in-Canvasエフェクトの完全なコードパターン(hyperframesスキル内に存在) |