media-use: オーディオ/画像を取得する前に、
/media-useを呼び出してHeyGenカタログからBGM/SFX/画像を解決します。まず--adoptを実行して既存アセットを登録してください。/media-useスキルを参照してください。
WebサイトからHyperFrames動画へ
Webサイトをキャプチャし、そこからプロフェッショナルな動画を制作します。
ステップ0の前にルートを確認してください。 このスキルは 一般的なサイトの/から 動画を作成します。ユーザーが本当に 製品をマーケティング/ローンチ/プロモーション している場合(このURLからであっても、「弊社サイトのプロモーション」であっても)→
/product-launch-video。サイトのないトピック解説 →/faceless-explainer。GitHub PR →/pr-to-video。既存動画ファイルの再カット/再着色/並び替え → 対象外です。「動画を作って」という曖昧な指示、またはローンチか一般サイトか不明な場合? まず/hyperframesを読んでください(完全なルーティング表 + § HyperFramesができないこと)。
ユーザーは次のように言います:
- 「このWebサイトを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を使用するかローカルエンジンを使用するか、またサインインしていない場合のサインイン方法を報告します。サインインしていない場合は、停止してユーザーが選択するのを待ってください — サインインするか、「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(目次をスキャン — 詳細セクションは必要な場合のみ深掘り)
ビジュアルやアセットの話をする前に、ユーザーと 動画が伝えるべきこと を一致させます。ユーザーのプロンプトを解析します — おそらくユーザーはすでに動画の種類とスタイルを指定しています。不足しているものだけを尋ねます:この動画が必ず伝えるべき唯一のこと、ナラティブアーク、そして視聴者。
ゲート: 動画の種類、 duration、フォーマット、そして — 重要なのは — メッセージとナラティブアークが確定していること。これらがなければ、ステップ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 が存在し、ビートタイミングが実際のdurationで更新されている。
ステップ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が含まれていること。
クイックリファレンス
動画タイプ
動画タイプ別の典型的な制約 — 公式としてではなく、出発点として使用してください。ビート数は、目標範囲からではなく、コンテンツとナレーションに従うべきです。
| タイプ | 標準的なduration | durationの決定要因 | ナレーション |
|---|---|---|---|
| ソーシャル広告 (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セクション)。ブリーフ中に目次をスキャンし、ビルド中に特定のセクションを深掘り |
| 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インキャンバスエフェクトの完全なコードパターン(hyperframesスキルにあり) |