HyperFrames — ここから始める は何をしますか?
HyperFramesは HTML からビデオをレンダリング します。コンポジションは、DOM が data-* 属性でタイミングを宣言する HTML ファイルであり、アニメーションランタイムはシーク可能で、メディア再生はフレームワークによって管理されます。完全なオーサリング契約は /hyperframes-core にあります。コンポジション HTML を書く前にそれを読んでください。
以下は、機能マップ(オンデマンドでロードされるドメインスキル)と インテントルーター(「動画を作って」というリクエストに対するワークフローを選択)です。
機能マップ — ドメインスキル
オンデマンド でロードするアトミックな機能です。完全なビデオワークフローではありません。「動画を作って」というリクエストには、以下のインテントルーターを使用してください。
| 目的 | スキル |
|---|---|
HTML コンポジションのオーサリング / 編集 — data-* 契約、クリップ、トラック、サブコンポジション、変数 | /hyperframes-core |
| アニメーション — アトミックモーション、シーンブループリント、トランジション、ランタイムアダプター(GSAP / Lottie / Three.js / Anime.js / CSS / WAAPI / TypeGPU) | /hyperframes-animation |
クリエイティブディレクション — frame.md / design.md、パレット、タイポグラフィ、ナレーション、ビート計画、オーディオリアクティブ | /hyperframes-creative |
| メディア — TTS ナレーション、BGM、文字起こし、背景除去、キャプション | /hyperframes-media |
メディア解決 — HeyGen カタログから BGM、SFX、画像、アイコンを .media/ にマニフェストトラッキング付きで検索して固定 | /media-use |
| CLI 開発ループ — init、lint、validate、inspect、preview、render、publish、doctor | /hyperframes-cli |
レジストリブロック / コンポーネントのインストール(hyperframes add) | /hyperframes-registry |
インテントルーティング — ワークフローを選択
このセクションはトップレベルのワークフローのみを知っており、内部参照や上記のドメインスキルをロードしません。
ルーティング前 — 仕様ではなく入力を確認
ルーティングでは、ビデオの内容、つまり入力と主題を知る必要があります。それが指定されていない場合(「私たちの製品についての動画を作って」と URL、製品、トピック、アセットがない場合)、ワークフローに入る前に質問してください。ワークフローにコミットすること自体がルーティングの決定です。最大2つの質問:
- 入力 — 製品(URL / ブリーフ)、一般的なウェブサイト、GitHub PR、説明するトピック、または既存のトーキングヘッドビデオ?
仕様のデフォルト — 状態を伝え、質問しない(ルートを変更することはありません):アスペクト比 16:9(9:16 は TikTok / Reels / Shorts などの縦向きの宛先が指定されている場合のみ使用);ナレーション / キャプションの言語 = ユーザーの言語。選択されたワークフローは、最初のステップで独自の詳細を再確認します。
ワークフローチートシート
| ワークフロー | 使用シーン |
|---|---|
/product-launch-video | 製品のマーケティング / 発売 / プロモーション — URL、ブリーフ、またはスクリプトから(サイト名のみでも可) |
/website-to-video | 一般的なウェブサイトをビデオに変換 — サイトツアー、ポートフォリオ / ランディングページのショーケース、サイトのビジュアルからのソーシャルクリップ |
/faceless-explainer | テキストからトピック / コンセプトを説明 — 製品なし、URLなし;すべてのビジュアルはLLMが生成 |
/pr-to-video | GitHub PR / コード変更 → チェンジログ / 機能紹介 / 修正 / リファクタリングの解説 |
/embedded-captions | 既存のトーキングヘッドビデオにキャプション / 字幕を追加(映像はそのまま) |
/talking-head-recut | 既存のトーキングヘッドビデオをデザインされたグラフィックオーバーレイでパッケージ化 — ローワーサード、データコールアウト、キネティックタイトル、プルクォート |
/motion-graphics | 短い、ナレーションなし、デザイン主導のモーショングラフィック — キネティックタイプ、統計 / チャート表示、ロゴスティング、ローワーサードオーバーレイ |
/music-to-video | 音楽トラック → ビート同期ビデオ — リリックビデオ、スライドショー、またはキネティックプロモ;音楽がペーシングを駆動(オプションでユーザー画像 / ビデオをビートグリッドにカット) |
/slideshow | プレゼンテーション / ピッチデッキ / インタラクティブデッキ — 個別スライド、フラグメント、ブランチング、ホットスポット;出力はナビゲーション可能なデッキ、レンダリングビデオではない |
/general-video | その他すべて — より長いまたはマルチシーンの作品、静的ループ / ポスター、カスタムコンポジション |
/remotion-to-hyperframes | 既存のRemotion(React)コンポジションをHyperFramesに移植(移行、作成ではない) |
曖昧さの解消(混乱しやすい場合のみ):
- モーション優先 & ナレーションなし(約10秒未満、モーション自体がメッセージ)→
/motion-graphics、入力に関係なく。 - URL またはスクリプト — 特定の製品をマーケティング(サイト名を挙げるだけでも可)→
/product-launch-video;一般的な非製品サイト →/website-to-video;GitHub PRリンク →/pr-to-video;製品やサイトなしでコンセプトを説明 →/faceless-explainer。製品かトピックか、または発売か一般サイトかが明確でない場合は、1つ質問する。 - 既存の映像 — 単なる音声字幕 →
/embedded-captions;デザインされたオーバーレイカード →/talking-head-recut。どちらも映像自体は編集しません(再タイミング / 再色付け / 再フレーム / 再順序付け / オーディオはNLE編集 — 対象外)。 - 音楽トラックが入力(オーディオファイル、またはオーディオを抽出するビデオ)でナレーションなし →
/music-to-video— 音楽のビート / エネルギーがペーシングを駆動します。(ナレーション付きの作品は、上記の入力一致ワークフローのままです;/motion-graphicsは音楽主導ではない短いナレーションなしモーション用です。) - プレゼンテーション / ピッチデッキ / インタラクティブデッキ(個別スライド、ナビゲーション、プレゼンターモード)→
/slideshow— 出力はナビゲーション可能なデッキであり、レンダリングされたビデオではありません。明示的な「スライドショー」リクエストは直接進行します;隣接するトリガー(「デッキ / スライド / プレゼンテーション / このページを変換」)は、オーサリング前に/slideshowがスライドショーであることを確認させ、そうでない場合は適切な非スライドショーワークフローに切り替えます。 - 長さはガイドであり、制限ではない — 意図がワークフローを選択します;作品が明らかに約3分より長い場合、または静的 / ループ / カスタムフォーマットの場合のみ
/general-videoに進みます。
マッチしたワークフローがインストールされていない場合
ワークフローを選択したら、実際に利用可能かどうかを確認してください。マッチしたワークフロースキルがインストールされていない場合は、推測に頼らず、最初にインストールするようにユーザーに指示します:
- このワークフローのみ:
npx skills add heygen-com/hyperframes --skill <workflow-name>(例:--skill pr-to-video— ベア名、先頭の/なし)。 - すべてのワークフローを一度に:
npx skills add heygen-com/hyperframes --all(コア + すべてのワークフロー、ピッカーをスキップ)。
ユーザーが実行した後、ワークフローのスキルを再度読み込んで続行します。
ワークフローの詳細
/product-launch-video
- 入力: マーケティング対象の製品 — (a) 製品URL(ヘッドレスChromeでクロールしてアセット + ブランドトークンを取得)、(b) 製品のサイトをリンクなしでも名前で指定するスクリプト / ブリーフ(PLVが解決してクロールします。ユーザーがオプトアウトしない限り)、または (c) 派生可能なサイトがない / 「スクレイプしない」スクリプト(ノーキャプチャモード — パレット + デザインシステムを提供するスタイルプリセットを選択)。提供されたスクリプトは、逐語的なナレーションまたはシーンごとに再構成されたものにできます — PLVが質問します。
- 出力: 製品ローンチ / SaaSプロモーションをHyperFramesコンポジションとして → MP4。(最適な長さ30〜90秒)。
- トリガー: 「Xのローンチビデオ」、「私たちのサイトのプロモ」、「SaaSを1分で説明して」、「スクリプトを60秒のプロモに」、「テキストのみのローンチビデオ、スクレイプしない」。
/website-to-video
- 入力: ビデオに変換する一般的なウェブサイト / URL — 目標が製品ローンチではなく、サイト自体のビデオである場合。ヘッドレスChromeでキャプチャして実際のスクリーンショット + ブランドアセットを取得。
- 出力: サイトの独自のビジュアルから構築されたサイトツアー / ポートフォリオ / ランディングページショーケース / ソーシャルクリップ → MP4。
- トリガー: 「このウェブサイトをビデオに」、「 からのサイトツアー」、「ホームページからのソーシャルクリップ」、「URLだけがある — 何か作って」。
/faceless-explainer
- 入力: 任意のテキスト — トピック、記事、メモ — を説明するもの。マーケティング対象の製品やキャプチャするサイトはありません。(
/product-launch-videoからフォーク;ヘッドレスChromeなし。) - 出力: 顔出しなし解説 → MP4、すべてのビジュアルはシーンごとにLLMが生成(タイポグラフィ / 抽象 / 図 / データ可視化);
pin-and-paperプリセットを同梱。(最適な長さ30〜90秒)。 - トリガー: 「Xについての顔出しなし解説」、「DNSの仕組みをビデオで説明」、「この記事を解説に」、「自分のメモから解説」。
/pr-to-video
- 入力: GitHub プルリクエスト — PR URL、
owner/repo#N参照、または「このPR」 —ghCLI 経由で読み取り(スクレイピングするサイトではない)。 - 出力: コード変更解説(チェンジログ / 機能紹介 / 修正 / リファクタリング)→ MP4 — diffハイライト、before/after、ファイルツリー + インパクトシーン。(最適な長さ30〜90秒)。
- トリガー: 「このPRについてのビデオを作って」、「PR #1187をチェンジログビデオに」、「github.com/org/repo/pull/123 からのリリースノートビデオ」。
/embedded-captions
- 入力: キャプションを付ける既存のトーキングヘッドビデオ(MP4) — 実際の映像、URLやブリーフではない。ローカルで文字起こし(Whisper、APIキー不要)し、マット処理(RVM)により被写体がキャプションを隠せるようにする。
- 出力: 同じ映像をそのまま、キャプションレイヤーを追加 — スタンダード(逐語的なローワーサードレール + 被写体の背後に埋め込まれたクライマックス)またはシネマティック(すべてのキャプションを被写体の背後に合成)。任意の長さ。
- トリガー: 「このビデオにキャプション / 字幕を追加」、「被写体の背後にキャプション」、「クリップにシネマティックキャプション」。
/talking-head-recut
- 入力: オンスクリーングラフィックでパッケージ化する既存のトーキングヘッド / インタビュー / ポッドキャストビデオ(MP4) — 実際の映像。ローカルで文字起こし(Whisper)。クリップはそのまま下で再生され、編集されません。
- 出力: 同じ映像に、トランスクリプトに同期したタイミングのグラフィックオーバーレイカード — キネティックタイトル、ローワーサード、データコールアウト、プルクォート、サイドパネル、ピクチャーインピクチャー — を追加。任意の長さ。
- トリガー: 「このビデオをパッケージ化」、「私のトークにグラフィックオーバーレイ / ローワーサード / データコールアウトを追加」、「このインタビューをグラフィックパッケージ版に」。
/motion-graphics
- 入力: 短い、デザイン主導のモーショングラフィックで、モーション自体がメッセージ — 通常約10秒未満、ナレーションなし。ジャンル:キネティックタイポグラフィ、統計 / 数字のカウントアップ、チャート表示、ロゴスティング、ローワーサード / オーバーレイ、または検索駆動のページ / ツイート / 見出しのショット。
- 出力: 短いモーショングラフィック → MP4 または透明オーバーレイ(アルファ WebM / MOV)ローワーサード / コールアウト用。
- トリガー: 「8秒のロゴスティング」、「この統計をアニメート」、「キネティックタイプのイントロ」、「このツイートをモーショングラフィックに」、「透明なローワーサードオーバーレイ」。
/music-to-video
- 入力: 音楽トラック — オーディオファイル、またはオーディオを抽出するビデオ — でナレーションなし、ウェブサイトキャプチャなし。オプションで、ユーザー提供の画像 / ビデオを織り交ぜる。トラックは一度分析され、決定論的なビート / エネルギーマップ(
audiomap.json)が生成され、ビデオ全体がこれに基づいて構築されます。 - 出力: ビート同期 HyperFrames コンポジション → MP4。音楽がペーシングを駆動。タイポグラフィとテンプレートが基本(完全なビデオにはゼロアセットで十分);提供されたメディアは同じビートグリッドにカットされます(ビートカット / ケンバーンズ)。ジャンル — リリックビデオ、スライドショー、キネティックプロモ — はフレームごとの選択から生まれます;パイプラインはそれで分岐しません。
- トリガー: 「この曲のビデオを作って」、「このトラックからビート同期ビデオ」、「リリックビデオ」、「この音楽をビデオに」、「ミュージックビジュアライザー / このビートに合わせたキネティックプロモ」。
/slideshow
- 入力: オーサリングするプレゼンテーション / ピッチデッキ / インタラクティブデッキ — ブリーフ、アウトライン、またはスライドに変換する既存のページ。レンダリングされたビデオのリクエストではありません;意図が曖昧な場合、スキルはオーサリング前に「これをHyperFramesスライドショーにしますか?」と確認します。
- 出力: 実行可能なHyperFramesコンポジション + プレーヤーの
SlideshowControllerが読み取って GSAP タイムラインをナビゲーション可能なデッキに変換するJSON アイランド — 個別スライド、フラグメント表示、ブランチングシーケンス、ホットスポットナビゲーション、プレゼンターモード、スピーカーノート。成果物はデッキであり、MP4ではありません。 - トリガー: 「ピッチデッキ / プレゼンテーション / スライドデッキを作って」、「インタラクティブデッキ」、「このページをスライドに変換」、「プレゼンターモード付きスライドショー」。
/general-video
- 入力: 上記以外のもの — クリエイティブブリーフ、アニメートする単一要素、構築中のコンポジションへの編集。入力と長さに依存しない。
- 出力: 元のフローによるHyperFramesコンポジション(任意の長さ / フォーマット):デザインシステム → プロンプト拡張 → 計画 → アニメーション前のレイアウト → ビルド(
hyperframes-* スキルに委任)→ 検証 → レンダリング。 - トリガー: 「カスタムコンポジション」、「長いビデオ」、「静的ループ / ポスター」、「このシナリオのための一般的なビデオ」。