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 |
| メディア:TTSボイスオーバー、BGM、文字起こし、背景削除、キャプション | /hyperframes-media |
メディア解決:HeyGenカタログからBGM、効果音、画像、アイコンを .media/ に検索して固定し、マニフェストで追跡する | /media-use |
| CLI開発ループ:init、lint、validate、inspect、preview、render、publish、doctor | /hyperframes-cli |
レジストリブロック/コンポーネントのインストール(hyperframes add) | /hyperframes-registry |
| Figmaコンテンツのインポート:アセット、トークン、コンポーネント、ストーリーボード→アニマティック(REST/CLI);モーション、シェーダー(MCP) | /figma |
インテントルーティング、ワークフローを選択する
このセクションはトップレベルのワークフローのみを知っています。内部参照や上記のドメインスキルはロードしません。
ルーティング前に、スペックではなく入力を確認する
ルーティングでは、動画が何についてのものか、つまり入力と主題を知る必要があります。それが不特定(「私たちのものについて動画を作って」と、URL、製品、トピック、アセットがない)の場合は、ワークフローに入る前に質問してください。ワークフローを決定することがルーティングの決定です。最大2つの質問:
- 入力:製品(URL / ブリーフ)、一般的なウェブサイト、GitHub PR、説明するトピック、または既存のトーキングヘッド動画ですか?
スペックのデフォルトは、述べて、質問しない(ルートを変更することはありません):アスペクト比 16:9(9:16は名前付きの縦型配信先、TikTok / Reels / Shorts の場合のみ使用);ナレーション/キャプション 言語 = ユーザーの言語。選択されたワークフローは、最初のステップで自身の詳細を再確認します。
ワークフロー早見表
| ワークフロー | 使用シーン |
|---|---|
/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 | 短い、ナレーションなし、デザイン主導のモーショングラフィック:キネティックタイプ、統計/チャートヒット、ロゴスティング、ローワーサードオーバーレイ。 |
/music-to-video | 音楽トラックからビート同期動画、リリック動画、スライドショー、またはキネティックプロモーションへ。音楽がペースを決定(オプションでユーザー画像/動画をビートグリッドにカット)。 |
/slideshow | プレゼンテーション / ピッチデッキ / インタラクティブデッキ:個別スライド、フラグメント、ブランチ、ホットスポット。出力はナビゲーション可能なデッキであり、レンダリングされた動画ではありません。 |
/general-video | その他すべて:長いまたはマルチシーンの作品、静的ループ/ポスター、カスタムコンポジション。 |
/remotion-to-hyperframes | 既存のRemotion(React)コンポジションをHyperFramesに移植(移行、新規作成ではありません)。 |
曖昧さの解消(紛らわしい場合のみ):
- モーション優先 & ナレーションなし(約10秒未満、モーション自体がメッセージ)→
/motion-graphics、入力に関係なく。 - URLまたはスクリプト:1つだけ質問する:そのサイトは製品を販売していますか? はい(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 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が質問します。
- 出力: HyperFramesコンポジションとしての製品ローンチ / SaaS プロモーション → MP4(最適な長さ30〜90秒)。製品の価値が主題であり、サイトのウォークスルーではありません。サイトの単なるツアーの場合は、
/website-to-videoを使用してください。 - トリガー: 「Xのローンチ動画」、「私たちのサイトのプロモーション」、「私のSaaSを1分で説明」、「スクリプトを60秒のプロモに」、「テキストのみのローンチ動画、スクレイプしない」。
/website-to-video
- 入力: サイト自体を見せることが目的であり、製品を販売することではないウェブサイト/URL。非コマーシャルサイト(ポートフォリオ、ブログ、ドキュメント、個人、イベント)に最適。ユーザーが明示的にサイトをそのままツアーしたい場合。ヘッドレスChromeで実際のスクリーンショットとブランドアセットをキャプチャ。サイトが何かを販売しておりユーザーがプロモーションを望む場合は、
/product-launch-videoを使用します。 - 出力: サイトの独自のビジュアルから構築されたサイトツアー / ショーケース / ソーシャルクリップ → 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。差分ハイライト、ビフォー/アフター、ファイルツリー+影響シーン。(最適な長さ30〜90秒)。
- トリガー: 「このPRの動画を作って」、「PR #1187 をチェンジログ動画に」、「github.com/org/repo/pull/123 からのリリースノート動画」。
/embedded-captions
- 入力: キャプションを付ける既存のトーキングヘッド動画(MP4)。実際の映像。URLやブリーフではありません。ローカルで文字起こし(Whisper、APIキー不要)し、マット処理(RVM)して被写体がキャプションを隠せるようにします。
- 出力: 同じ映像をそのまま、キャプション層を追加。スタンダード(逐語的なローワーサードレール+被写体の背後に埋め込まれたクライマックス)またはシネマティック(すべてのキャプションが被写体の背後に合成)。任意の長さ。
- トリガー: 「この動画にキャプション/字幕を追加」、「被写体の背後にキャプション」、「私のクリップにシネマティックキャプション」。
/talking-head-recut
- 入力: オンスクリーングラフィックでパッケージ化する既存のトーキングヘッド / インタビュー / ポッドキャスト動画(MP4)。実際の映像。ローカルで文字起こし(Whisper)。クリップはそのまま下で再生され、編集されません。
- 出力: 同じ映像にタイミング調整されたグラフィックオーバーレイカード:キネティックタイトル、ローワーサード、データコールアウト、プルクォート、サイドパネル、ピクチャーインピクチャー、同期…
… [翻訳のため省略]