HyperFrames エントリーポイント
HyperFrames は HTML から動画をレンダリングします。コンポジションとは、DOM が data-* 属性でタイミングを宣言し、アニメーションランタイムがシーク可能で、メディア再生がフレームワークによって管理される HTML ファイルです。完全なオーサリング契約は /hyperframes-core にあります。コンポジション HTML を記述する前にそれを読んでください。
1. プロジェクトの状態から開始する
最初に一致する行を適用してください。それより低い状態の行は評価しないでください。
| 状態 | アクション |
|---|---|
| 既存の Remotion ソースを HyperFrames に明示的に移植する | references/routes/remotion-to-hyperframes.md を読み、そのワークフローに直接ルーティングします。インテントレイヤーはスキップします。 |
| 既存の HyperFrames プロジェクトに対する特定の操作：検査、診断、検証、プレビュー、レンダリング、公開、またはバッチレンダリング | その操作のみを実行します。インテントとワークフロールーティングはスキップします。/hyperframes-cli と必要なドメインスキルをロードします。 |
| 既存のプロジェクトへの特定の編集 | 編集を行います。インテントレイヤーは実行しないでください。 |
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 入力または名前付きレシピは、インテークを変更しますがルーティングは変更しません。インタビューの「直交入力を適応させる」セクションが両方を処理します。
プロジェクトの CLI を最新に保つ
スキャフォールディングされたプロジェクトは、hyperframes@<version> を package.json のスクリプトに固定しているため、レンダリングは再現可能です。この固定は自動的に更新されることはなく、古いCLIの固定された実行はそれに関する警告を出力しません。固定を含むスクリプトでプロジェクトを再開する場合、最初のレンダリングに影響するコマンドの前に一度だけプローブします。
npx hyperframes@latest upgrade --project . --check
プローブは読み取り専用で、固定バージョンを最新リリースと比較します。明示的に . を付けてください。古いCLIリリースでは、ベアの --project の後に別のフラグが続くと、そのフラグがディレクトリ値として消費されます。プロジェクトが遅れていると報告された場合、またはCLI出力がすでにそれを示している場合（固定されたスクリプトからの --json 結果における stderr 通知 This project pins hyperframes@… (latest …) または _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を使用してください。確認されたスケッチボード自体が要求された成果物である場合があります。レビューループがその停止点を定義します。 - 特殊なナラティブワークフローは約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 |
| 初期化、リント、チェック、スナップショット、比較、バッチレンダリング、Studio、レンダリング、公開、または診断 | /hyperframes-cli |
| レジストリブロックとコンポーネント | /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。コアがクリップを配置し、オーディオミックスが配置されたトラックをミックスします。これには、それらのグループに対するサブミックスバスが含まれます。 |
| カメラモーションまたはミキシングとカットを組み合わせたピクチャーおよびサウンド編集 | /general-video + /hyperframes-core + /hyperframes-keyframes（視覚的なモーションがある場合）+ /hyperframes-audio（サウンドがフェード、ミックス、ダッキング、自動化、または処理されている場合）。 |
| メディアをソースまたは生成する、またはサポートされていないスピードランプ/ミッドソースフリーズを前処理する | /media-use。ソーシング/生成/前処理のみ。配置されたトラックミキシングは行いません。 |
定数の data-playback-rate は、ピクチャーおよびピッチ保持されたサウンドに対してレンダリングセーフです。ソーススピードランプをキーフレーム可能にすることはありません。ランプは前処理してください。コピー可能な編集契約については、/hyperframes-core → references/creator-editing-recipes.md をロードしてください。
写真メディアに関する広範なフィードバックは…
[翻訳のため省略]