HyperFrames — スタートはここから
HyperFramesはHTMLからビデオをレンダリングします。コンポジションはHTMLファイルであり、そのDOMはdata-*属性でタイミングを宣言し、アニメーションランタイムはシーク可能で、メディア再生はフレームワークが所有します。完全なオーサリング契約は/hyperframes-coreにあります。コンポジションHTMLを書く前にそれを読んでください。
以下は、ケイパビリティマップ(オンデマンドでロードされるドメインスキル)とインテントルーター(「~を作って」というリクエストに対してワークフローを選択します。通常はビデオですが、ナビゲーション可能なデッキやコンポジションポートの場合もあります)です。この分割は所有権に基づいており、出力タイプではありません。ワークフローはエンドツーエンドの成果物を所有し(独自のプロジェクトディレクトリ、ゲート付きステップ、サブエージェント、最終成果物を持ちます)、ドメインスキルは機能レイヤーであり、ワークフローが途中で取り込み、タスクを所有することはありません。
ケイパビリティマップ — ドメインスキル
オンデマンドでロードするアトミックな機能です。完全なワークフローではありません。エンドツーエンドのタスクを所有することはありません。「~を作って」というインテントの場合は、以下のインテントルーターを使用してください。
| やりたいこと… | スキル |
|---|---|
HTMLコンポジションを作成/編集する — data-*契約、クリップ、トラック、サブコンポジション、変数 | /hyperframes-core |
| アニメーション — アトミックモーション、シーンブループリント、トランジション、ランタイムアダプター(GSAP / Lottie / Three.js / Anime.js / CSS / WAAPI / TypeGPU) | /hyperframes-animation |
シークセーフなキーフレームを作成する — GSAPタイムライン、CSSキーフレーム、Anime.js、WAAPI、FLIP、パス、マスク、SVGモーフ/ドロー、3D深度、さらにhyperframes keyframes診断 | /hyperframes-keyframes |
クリエイティブディレクション — frame.md / design.md、パレット、タイポグラフィ、ナレーション、ビートプランニング、オーディオリアクティブ | /hyperframes-creative |
| メディア — BGM/SE、画像、アイコン、ブランドロゴ、ボイス、カラーグレード、LUTの解決/生成;TTSボイスオーバー、文字起こし、背景除去、キャプション;プロジェクト間再利用 | /media-use |
| CLI開発ループ — init、lint、validate、inspect、preview、render、publish、doctor | /hyperframes-cli |
レジストリブロック/コンポーネントをインストールする(hyperframes add) | /hyperframes-registry |
| Figmaコンテンツをインポートする — アセット、トークン、コンポーネント、ストーリーボード→再構築モーション(REST/CLI);モーション(MCP)、シェーダー(MCPソース / ネイティブエクスポート) | /figma |
インテントルーティング — ワークフローを選択する
このセクションはトップレベルのワークフローのみを知っています。内部の参照や上記のドメインスキルはロードしません。
ルーティング前 — 仕様ではなく入力を確認する
ルーティングはビデオが何についてかを知る必要があります。つまり、その入力と主題です。それが未指定の場合(「私たちのものについてのビデオを作って」とURL、製品、トピック、アセットがない場合)、ワークフローに入る前に質問してください。ワークフローにコミットすることがルーティングの決定です。質問は最大2つ:
- 入力 — 製品(URL / ブリーフ)、一般的なWebサイト、GitHub PR、説明するトピック、または既存のトーキングヘッドビデオ?
- Figmaソース — 入力がfigma.comのURLの場合、以下で選択されたビデオの形状に関係なく、
/figmaが最初にアセット/トークン/(コンポーネント/ストーリーボード)を抽出します。そのワークフローは/figmaの出力から構築します。生のMCPツールでFigmaを直接操作することはありません(SVGサニタイゼーション、来歴、ブランドトークンバインディングをスキップします)。
モード — リクエストに継続的な自律シグナルが含まれている場合(「驚かせて」、「決めて」、「ただ作って」)、それを記録してワークフローに渡します。実行全体が自律的になり、後のステップで再質問しません。シグナルがない場合、ワークフローは最初のブリーフ質問としてモードを尋ねます。デフォルトは協調的です。(/motion-graphicsは設計上自律的です。)意味論:hyperframes-core → references/brief-contract.md。
スペックのデフォルト — 質問せずに状態を示す(ルートは変更されません):アスペクトは宛先から導出されます — ソーシャルフィード(X / LinkedIn / Instagram)→ 正方形 1:1、TikTok / Reels / Shorts → 9:16、YouTube / 埋め込み / 不明 → 16:9;ナレーション/キャプションの言語 = ユーザーの言語。選択されたワークフローは最初のステップで独自の詳細を再確認します(フィールドの意味論:hyperframes-core → references/brief-contract.md)。
ワークフローチートシート
| ワークフロー | 使用するケース |
|---|---|
/product-launch-video | 製品を販売する(SaaS、アプリ、会社/製品サイト) — URL、ブリーフ、またはスクリプトからプロモへ。商用URLのデフォルト。サイト名が指定されているだけでも同様。 |
/website-to-video | サイト自体を紹介する — サイトのスクリーンショットから構築されたツアー/ショーケース。非商用サイト(ポートフォリオ、ブログ、ドキュメント、個人、イベント)、またはユーザーがプロモではなくツアーを希望する場合。 |
/faceless-explainer | トピック/コンセプトを説明する — 製品なし、URLなし。すべてのビジュアルはLLMが考案。 |
/pr-to-video | GitHub PR / コード変更 → チェンジログ / 機能紹介 / 修正 / リファクタリングの解説。 |
/embedded-captions | 既存のトーキングヘッドビデオにキャプション/字幕を追加する(映像はそのまま)。 |
/talking-head-recut | 既存のトーキングヘッドビデオをデザインされたグラフィックオーバーレイでパッケージ化 — ローワーサード、データコールアウト、キネティックタイトル、プルクォート。 |
/motion-graphics | 短い(約10秒未満)、ナレーションなしの作品で、モーション自体がメッセージ — キネティックタイプ、統計/チャートヒット、ロゴスティング、アニメーションマップ、アニメーションツイート/ヘッドライン、スタンドアロンのローワーサード/オーバーレイ(MP4または透明アルファ)。 |
/music-to-video | 楽曲 → ビート同期ビデオ — リリックビデオ、スライドショー、またはキネティックプロモ;音楽がペーシングを決定(オプションでユーザー画像/動画をビートグリッドにカット)。 |
/slideshow | プレゼンテーション / ピッチデッキ / インタラクティブデッキ — 個別のスライド、フラグメント、分岐、ホットスポット。出力はナビゲーション可能なデッキ。レンダリングされたビデオではありません。 |
/general-video | その他すべて — より長いまたはマルチシーンの作品、静的ループ/ポスター、カスタムコンポジション。 |
/remotion-to-hyperframes | 既存のRemotion(React)コンポジションをHyperFramesに移植する(移行、作成ではありません)。 |
曖昧性解消(混乱しやすい場合のみ):
- モーションファースト&ナレーションなし(約10秒未満、モーションがメッセージ)→
/motion-graphics、入力に関係なく。 - URLまたはスクリプト — 一つ質問する:サイトは製品を販売していますか? はい(SaaS / アプリ / 製品 / 会社サイト)→
/product-launch-video— プロモ。商用URLのデフォルト。サイト名が指定されているだけでも同様。いいえ、またはユーザーがサイトをそのまま表示したい場合(ポートフォリオ / ブログ / ドキュメント / 個人 / イベント)→/website-to-video— ツアー。GitHub PRリンク→/pr-to-video。製品やサイトのないコンセプト→/faceless-explainer。 - 既存の映像 — プレーンな朗読字幕→
/embedded-captions。デザインされたオーバーレイカード→/talking-head-recut。どちらも映像自体を編集しません(再タイミング / 再カラー / リフレーム / 並び替え / オーディオはNLE編集 — 対象外)。 - 楽曲が入力(オーディオファイル、またはオーディオを抽出するためのビデオ)でナレーションなし→
/music-to-video— 音楽のビート/エネルギーがペーシングを決定。(ナレーション付きの作品は上記の入力一致ワークフローに留まります。/motion-graphicsは音楽駆動ではない短いナレーションなしのモーション用です。) - プレゼンテーション / ピッチデッキ / インタラクティブデッキ(個別のスライド、ナビゲーション、プレゼンターモード)→
/slideshow— 出力はナビゲーション可能なデッキ。レンダリングされたビデオではありません。明示的な「スライドショー」リクエストは直接進みます。隣接するトリガー(「デッキ / スライド / プレゼンテーション / このページを変換」)は、/slideshowがオーサリング前にスライドショーであることを確認し、そうでなければ適切な非スライドショーワークフローに切り替えます。 - 長さはガイドであり、ゲートではない — インテントがワークフローを選択します。作品が明らかに約3分より長い場合、または静的/ループ/カスタムフォーマットの場合にのみ
/general-videoに進みます。
選択後 — ワークフローがインストールされていることを確認する
ワークフローを選択したら、そのスキルを読む前に更新手順を実行してください。ワークフロースキルはオンデマンドでインストールされるため、マッチしたものがまだこのマシンに存在しない可能性があります(トリガーフレーズがこのルーターに存在するのは、インストールされていないスキルにルーティングできるようにするためです):
npx hyperframes skills update <workflow-name>
先頭に/は付けず、ベアネームを使用します。例:npx hyperframes skills update pr-to-video。スキルに名前を指定すると、そのスキルと、すべてのワークフローが依存するコアドメインスキルがインストールされ、最新であることが保証されます。すべてが既に最新の場合は高速なno-op、そうでない場合は不足/古いスキルのみを対象としたインストールになります。フルセットをインストールすることはありません。その後、ワークフローのスキルを読んで続行します。同じコマンドは、ケイパビリティマップからのオンデマンドドメインスキル(例:npx hyperframes skills update figma)でも機能します。
コマンドが失敗した場合は、メモリからワークフローを即興で作成する代わりに、エラーをユーザーに表示します。手動フォールバック(HyperFrames CLIが利用できない場合):npx skills add heygen-com/hyperframes --skill <workflow-name>。すべてを一度に:npx skills add heygen-com/hyperframes --all。
スキルを最新に保つ
HyperFramesスキルはバージョン管理されており、遅延インストールされます。コアセットは即座に、ワークフローは最初の使用時にインストールされます。
- コアセット — このルーター、
hyperframes-*ドメインスキル、media-use。npx hyperframes init(すべての作成ワークフローがスキャフォールディング時に実行します)はGitHubをチェックし、コアセットと既にインストールされているその他のものを更新します。インストールを拡張することはありません。未使用のワークフロースキルは取得されません。最新のマシンでinitを再実行してもno-opです。オフライン(またはレート制限中)はグレースフルに低下し、ハードフェイルすることはありません。--skip-skillsフラグは現在無効化されています(skills.shレジストリが追いつくまでの一時的な措置)。CI/テストはHYPERFRAMES_SKIP_SKILLS=1環境変数でオプトアウトします。 - ワークフロースキル — 上記の更新手順(
skills update <workflow-name>)でトリガー時にインストールおよび更新されます。
タスクが予期しない動作をする場合、または長時間のビルドの前に、インストールされたスキルが最新であることを確認してください:
- 確認:
npx hyperframes skills check(--jsonを追加して機械可読な結果を出力。インストール済みのものが古い、またはコアセットが不完全な場合、非ゼロで終了します。未インストールのワークフロースキルは_オンデマンドで利用可能_として報告され、失敗とはみなされません)。 - 更新:
npx hyperframes skills update— コアセットとインストール済みのすべてを最新に更新し、公開されなくなったスキルを削除します。名前を指定しない場合、未使用のワークフローをインストールすることはありません。スキルに名前を指定すると(skills update <name…>)、それらのスキルも追加でインストールされます。 - 明示的にフルセット:
npx hyperframes skills(またはnpx skills add heygen-com/hyperframes --all)。
CLIは、render / lint / validateの実行で古いスキルが検出された場合に、1行のリマインダーを表示します。
ワークフローの詳細
/product-launch-video
- 入力: マーケティングされる製品 — (a) 製品URL(ヘッドレスChromeでクローリングされ、アセット+ブランドトークンを取得)、(b) リンクなしでも製品のサイトに名前を付けるスクリプト/ブリーフ(PLVは解決してクローリングします。ユーザーがオプトアウトしない限り)、または**(c)** 導出可能なサイトがない、または「スクレイピングしない」スクリプト(キャプチャなしモード — パレットとデザインシステムを提供するスタイルプリセットを選択)。提供されたスクリプトは、逐語的なボイスオーバーとして、またはシーンごとに再構成して使用できます。PLVが質問します。
- 出力: HyperFramesコンポジションとしての製品ローンチ / SaaSプロモ → MP4(スイートスポット30~90秒)。製品の価値が主題であり、サイトのウォークスルーではありません。単なるサイトツアーの場合は
/website-to-videoを使用してください。 - トリガー: 「Xのローンチビデオ」、「私たちのサイトのプロモ」、「SaaSを1分で説明して」、「スクリプトを60秒のプロモに」、「テキストをプロモーションビデオに」、「製品の説明ビデオ」。
/website-to-video
- 入力: 紹介するWebサイト — URL(クローリングしてスクリーンショット、コンテンツセクション、トークンを取得)、または書かれたサイトの説明。
- 出力: サイトのコンテンツ構造を示すネイティブなスクリーンショットベースのツアー — 製品を売り込むのではなく、サイトを紹介します。出力は30~90秒のMP4、またはインタラクティブなサイトツアー(
/slideshowに委譲)。 - トリガー: 「私たちのサイトのツアー」、「ポートフォリオを見せるビデオ」、「私のブログを紹介して」、「ドキュメントサイトの概要」、「このページをビデオに変換」。
/faceless-explainer
- 入力: 説明するトピック — 自由形式のテキスト、トピックのタイトル、または詳細なブリーフ。製品やURLはありません。
- 出力: LLMが発明したビジュアルを使用した説明ビデオ(ストックアニメーション、生成された画像、キネティックタイポグラフィ)。長さは複雑さに一致します(30~180秒)。
- トリガー: 「コンセプトを説明して」、「[トピック]についての解説ビデオ」、「ファクトイドを視覚化」、「アイデアを説明する簡単なビデオ」、
/pr-to-video
- 入力: GitHub PR URL(拡張子なしのベアPRリンク — ブラウザで表示されるもの)。プライベートリポジトリのためのオプションのパーソナルアクセストークン。
- 出力: PRの変更を説明するビデオ — 付録ではなく、変更ログスタイルのプレゼンテーション。リリース動画、機能紹介、説明ビデオ。
- トリガー: 「PRの変更ログビデオ」、「このPRをビデオで説明して」、「このコード変更を紹介」、「PRの内容を説明」。
/embedded-captions
- 入力: 既存のトーキングヘッドビデオと、そのオーディオの文字起こしまたは原稿。
- 出力: ソースビデオの上にキャプション/字幕が重ねられた同じ長さのビデオ。元のビデオは編集されません。
- トリガー: 「このビデオにキャプションを追加」、「字幕を追加」、「話しているビデオを文字に起こしてキャプションを付ける」、
/talking-head-recut
- 入力: 既存のトーキングヘッドビデオと、オーバーレイするグラフィック要素の説明。
- 出力: デザインされたグラフィックオーバーレイ(ローワーサード、データコールアウト、キネティックタイトル、プルクォート)を備えた同じ長さのビデオ。元のビデオは編集されません。
- トリガー: 「このトーキングヘッドにグラフィックオーバーレイを追加」、「ローワーサードをデザイン」、「グラフィックでこのインタビューを強化」、「タイトルカードとデータボックスを追加」。
/motion-graphics
- 入力: モーショングラフィックの説明 — テキスト、数値、キーメッセージ、または概念。製品、サイト、楽曲は不要。単にモーションが伝えるもの。
- 出力: タイトルカード、ロゴスティング、データビジュアライゼーション、ソーシャル投稿用のアニメーションヘッドライン、またはスタンドアロンのオーバーレイアセット(透明アルファ付きMP4)。長さは約4~10秒。
- トリガー: 「アニメーションタイトルカード」、「この統計を視覚化」、「ロゴアニメーション」、「注目を集めるビデオ」、「アニメーションツイート」、
/music-to-video
- 入力: 楽曲(オーディオファイル、またはオーディオを抽出するためのビデオ)。オプションの画像/動画クリップ。
- 出力: 音楽のビートとエネルギーに同期したビデオ — リリックビデオ、スライドショー、またはキネティックプロモ。
- トリガー: 「この曲のリリックビデオ」、「ビートに合わせたビデオスライドショー」、「この曲をプロモーションするアニメーションビデオ」、「音楽プロモ」。
/slideshow
- 入力: プレゼンテーションのコンテンツ — テキストの概要、スクリプト、または既存のスライド。
- 出力: ナビゲーション可能なインタラクティブなスライドデッキ(HTML)。レンダリングされたビデオではありません。
- トリガー: 「デッキを作成」、「ピッチデッキ」、「プレゼンテーション」、「スライドショーを作成」、「このページをインタラクティブなデッキに変換」。
/general-video
- 入力: 他のワークフローに適合しないあらゆる入力。
- 出力: 作品の長さと複雑さに一致するHyperFramesコンポジション。
- トリガー: 他のワークフローにマッチしない「ビデオを作成」リクエストのキャッチオール。
/remotion-to-hyperframes
- 入力: 既存のRemotion(React)コンポジション(ソースコードへのパス、またはGitリポジトリのURL)。
- 出力: HyperFramesコンポジションへの変換(ReactコンポーネントをHyperFrames HTMLテンプレートと
data-*属性にマッピング)。 - トリガー: 「RemotionプロジェクトをHyperFramesに移植」、「Reactコンポーネントを変換」、「Remotionコンポジションを移行」。