プラグインのインストール: セットアップやフレッシュネスコマンドの前に、このスキルがHyperFramesプラグイン内にある場合はプラグイン実行ルールに従ってください。スタンドアロンインストールの場合は以下のアップデート手順を維持します。
HyperFrames エントリーポイント
残り使用量の確認
作成開始時に npx hyperframes usage --json を実行します。ドラフト後やレンダリング前など、ワークフローの節目でもう一度確認します。使用量は実行中に変化するためです。利用可能なウィンドウとそのリセット時間を読み取ります。以前の読み取りは使用量を予約しません。コマンドが失敗した場合、利用できない場合、または status: unknown を返した場合は、使用量が不明であると報告し、推測しないでください。スコープとワークフローの選択肢はユーザーと相談して決定します。
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 | 音楽トラックからビート同期動画を構築する(ナレーションやWebサイトキャプチャなし) | /music-to-video |
| 6 | 明示的に短く、ナレーションなし、モーションファーストのユニットを作成する(通常10秒未満) | /motion-graphics |
| 7 | GitHubのプルリクエストやコード変更をPR参照から説明する | /pr-to-video |
| 8 | URLまたはサイト固有のブリーフからWebサイト、プロダクトサイト、アプリ、または会社をマーケティングまたは紹介する | /product-launch-video |
| 9 | プロダクトやサイトのキャプチャなしで、発明されたビジュアルを使ってトピック、記事、またはメモを説明する | /faceless-explainer |
| 10 | その他のカスタム動画またはコンポジション | /general-video |
ルートを確定する前に、references/routes/<workflow>.md を読みます。ルートごとに1つの小さなファイルです。標準的な入力/出力/トリガー契約(遅延インストールされたワークフロースキルが利用可能になる前に利用可能)と、そのルートのインタビューエントリが含まれています。候補がその契約を満たさない場合、マッチを強制せずにルーティングを続行します。一致したルートのファイルのみを読みます。
一般的な曖昧性を解決する
- 短いアニメーションタイトル、ロゴスティング、統計ヒット、チャートヒット、マップヒット、またはスタンドアロンのローワーサードは、ナレーションがなくモーションがメッセージである場合は
/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. 1回ルーティングしたら、そのままにする
新規作成の場合、インテントレイヤー(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 |
クリエイター編集フレーズはクロスドメインリクエストです。一致する行に名前のあるすべてのスキルをロードします。
| クリエイターリクエスト | 必要なドメイン |
…
[以下切り詰め]