ウェブサイトから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
サイトをキャプチャし、抽出されたデータを読んでブランドと製品を理解します — 何をするのか、誰のためのものか、どのようなトーンで話すのか、どのようなムードを持つのか。キャプチャされたアセットは後で使用するブランドツールキットであり、ビデオを構成する構成要素ではありません。
ゲート: サイトサマリーが出力される — アセット/カラー/フォントのインベントリの前に、戦略ファースト(製品が何をするか、誰のためか、ブランドボイス)で記述。
ステップ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(目次をスキャン — 詳細セクションは必要に応じてのみ深掘り)
ビジュアルやアセットの話をする前に、ビデオが何を伝えなければならないかについてユーザーと調整します。ユーザーのプロンプトを解析します — おそらくユーザーはすでにビデオのタイプとスタイルを指定しています。不足しているものだけを質問します:このビデオが伝えるべき唯一のメッセージ、ナラティブアーク、そして対象視聴者。
ゲート: ビデオタイプ、長さ、フォーマット、そして — 重要なのは — メッセージとナラティブアークが確定していること。これらがないと、ステップ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 スキル内にあります) |