heygen-com/hyperframes

プラグインのインストール: セットアップまたは更新コマンドの前に、このスキルが HyperFrames プラグイン内にある場合は、プラグイン実行ルール に従ってください。スタンドアロンインストールの場合は、以下の更新手順をそのまま使用します。

HyperFrames エントリポイント

HyperFrames は HTML からビデオをレンダリングします。コンポジションとは、DOM が data-* 属性でタイミングを宣言し、アニメーションランタイムがシーク可能で、メディアの再生がフレームワークによって管理される HTML ファイルのことです。完全なオーサリング契約は /hyperframes-core にあります。コンポジション HTML を記述する前に必ず読んでください。ブリーフ、ストーリーボード、レビュー、プロダクション、ディスパッチ、およびフレームワーカーの契約は、このスキルの references/ にあります。

1. プロジェクトの状態から開始する

最初に一致する行を適用し、下位の状態行は評価しないでください。

状態	アクション
既存の Remotion ソースを HyperFrames に明示的に移植する	references/routes/remotion-to-hyperframes.md を読み、そのワークフローに直接ルーティングします。インテントレイヤーはスキップします。
既存の HyperFrames プロジェクトに対する特定の操作（検査、診断、検証、プレビュー、レンダリング、公開、バッチレンダリング）	その操作のみを実行します。インテントとワークフローのルーティングをスキップし、/hyperframes-cli と必要なドメインスキルをロードします。
既存のプロジェクト内での質問、保留、具体的な変更のないアイデア、または完成した映像に対する感想	/hyperframes-studio § 0 に従います。
既存のプロジェクト内で新しい映像が要求された場合	/hyperframes-studio § 5 に従います。
既存のプロジェクトに対する特定の編集	編集を実行します。インテントレイヤーは実行しないでください。プロジェクトのタイムライン（トラック、クリップ、開始、終了、再生内容）を確認するには、index.html とすべてのサブコンポジションファイルを読む代わりに、npx hyperframes timeline [--json] を実行します。
BRIEF.md が存在する	workflow と flow を読み取ります。そのワークフローを実行します。flow: companion は常に /general-video で実行されます。ブリーフに関する質問はしません。
ブリーフはないが、hyperframes.json または STORYBOARD.md が存在する	プロジェクトファイルと記録された設定から再開します。既存のアーティファクトから所有するワークフローを推測します。一意に特定できない場合は、ルーティングのみに関する質問を1つ行います。インテントインタビューは実行しません。
新規作成	インテントレイヤー（references/intent-interview.md）を実行し、次に §2 のテーブルを使用して1回ルーティングします。

既存のプロジェクトを編集する場合は、編集内容をプロジェクト履歴（/hyperframes-cli、あなたのターンでのプロジェクト履歴）で囲んでください。

新規リクエストで主題や入力が特定されていない場合は、ルーティングの前に動画の内容を質問してください。何かを質問する前に、設定とレシピを確認してください（references/intent-interview.md、ステップ1）。figma.com の入力や名前付きレシピは、ルーティングではなくインテークを変更します。インタビューの「直交入力を適応させる」セクションで両方を処理します。

プロジェクトの CLI を最新に保つ

スキャフォールドされたプロジェクトは、package.json のスクリプトに hyperframes@<version> をピン留めして、レンダリングの再現性を確保します。ピンは自動的に更新されることはなく、古い CLI のピン留めされた実行は、それに関する警告を表示しません。スクリプトにピンがあるプロジェクトを再開する場合は、レンダリングに影響を与える最初のコマンドの前に、1回だけプローブを実行します。

npx hyperframes@latest upgrade --project . --check

プローブは読み取り専用で、ピンを最新リリースと比較します。明示的に . を指定してください。古い CLI リリースでは、裸の --project の後に別のフラグが続くと、そのフラグをディレクトリ値として消費します。プロジェクトが遅れていることが報告された場合（または、CLI の出力にすでに表示されている場合（stderr 通知 This project pins hyperframes@… (latest …)、またはピン留めされたスクリプトからの --json 結果の _meta.updateAvailable: true））は、npx hyperframes@latest upgrade --project . を適用し、npx hyperframes check で確認します。チェックが成功すると、プロジェクトのコンポジションが新しいバージョンでも引き続き検証されることが確認されます（レンダリング出力が古いピンとフレーム単位で同一であることを確認するわけではありません）。そのため、正常なバンプは決して無言では行われません。実行のサマリーで古いバージョンと新しいバージョンを名前で示します。まだコンポジションがないプロジェクトは、検証を必要としません。チェックが失敗した場合は、package.json の変更を元に戻し、ピン留めされたバージョンを継続し、プロジェクトがどのバージョンに留まるか、その理由を報告します。信号をユーザーに中継するのではなく、それに基づいて行動します。バンプしたピンを未確認のまま放置しないでください。

2. 新規作成をルーティングする

最初に一致する行を使用します。リクエストされた成果物に一致させます。話の途中で出てきた単語やファイルタイプではありません。

