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サイトを15秒のInstagram用ソーシャルクリップに変換して」
- 「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(目次をスキャン — 詳細セクションは必要な場合のみ深掘り)
ビジュアルやアセットの話をする前に、ユーザーと 動画が伝えるべきこと を調整します。ユーザーのプロンプトを解析します — おそらくすでに動画のタイプとスタイルを指定しているはずです。不足しているものだけを尋ねます:この動画が必ず伝えるべき唯一のメッセージ、ナラティブアーク、そして対象視聴者。
ゲート: 動画タイプ、長さ、フォーマット、そして — 最も重要な — メッセージとナラティブアークが確定していること。これらなしでは、ステップ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(ビート数 × 3, ceil(長さ_秒 / 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セクション)。ブリーフ中に目次をスキャンし、ビルド中に特定のセクションを深掘り |
| 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 スキル内にあります) |