HyperFrames エントリーポイント
HyperFrames は HTML からビデオをレンダリング します。コンポジションは、data-* 属性でタイミングを宣言する HTML ファイルであり、そのアニメーションランタイムはシーク可能で、メディア再生はフレームワークが所有します。完全なオーサリング契約は /hyperframes-core にあります。コンポジション HTML を書く前にそれを読んでください。ブリーフ、ストーリーボード、レビュー、プロダクション、ディスパッチ、フレームワーカーの契約は、このスキルの references/ にあります。
1. プロジェクトの状態から開始する
最初に一致する行を適用し、それより下の状態行を評価しないでください:
| 状態 | アクション |
|---|---|
| 既存の Remotion ソースから HyperFrames への明示的な移植 | references/routes/remotion-to-hyperframes.md を読み、そのワークフローに直接ルーティングします。インテント層をスキップします。 |
| 既存の HyperFrames プロジェクトに対する特定の操作:検査、診断、検証、プレビュー、レンダリング、公開、バッチレンダリング | その操作のみを実行します。インテントとワークフロールーティングをスキップし、/hyperframes-cli と必要なドメインスキルをロードします。 |
| 既存のプロジェクトに対する特定の編集 | 編集を行います。インテント層を実行しないでください。プロジェクトのタイムライン(トラック、クリップ、開始、終了、再生内容)を確認するには、index.html とすべてのサブコンポジションファイルを読む代わりに npx hyperframes timeline [--json] を実行します。 |
BRIEF.md が存在する | workflow と flow を読みます。そのワークフローを実行します。flow: companion は常に /general-video で実行されます。ブリーフに関する質問はしません。 |
ブリーフはないが、hyperframes.json または STORYBOARD.md が存在する | プロジェクトファイルと記録された設定から再開します。既存のアーティファクトから所有するワークフローを推測します。一意に決定できない場合は、ルーティングのみの質問を1つ行います。インテントインタビューは実行しません。 |
| 新規作成 | インテント層(references/intent-interview.md)を実行し、§2のテーブルを使用して一度ルーティングします。 |
新規リクエストが主題や入力を特定しない場合、ルーティングの前にビデオの内容を質問します。何かを質問する前に、設定とレシピを確認します(references/intent-interview.md、ステップ1)。figma.com 入力または名前付きレシピは、インテークを変更しますが、ルーティングは変更しません。インタビューの「Adapt orthogonal inputs」セクションが両方を処理します。
プロジェクトの CLI を最新に保つ
スキャフォールドされたプロジェクトは、package.json スクリプトで hyperframes@<version> を固定するため、レンダリングは再現可能です。この固定は自動的に更新されることはなく、古いCLIの固定された実行は警告を出力しません。スクリプトに固定が含まれているプロジェクトを再開する場合、レンダリングに影響を与える最初のコマンドの前に一度だけプローブします:
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を選択するのは、そのビートグリッドが作品を駆動する場合のみです。BGM として使用される音楽は、主題に一致したルートをオーバーライドしません。 - 「ストーリーボードが欲しい」は、ワークフローではなく、レビュープロセスを変更します。他にルーティングシグナルがない場合は、
/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、snapshots、compare、バッチレンダリング、Studio、レンダリング、公開、または診断 | /hyperframes-cli |
| レジストリブロックとコンポーネント | /hyperframes-registry |
| 名前付きルック、エフェクト、処理、トランジション — CRT スキャンライン、グリッチ、フィルムグレイン、シャイマースイープ、紙吹雪バースト — 手動構築の前に | /hyperframes-registry |
| Figma アセット、トークン、コンポーネント、または再構築されたモーションとしてのストーリーボードフレーム | /figma |
クリエイター編集フレーズはクロスドメインリクエストです。一致する行に名前のあるすべてのスキルをロードします:
| クリエイターリクエスト | 必要なドメイン |
|---|---|
| 「この映像をカット」、ハードカット、トリム、スプライス、並べ替え、またはソース範囲を使用 | /general-video + /hyperframes-core;コアが data-start、data-duration、data-media-start、およびトラックレイアウトを所有します。 |
| ここにズームイン、パンチイン/パンチアウト、スムーズなマルチステートズームまたはフレーム変更、Ken Burns、またはカメラ移動 | /general-video + /hyperframes-core + /hyperframes-keyframes;タイムドクリップではなく、内部のビジュアル/クロップラッパーをアニメートします。 |
| マッチカットまたはウィップパンカメラトランジション | /general-video + /hyperframes-animation + /hyperframes-keyframes + /hyperframes-registry;手動オーサリングの前にトランジションプリミティブを検索/インストールします。 |
| フェード、クロスフェード、トラックゲイン/ボリューム、オートメーション、ダッキング/カーブ、オーディオエフェクト、または複数トラックにわたる1つのエフェクト | /general-video + /hyperframes-core + /hyperframes-audio;コアがクリップを配置し、オーディオが配置されたトラックをミックスします(それらのグループに対するサブミックスバスを含む)。 |
| カットをカメラモーションまたはミキシングと組み合わせるピクチャーアンドサウンド編集 |