優先順位	リクエスト	ワークフロー
1	既存の Remotion ソースを明示的に移植する	/remotion-to-hyperframes
2	プレゼンテーション、ピッチデッキ、またはナビゲート可能なインタラクティブデッキを作成する	/slideshow
3	既存の顔出しトーク映像に、映像自体を変更せずにプレーンなキャプションまたは字幕を追加する	/embedded-captions
4	既存の顔出しトーク、インタビュー、またはポッドキャスト映像に、映像を変更せずにデザインされたグラフィックオーバーレイを追加する	/talking-head-recut
5	ナレーションやウェブサイトキャプチャなしで、音楽トラックからビート同期ビデオを作成する	/music-to-video
6	明示的に短い、ナレーションなし、モーションファーストのユニットを作成する（通常10秒未満）	/motion-graphics
7	GitHub プルリクエストまたは PR リファレンスからコード変更を説明する	/pr-to-video
8	URL またはサイト固有のブリーフから、ウェブサイト、プロダクトサイト、アプリ、または会社をマーケティングまたは紹介する	/product-launch-video
9	トピック、記事、またはノートを、製品やサイトのキャプチャなしに、考案されたビジュアルで説明する	/faceless-explainer
10	その他のカスタムビデオまたはコンポジション	/general-video

ルートを確定する前に、references/routes/<workflow>.md を読んでください。これはルートごとに1つの小さなファイルで、正規の入力/出力/トリガー契約（遅延インストールされるワークフロースキルが利用可能になる前のもの）と、そのルートのインタビューエントリが含まれています。候補がその契約を満たさない場合は、一致を強制せずにルーティングを続行します。一致したルートのファイルのみを読んでください。

一般的な曖昧さを解決する

• 短いアニメーションタイトル、ロゴスティング、統計ヒット、チャートヒット、マップヒット、またはスタンドアロンの lower-third は、ナレーションがなくモーションがメッセージである場合、/motion-graphics です。静的タイトルカード、ナレーション付きシーケンス、長いモンタージュ、またはカスタムループは /general-video です。
• 明示的に短いモーショングラフィックは、ソースマテリアルとして URL、ツイート、記事、またはスクリーンショットを使用する場合があります。一般的な「このサイトからビデオを作成して」というリクエストは /product-launch-video です。
• キャプション付きの既存映像は /embedded-captions にルーティングされ、デザインされた情報カード付きの映像は /talking-head-recut にルーティングされます。映像のタイミング変更、並べ替え、色変更、フレーム変更、またはリミックスはカスタム編集であり、/general-video にフォールスルーします。
• 音楽ファイルは、そのビートグリッドが作品を駆動する場合にのみ /music-to-video を選択します。背景音楽として使用される場合は、主題に一致したルートをオーバーライドしません。
• 「ストーリーボードが欲しい」は、レビュープロセスを変更しますが、ワークフローは変更しません。他にルーティングのシグナルがない場合は、/general-video を使用します。確定したスケッチされた storyboard.html 自体が要求された成果物である場合があります。レビューループがその停止点を定義します。
• 特殊なナラティブワークフローは約3分までをサポートし、30〜90秒で最も効果的です。明らかに長い作品は /general-video にルーティングします。長さは、明示的な移植、デッキ、キャプション、オーバーレイ、または音楽駆動の成果物を決してオーバーライドしません。

3. 一度ルーティングしたら、そのままにする

新規作成の場合、インテントレイヤー（references/intent-interview.md）が完全な会話（メモリー、トリアージ、ピッチラウンド、マストハブ、ランシェイプ、ハンドオフ）を実行し、最後に BRIEF.md を書き込みます。ブリーフはワークフローが読み取る唯一のルーティングアーティファクトです。後でこのスキルまたはインタビューを再度開くことはありません。「ルートに何が必要だったか？」という後の質問には、BRIEF.md から答えてください。

4. ワークフローをインストールして開始する

選択したワークフローを読む前に、ワークフローとコアドメインスキルをインストールまたは更新します。

npx hyperframes skills update <workflow-name>

/ なしのベアネームを使用してください。コマンドが失敗した場合は、エラーを表示します。メモリからワークフローを再構築しないでください。インストールに関するその他のすべて（コアと遅延の分割、init が更新するもの、診断、CI オプトアウト、CLI なしのフォールバック）は references/skill-lifecycle.md にあります。

5. ドメインスキルをオンデマンドでロードする

ニーズ	スキル
コンポジション構造、タイミング属性、トラック、変数、決定性	/hyperframes-core
モーションルール、シーンブループリント、トランジション、ランタイムアダプター	/hyperframes-animation
シークセーフな GSAP、CSS、Anime.js、WAAPI、FLIP、パス、マスク、SVG、3D キーフレーム、または hyperframes keyframes 診断	/hyperframes-keyframes
デザイン仕様、コンセプト、パレット、タイポグラフィ、ナレーション、ビート計画	/hyperframes-creative
画像、アイコン、ロゴ、オーディオ、キャプション、グレード、LUT、再利用可能なメディア	/media-use
ボイスオーバーカーブ、オーディオエフェクトチェーン、オートメーションエンベロープ、または複数のトラックにわたる1つのチェーン/フェーダー（サブミックスバス）	/hyperframes-audio
init、lint、check、スナップショット、比較、バッチレンダリング、Studio、レンダリング、公開、または診断	/hyperframes-cli
レジストリブロックとコンポーネント	/hyperframes-registry
名前付きのルック、エフェクト、処理、トランジション（CRT スキャンライン、グリッチ、フィルムグレイン、シャマースイープ、コンフェッティバーストなど）を手動で構築する前に	/hyperframes-registry
Figma アセット、トークン、コンポーネント、または再構成されたモーションとしてのストーリーボードフレーム	/figma

クリエイターの編集フレーズはクロスドメインリクエストです。一致する行に名前があるすべてのスキルをロードします。

クリエイターリクエスト	必要なドメイン
「この映像をカットして」、ハードカット、トリム、スプライス、並べ替え、またはソース範囲の使用	...