プラグインのインストール: セットアップやフレッシュネスコマンドの前に、このスキルがHyperFramesプラグイン内にある場合は、プラグイン実行ルールに従ってください。スタンドアロンインストールの場合は、以下の更新手順を維持してください。
一般ビデオ
ワークフローが読み取ったばかりでない限り、最初に npx hyperframes usage --json を実行し、その後、下書き後やレンダリング前などのマイルストーンで再度確認してください。利用可能なウィンドウとリセット時間を読み取ってください。使用量が不明な場合は、許可値を推測せずにその旨を伝え、ユーザーとスコープとワークフローの選択を話し合ってください。
このワークフローに依存する前に、以下を実行してください：
npx hyperframes skills update general-video
更新がないという出力は、スキルが最新であることを意味します。メモリから続行する代わりに、更新の失敗を表面化してください。
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: 計画とスケッチレビューを実行します（boards/storyboard.html、形式は ../hyperframes-creative/references/storyboard-recipe.md）。no: なしでビルドします。 |
派生 mode | チェックポイントゲートの動作方法 | ブリーフコントラクトに従ってください。モードの命名をユーザーに求めないでください。 |
これらの状態の同義語を作成しないでください。進行中の「とにかくビルドして」というシグナルは、インテントレイヤーによって処理され、flow: automation、storyboard: no として届きます。
flow: automationの場合、最初の進捗更新でルートを選択し、それを1行で述べてください。- 特定の編集の場合は、新しいルートを発明せずに編集を実行してください。
既存のフッテージのハードカット、トリム、スプライス、または並べ替えの場合は、同じビデオソースを複数のクリップ要素に複製します。各コピーで、data-media-start と data-duration を使用してソース範囲を設定し、次に data-start で作成された配置/順序を設定します。各ビデオセグメントはサウンドを保持します。サウンドはクリップ上に残ります（data-has-audio="true"）。そのため、ビデオをカットするとそのサウンドもカットされます。/hyperframes-core がこの時間編集を所有します。/hyperframes-keyframes は、インナーラッパーでのズーム、パンチ、パン、クロップ、マスク、または clip-path などの視覚プロパティアニメーションにのみ使用してください。../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ボディセクションに決定を記録してください。ユーザーが明示的に変更した場合にのみ、frontmatterフィールドを書き換え、確認済みのプリファレンスを記録してください。 - 同じストーリーボード、検証、最終プレビュー、レンダリング承認ゲートを維持してください。コンパニオンは誰が舵を取るかを変更しますが、どのような品質が必要かを変更するわけではありません。
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ブロックとコンポーネント）をランク付けするため、セットアップ前のフェーズにも適用されます。 - スケッチ（ストーリーボードが
yesの場合）.… - 下書き.…
- 検証.…
- プレビュー.…
- レンダリング.…
- 最終承認.…
6. 出力品質の確保
- すべてのシーンは、ストーリーボードで承認されたトランジションを使用する必要があります。
- オーディオレベルは、ブリーフで指定されていない限り、-14 LUFS（統合）に正規化する必要があります。
- テキストオーバーレイは、少なくとも24ptのフォントサイズを使用し、読みやすさを確保するために十分なコントラストを確保する必要があります。
- 最終的なビデオは、ブリーフで指定された解像度とフレームレートである必要があります（デフォルトでは1920x1080、30fps）。
- 使用されたすべてのメディアアセットの来歴（ソースURL、ライセンス）を
BRIEF.mdに文書化する必要があります。
重要な注意点： このスキルのマークダウンは、SKILL.md の翻訳されたコンテンツを表しています。元のマークダウン構造、コードブロック、およびリンクはそのまま保持されています。