media-use: オーディオ/画像の調達前に
/media-useを呼び出し、HeyGenカタログからBGM/効果音/画像を解決します。既存アセットを登録するには--adoptを先に実行してください。詳細は/media-useスキルを参照してください。
ウェブサイトからHyperFramesへ
ウェブサイトをキャプチャし、そこからプロフェッショナルな動画を生成します。
ステップ0の前にルートを確認してください。 このスキルは_一般的なサイトの_ 動画を作成します。ユーザーが実際に製品をマーケティング/ローンチ/宣伝している場合(このURLからでも、「私たちのサイトのプロモーション」であっても)→
/product-launch-video。サイトなしのトピック解説 →/faceless-explainer。GitHub PR →/pr-to-video。既存動画ファイルの再編集/再カラーリング/再順序付け → 対象外。漠然とした「動画を作って」というリクエスト、またはローンチか一般サイトか不明な場合 → まず**/hyperframesを読む**(完全なルーティングテーブル + § HyperFramesでできないこと)。
ユーザーは次のように言います:
- 「このウェブサイトを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 → Preflight を参照してください。
ゲート: サイトサマリーが出力されていること — アセット/色/フォントのインベントリの前に、戦略ファースト(製品の機能、ターゲットユーザー、ブランドボイス)で記述すること。サインインステータスが表示されていること(サインイン済み、またはオフラインで続行)。
ステップ1: ブランドアイデンティティ
読む: references/step-1-design.md
DESIGN.md を作成します — ビジュアルアイデンティティ(色、タイポグラフィ、コンポーネントスタイル、レイアウト原則)をカバーするブランドチートシート。design-styles.json を使用して正確な計算値を取得します。
スピードオプション: 高速ペースの動画(ビルボード形式のビートごと)の場合、DESIGN.md は色+フォント+Do's/Don'ts の50行サマリーで済みます — 300行のドキュメントは不要です。ステップ5のサブエージェントプロンプトがブランド値を直接貼り付けるため、DESIGN.md の深さは複雑なコンポジションの場合にのみ重要です。
ゲート: DESIGN.md が存在すること(任意の長さで)最低限: カラーパレット、フォントの選択、Do's/Don'ts を含むこと。
ステップ2: 戦略とメッセージング
読む: references/step-2-brief.md、references/capabilities.md(目次をスキャン — 詳細セクションは必要な場合のみ深掘り)
ビジュアルやアセットの話をする前に、動画が伝えるべき内容についてユーザーと合意します。ユーザーのプロンプトを解析します — おそらく既に動画のタイプとスタイルが指定されています。不足しているものだけを尋ねます: この動画が必ず伝えるべき ONE THING、ナラティブアーク、および視聴者。
ゲート: 動画タイプ、尺、フォーマット、そして重要なのはメッセージとナラティブアークが確定していること。これらがないと、ステップ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-in-Canvasエフェクトの完全なコードパターン(hyperframesスキルに存在) |