プラグインのインストール: セットアップまたはfreshnessコマンドの前に、このスキルが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@<バージョン> を固定するので、レンダリングは再現可能に保たれます。固定は自動的に進みません。古い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 | PRリファレンスからGitHubプルリクエストまたはコード変更を説明する | /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 <ワークフロー名>
ベア名を / なしで使用します。コマンドが失敗した場合は、エラーを表示し、メモリからワークフローを再構築しないでください。インストールに関するその他すべて(コア対遅延分割、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 |
クリエイターの編集フレーズはクロスドメインリクエストです。一致する行に名前があるすべてのスキルをロードします:
| クリエイターリクエスト | 必要なドメイン |
|---|
...