HyperFrames — ここから開始 は何をしますか?
HyperFrames は HTML からビデオをレンダリングします。コンポジションは HTML ファイルで、その DOM が data-* 属性でタイミングを宣言し、アニメーションランタイムはシーク可能で、メディア再生はフレームワークが管理します。完全なオーサリング契約は /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、SE、画像、アイコンを検索して .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、概要、またはスクリプトから(サイト名のみでも可) |
/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;一般的な製品以外のサイト →/general-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 <ワークフロー名>(例:--skill pr-to-video— 名前のみ、先頭の/なし)。 - すべてのワークフローを一度に:
npx skills add heygen-com/hyperframes --all(コア + すべてのワークフロー、ピッカーをスキップ)。
ユーザーが実行した後、ワークフローのスキルを再読込して続行します。
スキルを最新に保つ
HyperFrames スキルはバージョン管理されています。npx hyperframes init はインストールされたスキルを GitHub 上の最新と比較し、何かが古いか不足している場合に全スキルをインストール/更新します。これにより、新しく init されたプロジェクトは常に完全で最新のスキルセットを持ちます(最新のプロジェクトで init を再実行しても何もしません)。チェックは GitHub への短いラウンドトリップです;オフライン(またはレート制限)の場合は短いタイムアウト後にインストールにフォールバックするため、init がネットワークの問題でハード失敗することはありません。作成ワークフローは init でスキャフォールドするため、新しいプロジェクトを開始するたびにこのチェックが実行され、GitHub から最新のスキルをプルします。--skip-skills フラグは現在無効化されています(skills.sh レジストリが追いつくまでの一時的な措置):これを渡してもチェックはスキップされないため、すべての init が GitHub をチェックします。CI/テストは HYPERFRAMES_SKIP_SKILLS=1 環境変数でオプトアウトします。
タスクが予期せぬ動作をする場合、または長時間のビルドの前に、インストールされたスキルが最新であることを確認してください:
- 確認:
npx hyperframes skills check(--jsonを追加して機械可読な結果を得る;何かが古いまたは不足している場合、非ゼロで終了)。 - 更新:
npx hyperframes skills update— 全スキルセットを最新にプルし、まだ存在しないものをインストール(init のインストールステップと同じ)。
CLI はまた、render / lint / validate 実行時に古いスキルを検出すると、1 行のリマインダーを表示します。
ワークフローの詳細
/product-launch-video
- 入力: マーケティングする製品 — (a) 製品 URL(ヘッドレス Chrome でクロールしてアセット + ブランドトークンを取得)、(b) 製品のサイトをリンクなしでも指定するスクリプト/概要(PLV が解決してクロール、ユーザーがオプトアウトしない限り)、または (c) 派生可能なサイトがないスクリプト(「スクレイプしない」 — パレット + デザインシステムを提供するスタイルプリセットを選択)。提供されたスクリプトは逐語的なナレーションとして使用するか、シーンごとに再構成するかを PLV が尋ねます。
- 出力: 製品ローンチ / SaaS プロモーションを HyperFrames コンポジションとして → MP4(最適な長さ 30 〜 90 秒)。
- トリガー: 「X のローンチ動画」、「当サイトのプロモ」、「私の SaaS を 1 分で説明」、「スクリプトを 60 秒のプロモに変換」、「テキストのみのローンチ動画、スクレイプしない」。
/faceless-explainer
- 入力: 任意のテキスト — トピック、記事、またはメモ — を説明するもの。マーケティングする製品やキャプチャするサイトはありません(
/product-launch-videoからフォーク;ヘッドレス Chrome は使用しません)。 - 出力: 顔出しなし解説動画 → MP4、すべてのビジュアルはシーンごとに LLM が生成(タイポグラフィ/抽象図/図表/データ可視化);
pin-and-paperプリセットがバンドルされます(最適な長さ 30 〜 90 秒)。 - トリガー: 「X についての顔出しなし解説動画」、「DNS の仕組みを動画で説明」、「この記事を解説動画に変換」、「メモから解説動画」。