プラグインのインストール: セットアップやフレッシュネスコマンドの前に、このスキルがHyperFramesプラグイン内にある場合は、プラグイン実行ルールに従ってください。スタンドアロンインストールの場合は、以下の更新手順を維持してください。
一般ビデオ
ワークフローが直前に読み込んだ場合を除き、最初に npx hyperframes usage --json を実行し、ドラフト後やレンダリング前などのマイルストーンで再度確認してください。利用可能なウィンドウとリセット時間を読み取ってください。使用量が不明な場合は、許可を推測せずにその旨を伝え、ユーザーとスコープおよびワークフローの選択を一緒に検討してください。
このワークフローに依存する前に、以下を実行してください:
npx hyperframes skills update general-video
成功したno-op(何も変更がないこと)は、スキルが最新であることを意味します。メモリから続行する代わりに、更新の失敗を表示してください。
1. 横断的なソースアダプターを適用する
- メディア: オーディオ、画像、アイコン、ロゴ、音声、グレーディング、LUT、トリートメント/エフェクト、キャプション、またはメディア操作のニーズについては、
/media-useをロードし、../media-use/references/resolve.md(解決、採用、再利用)および../media-use/references/setup-providers.md(プロバイダー、認証)に従ってください。曖昧なフッテージフィードバックや名前付きスタイルには、編集前に../media-use/references/media-treatments.mdを使用してください。CSS/SVG/不透明度でサポートされているメディアエフェクトを即興で作成しないでください。最初の認証済みプロバイダーアクションの前に、npx hyperframes auth statusを実行し、その出力をそのまま中継してください。サインアウトしている場合は、../hyperframes/references/brief-contract.mdのゲートを適用します: 共同制作の場合はサインインまたは明示的なオフライン選択を待ちます。自律モードの場合はステータスを通知し、利用可能なオフラインプロバイダーで続行します。必要な機能を満たせるオフラインプロバイダーがない場合は、ブロッカーを表示します。ローカル採用のみでは認証ゲートは必要ありません。 - Figma: 入力が
figma.comのURLである場合は、最初に/figmaを実行してください。エクスポートされたアセット、トークン、コンポーネント、またはストーリーボードフレームからビルドしてください。生のFigmaコネクター呼び出しは使用しないでください。SVGのサニタイズ、メディアの発祥、ブランドトークンのバインディングをスキップするためです。
これらのアダプターは、/hyperframes によって選択されたワークフローを変更しません。
2. プロジェクトの状態から開始する
最初に一致する行を適用してください。下位の状態行は評価しないでください:
| 状態 | アクション |
|---|---|
| 特定の編集 | 編集を行い、既存のプロジェクト決定を維持し、影響を受けるチェックを再実行します。発見を再開しないでください。 |
BRIEF.md が存在する | それを読みます。workflow が別のワークフローを指定し、flow が companion でない場合は、引き継ぎます。ブリーフの質問は行いません。 |
ブリーフはないが、hyperframes.json または STORYBOARD.md が存在する | ファイルと記録された設定から再開します。BRIEF.md は既知の事実からのみバックフィルします。 |
| 新規作成 | /hyperframes とそのインテントレイヤーを実行します。workflow: general-video または flow: companion の場合のみここに戻ります。 |
新規プロジェクトの場合は、ブリーフからケバブケースのディレクトリ名を選び、ブリーフを書く前にスキャフォールディングしてください:
npx hyperframes init "videos/<project>" --non-interactive --example=blank --skill=general-video
次に、../hyperframes/references/brief-format.md を使用して、プロジェクトルートに BRIEF.md を書きます。既存のプロジェクトでは、ルートは hyperframes.json を含むディレクトリです。ブリーフフォーマットで指定された、確認済みの設定に基づくフィールドのみを記録し、node <MEDIA_DIR>/scripts/prefs.mjs record --hyperframes <PROJECT_ROOT> を使用してください。推測されたデフォルトは決して記録しないでください。ここで <MEDIA_DIR> はインストールされた /media-use スキルディレクトリ、<PROJECT_ROOT> は hyperframes.json を含むディレクトリです。インテントレイヤーがレシピを採用した場合は、今すぐ node <MEDIA_DIR>/scripts/recipe.mjs use --hyperframes <PROJECT_ROOT> --name <name> で適用し、再度尋ねないでください。
3. ランシェイプ(実行形状)を解釈する
../hyperframes/references/brief-contract.md の正規の用語のみを使用してください:
| フィールド | 意味 | 効果 |
|---|---|---|
flow | 誰が主導するか | automation: ルートを選択して実行します。companion: 会話の中で共同制作します。 |
storyboard | ビルド前に計画、スケッチ、レビューを行うか | yes: 計画とスケッチレビューを実行します(storyboard.html)。no: それなしでビルドします。 |
派生した mode | チェックポイントゲートの動作方法 | ブリーフコントラクトに従います。モードの名前をユーザーに尋ねないでください。 |
これらの状態の同義語を作成しないでください。進行中の「とにかくビルドして」というシグナルはインテントレイヤーによって処理され、flow: automation、storyboard: no として到着します。
flow: automationの場合、ルートを選択し、最初の進捗更新で1行でそれを述べてください。- 特定の編集の場合、新しいルートを発明せずに編集を行ってください。
既存のフッテージのハードカット、トリム、スプライス、または並べ替えには、同じビデオソースを複数のクリップ要素に複製します。各コピーで、data-media-start と data-duration でソース範囲を設定し、次に data-start で作成者の配置/順序を設定します。各ビデオセグメントはそのサウンドを保持します: サウンドはクリップ上に残るため(data-has-audio="true")、ビデオをカットするとそのサウンドもカットされます。/hyperframes-core がこの時間的編集を所有します。ズーム、パンチ、パン、クロップ、マスク、または内部ラッパーの clip-path などの視覚プロパティのアニメーションには /hyperframes-keyframes のみを使用してください。../hyperframes-core/references/creator-editing-recipes.md から完全なコントラクトをコピーしてください。
コンパニオンフロー
flow: companion の場合:
BRIEF.mdを読み、受け入れられた## Assetsおよび## Customizationsをプロジェクトアーティファクトと照合します。まだ保留中の受け入れられた作業を完了します。完了した作業はそのままにしておきます。受け入れられた機能を新しいかのように再度提供しないでください。- 請負業者ではなく、ディレクターとして立ち現れてください。 コンパニオンを選択したユーザーは、関与と品質を選択したのです。正直な応答は、あなたがデザインできる最良のバージョンであり、防御できる最小のものではありません。最初のプランは天井のトリートメントです:ストーリーアーク(最も近いジャンルのレンズを借用する — メニュー § ジャンルレンズ)、デザイン仕様、名前で引用された各シーンのモーショントリートメント(§ 5の計画規律)、トランジション、オーディオアイデンティティ — 音楽とサウンドマーク、または意図的な無音 — ユーザーの素材の配置、そしてデザインされたオープンとクローズ。各レイヤーが何を追加するかを1行で述べてください。高価なもの(レンダリング時間、サインイン、課金)に名前を付ける際にフラグを立ててください。ユーザーはトリートメントを削減します。承認ごとに組み立てる必要はありません。
- 天井はコンセプトに属し、ツールボックスに属しません。 すべてのレイヤーはブリーフのメッセージに奉仕しなければなりません — どんなビデオも同じように飾り立てるトリートメントは装飾です。クラフトは天井にまで高まります。コンテンツは決して求められたものを超えて成長しません(§ 6)。
- チェックポイント間では、
../hyperframes/references/capability-menu.mdは2つの方法で機能します。トリガーリストとして: ユーザーがその入力を言及したとき、またはビルドがそのニーズに達したときに関連する機能を提供します。各パスのアップグレードチャネルとして: 計画、スケッチ、またはビルドのチェックポイントは、ユーザーが見ているマテリアルに向けられた1つか2つのトレースされたオファーを運ぶことがあります(「シーン3の統計はカウントアップトリートメントを必要としています」)。提供する前にそれを読んでください。完全なカタログをダンプしないでください。 - ユーザーが機能を受け入れた後、そのアーティファクトを生成し、即座に一致する
BRIEF.md本文セクションに決定を記録してください。ユーザーが明示的に変更した場合にのみ、フロントマターのフィールドを書き換え、確認済みの設定を記録してください。 - 同じストーリーボード、バリデーション、最終プレビュー、レンダリング承認のゲートを維持してください。コンパニオンは誰が操縦するかを変更しますが、品質に必要なものを変更しません。
4. 各段階の前に必要な知識をロードする
これらの読み込みは、条件が一致する場合に必須です:
| 条件 | 行動前の読み込み |
|---|---|
| 任意のコンポジションHTMLまたはシーンレイアウト | /hyperframes-core; レイアウトコントラクトについては references/determinism-rules.md を使用 |
| 任意の非自明な作成または視覚的トリートメント | /hyperframes-creative → references/house-style.md および references/video-composition.md |
| 任意のモーション、アニメーション、またはシーントランジション | /hyperframes-animation; そのルーティングに従い、一致するルール、アダプター、ブループリント、またはトランジション参照に従ってください |
storyboard: yes | ../hyperframes/references/storyboard-format.md および ../hyperframes/references/review-loop.md |
| 任意のメディアアセットまたは操作(ナレーション、BGM、SE、キャプション、グレーディング、トランスフォームを含む) | /media-use(それらのためのホストアプリ自身の音楽および効果音ツールが優先されます); フレームワークの再生と配置については /hyperframes-core → references/variables-and-media.md も読み込んでください |
| マルチシーンアセンブリ | ../hyperframes/references/production-loop.md |
flow: companion、最初の計画の前 | /hyperframes-creative → references/story-spine.md および references/house-style.md; 最も近いジャンルのレンズと ../hyperframes/references/capability-menu.md の全文 — 天井トリートメントはこれらからデザインされ、記憶から呼び出されるものではありません |
| コンパニオン機能の提供、キャプチャ、ビートグリッド、生成ビデオ、マップ、公開、またはクロスワークフロー機能 | ../hyperframes/references/capability-menu.md |
| デザイン仕様が存在する場合、最終承認前 | /hyperframes-creative → references/design-adherence.md |
これらの読み込みを記憶に置き換えないでください。プログレッシブディスクロージャーは、一致する参照が実際にロードされた場合にのみコンテキストを保存します。
5. コンポジションを実行する
この依存関係順序を使用してください。入力がない場合にのみ段階をスキップしてください。
- 計画。 視聴者のアーク、構造、リズム、および期間ドライバーを述べてください。短い単一シーンには1つのファイルを使用してください。3つ以上のハードシーンカットまたは再利用されるシーンにはサブコンポジションを使用してください。ナレーション付きアークについては
/hyperframes-creative→references/story-spine.mdを、リズムについてはreferences/beat-direction.mdを、構造については/hyperframes-core→references/composition-patterns.mdを読んでください。オープンエンドのマルチシーンブリーフの場合は、/hyperframes-creative→references/prompt-expansion.mdを通じてプロンプトを拡張してください。マルチシーンプランは各シーンの形状を引用します:/hyperframes-animation→blueprints-index.mdからのブループリントID(適合する場合)、または適合しない場合に構成する名前付きルールをrules-index.mdから — モーション名はこれらのインデックスから取得され、決して発明されません。ストーリーの真実がどのシーンが存在するかを決定します。引用がそれらをドレスアップします。名前付きのルックを自分でビルドする計画を立てる前に、ライブカタログを検索してください: ブリーフが名前を挙げるすべてのルック、エフェクト、トリートメント、またはトランジションについて — 「CRTスキャンライン」、「グリッチ」、「フィルムグレイン」、「きらめくスイープ」、「紙吹雪の爆発」 —npx hyperframes catalog --query "<ルックを平易な英語で>" --jsonを実行し、計画がそのルックのビルド方法を命名する前に上位の結果を読んでください。この検索にはインストールは不要です: プロジェクトも、事前のaddも、アカウントも必要ありません。任意のディレクトリからホストされたレジストリ全体(約400のブロックとコンポーネント)をランク付けするため、ビルド途中でユーザーが尋ねたルックにも適用されます。計画が命名するブロックはステージ3でインストールされます。検索しても適合するものがない場合にのみ、ルックを手動で作成してください。マルチシーンプランはディスパッチアーティファクトとしても記録されます:STORYBOARD.mdにシーンごとに1つの## Frame Nブロック —status: outline、宣言されたsrc:、ブループリント/ルールの引用、および
…
[以降のtruncated部分は省略]