HyperFrames — スタートガイド は何をしますか?
HyperFrames は HTML から動画をレンダリングします。コンポジションは、data-* 属性でタイミングを宣言する HTML ファイルであり、そのアニメーションランタイムはシーク可能で、メディア再生はフレームワークによって管理されます。完全なオーサリング契約は /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、画像、アイコン、ブランドロゴ、音声の解決/生成;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 / ブリーフ)、一般的なウェブサイト、GitHub PR、説明するトピック、または既存のトーキングヘッド動画?
モード — リクエストに自律的なシグナルが含まれている場合(「サプライズして」「決めて」「作って」)、それをメモしてワークフローに渡します。実行全体が自律的になり、後のステップで再質問は行われません。シグナルがない場合、ワークフローは最初のブリーフ質問としてモードを尋ねます。デフォルトは協調モードです。(/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 <ワークフロー名>
名前はベアネームで、先頭に / は付けません。例:npx hyperframes skills update pr-to-video。スキル名を指定すると、そのスキル と すべてのワークフローが依存するコアドメインスキルがインストールされ、最新の状態になります。すでにすべてが揃っている場合は高速な no-op、不足または古いスキルがある場合のみターゲットインストールを実行します。フルセットはインストールしません。その後、ワークフローのスキルを読んで続行します。同じコマンドは、機能マップからのオンデマンドドメインスキルにも使用できます(例:npx hyperframes skills update figma)。
コマンドが失敗した場合は、ワークフローを記憶から即興で実行するのではなく、エラーをユーザーに表示します。手動フォールバック(HyperFrames CLI が利用できない場合):npx skills add heygen-com/hyperframes --skill <ワークフロー名>。一度にすべてをインストールする場合: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 <ワークフロー名>)によって、トリガー時にインストールおよび更新されます。
タスクが予期しない動作をする場合、または長時間のビルドの前に、インストールされているスキルが最新であることを確認します。
- 確認:
npx hyperframes skills check(--jsonを追加して機械可読な判定を出力。インストール済みのスキルが古いか、コアセットが不完全な場合、非ゼロで終了。まだインストールされていないワークフロースキルは「オンデマンドで利用可能」として報告され、失敗とは見なされません)。 - 更新:
npx hyperframes skills update— コアセットとインストール済みのすべてのスキルを最新版に更新し、公開されなくなったスキルを削除します。名前なしで実行した場合、未使用のワークフローはインストールしません。スキル名を指定する(skills update <名前…>)と、それらのスキルも追加でインストールします。 - 明示的にフルセット:
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 が尋ねます。
- 出力: 製品ローンチ / SaaS プロモーション動画(HyperFrames コンポジション → MP4、最適な長さは 30~90 秒) — 製品の価値が主題であり、サイトのウォークスルーではありません。サイトの単純なツアーには
/website-to-videoを使用してください。 - トリガー: 「X のローンチ動画」「当サイトのプロモーション」「SaaS を 1 分で説明」「スクリプトを 60 秒のプロモに」「テキストのみのローンチ動画、スクレイピングしない」。
/website-to-video
- 入力: 目標がサイト自体を表示することであり、製品を販売することではないウェブサイト/URL。非商用サイト(ポートフォリオ、ブログ、ドキュメント、個人、イベント)に最適。またはユーザーがサイトを現状のままツアーすることを明示的に希望する場合。ヘッドレス Chrome で実際のスクリーンショットとブランドアセットをキャプチャします。
(訳注:原文が途中で切れていますが、ワークフローの詳細は製品ローンチ動画とウェブサイトツアーの説明までが提供されています。)