プラグインのインストール: セットアップまたはフレッシュネスコマンドの前に、このスキルが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プロジェクトに対する特定の操作: inspect, diagnose, validate, preview, render, publish, batch-render | その操作のみを実行します。意図とワークフローのルーティングはスキップします。/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 のテーブルを使用して一度ルーティングします。 |
既存のプロジェクトを編集する場合、編集内容をプロジェクト履歴(/hyperframes-cli、あなたのターンのプロジェクト履歴)で囲んでください。
新しいリクエストが主題や入力を特定しない場合は、ルーティング前に動画の内容を尋ねてください。何かを尋ねる前に、設定とレシピを確認してください(references/intent-interview.md、ステップ1)。figma.com の入力や名前付きレシピは、ルーティングではなくインテークを変更します。インタビューの「異種入力を適応させる」セクションが両方を処理します。
プロジェクトの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 | 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 <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、batch render、Studio、render、publish、またはdiagnostics | /hyperframes-cli |
| レジストリブロックとコンポーネント | /hyperframes-registry |
| 名前付きルック、エフェクト、処理、トランジション — CRTスキャンライン、グリッチ、フィルムグレイン、シャイマースイープ、カンフェティバースト — 手作りする前に | /hyperframes-registry |
| Figmaアセット、トークン、コンポーネント、または再構築されたモーションとしてのストーリーボードフレーム | /figma |
クリエイター編集フレーズはクロスドメインリクエストです。一致する行に名前があるすべてのスキルをロードしてください。
| クリエイターリクエスト | 必要なドメイン |
…
[翻訳のため省略]