media-use: オーディオ/画像のソーシングの前に、
/media-useを呼び出してHeyGenカタログからBGM/効果音/画像を取得します。既存のアセットを登録するには、最初に--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とローカルエンジンのどちらを使用するか、またサインインしていない場合のサインイン方法が報告されます。サインインしていない場合は、ブリーフやその他を尋ねる前に停止し、ユーザーが選択するのを待ちます — サインインするか、「go」/「offline」と言ってローカルエンジンを続行するか。 これは単なる通過点ではなく、実際の決定ポイントとして扱います。選択をブリーフの質問に折り込んだり、リポジトリごとの .env にキーを書き込んだりしないでください。(自律モードでは、ステータスを記録し、オフラインで続行します。)標準的なガイダンスについては ../hyperframes-media → Preflight を参照してください。
ゲート: サイトサマリーが印刷されている — アセット/カラー/フォントのインベントリよりも先に、戦略ファーストで(製品が何をするか、誰のためのものか、ブランドボイス);サインインステータスが表示されている(サインインしている、またはオフラインで続行)。
ステップ1: ブランドアイデンティティ
読む: references/step-1-design.md
DESIGN.mdを書く — 視覚的アイデンティティをカバーするブランドのチートシート:色、タイポグラフィ、コンポーネントスタイル、レイアウトの原則。正確な計算値には design-styles.json を使用します。
速度オプション: 高速なビデオ(ビルボードごとのビート)の場合、DESIGN.mdは50行のカラー+フォント+Do's/Don'tsのサマリーでよく、300行のドキュメントは必要ありません。ステップ5のサブエージェントプロンプトはブランド値を直接貼り付けるため、DESIGN.mdの深さは複雑なコンポジションに対してのみ重要です。
ゲート: DESIGN.md が存在する(任意の長さで)最低限:カラーパレット、フォントの選択、Do's/Don'ts。
ステップ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セクション)。ブリーフ中に目次をざっと見て、ビルド中に特定のセクションを深掘りする |
| 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スキル内に存在) |