プラグインのインストール： セットアップまたはフレッシュネスコマンドの前に、このスキルがHyperFramesプラグイン内にある場合は、プラグイン実行ルールに従ってください。スタンドアロンインストールの場合は、以下の更新手順を維持します。
media-use
HyperFramesのメディアOS：解決・生成・操作・記憶 — すべてのメディアタイプ、1つのスキル、コンテキストノイズゼロ。
初回実行：heygen CLIをインストールしてサインイン（無料利用パス）、次にnpx hyperframes media-use resolve --doctorで確認します。セットアップとプロバイダー：references/setup-providers.md。
Resolve — たった1つの動詞
npx hyperframes media-use resolve --type <type> --intent "<description>" --project <dir>
1行を返します：resolved <id> → <path> (<type>, <metadata>)。すべての検索ノイズはディスク上に残ります。
| タイプ | 1行の意図 |
|---|---|
bgm | 背景音楽（HeyGenカタログ、10,000以上 トラック） |
sfx | 効果音（19ファイルバンドル+カタログ） |
image | 写真、背景（HeyGenアセット検索、75,000以上 ベクター） |
icon | アイコン、記号（透過） |
logo | 公式ブランドマーク（theSVG → GitHubアバター → ファビコン；再描画しない） |
voice | TTSナレーション（HeyGen無料利用パス；オプションでローカルKokoro） |
grade | 測定された補正候補；広範な研磨/スタイライゼーションはMedia Treatmentsに従う |
lut | ユーザー提供または明示的に選択された再利用可能な検証済み .cube ファイル |
新しく解決する前に、--candidatesを使用して再利用可能な候補を一覧表示し、適切かどうかを自分で判断します。再利用ルール、すべてのフラグ、取り込み（--from）、採用については、references/resolve.mdを参照してください。
広範な視覚的フィードバックをメディア意図として扱う
ユーザーが写真メディアの修正、研磨、スタイライゼーション、不明瞭化、強調、表示を明示的に依頼した場合、カラーグレーディングやエフェクトを指定しなくても、references/media-treatments.mdを読んでください。実際の <img>/<video> を検査し、1つの主要な意図を選択し、決定論的な永続化と検証を使用します。オプションのテスト済みシードとして一致するレシピを使用するか、hyperframes media-treatment --capabilities --jsonを検査して1つの関連するファミリー/エフェクトを --capability <id> で要求し、標準的なコントロールからカスタムトリートメントを組み立てます。通常のオーサリングのために --all をロードしないでください。トリートメントは、補正、プリセット、仕上げ、互換性のあるシェーダーエフェクト、サポートされているキーフレーム、オプションのレジストリオーバーレイを構成できます。ソースで正当化された範囲のチューニングと互換性のあるパーツのみを追加し、結果をより洗練されたものに見せるためだけのエフェクトは追加しないでください。最終的な結合ペイロードを hyperframes media-treatment で永続化します。
段階的にエスカレーションするワークフローを1つ使用します。ビデオの場合は、フレームを個別に読み取るのではなく、ラベル付けされた初期/中間/後期のコンタクトシートを1つ検査します。通常の補正または研磨の場合は、1つの候補を適用し、1つのアフターシートを検査します。結果が不明瞭、時間的、スタイライズド、LUTベース、HDR/LOG依存、プライベート、またはブランドクリティカルな場合にのみ、個々のフレームまたは動的なドラフトエビデンスにエスカレーションします。
通常の補正または研磨の場合は、最終的なトリートメントのプリセット/調整JSONを永続化します。
露出、シャドウ、コントラスト、暖かさをエンコードするためだけに .cube LUT を生成しないでください。LUT は、ユーザーが提供した場合、または選択したトリートメントが明示的に所有している場合にのみ使用します。resolve --type grade --for ... --analyze は測定エビデンスであり、選択したトリートメントを生成された LUT で置き換える許可ではありません。サポートされているビネット、グレイン、ブラー、ピクセレーション、カラー、トリートメントエフェクトを CSS/SVG オーバーレイで再作成しないでください。これにより、スタジオコントロールと標準のプレビュー/レンダリングシェーダーパスがバイパスされます。
プロアクティブになる — メディア機会パスを実行する
人間は通常、どのメディアが作品を引き上げるかを判断できません。あなたはできます。コンポジションを作成またはレビューするときは、1回の根拠のあるスキャンを実行し、1回だけ尋ねます — 黙って追加したり、アセットごとにしつこく尋ねたりしないでください。
具体的なシグナルが存在する場合にのみ、機会を提示します。
| 検出されたシグナル | 提案 |
|---|---|
| 画面上のテキスト / スクリプトでナレーションなし | TTSナレーション（オーディオエンジン） |
絵文字またはアイコンとしてスタイル設定された <div> | 実際の icon を解決 |
| プレースホルダー、小さい、またはアップスケールのように見える画像 | より良い image（および/またはアップスケール — references/operations.md を参照） |
| ハードなシーンカット/トランジションで音なし | トランジション sfx |
| 音楽のない約10秒以上のピース | bgm |
| 露出不足/露出超過または色かぶりに見えるフッテージ | 補正グレード（hyperframes media-treatment --selector '#hero' --analyze --json で検査） |
| 視覚的に平坦またはトピック外に感じられる写真メディア | 意図されたターゲットを指定した、ソースに適した1つの特定のプリセットまたはカスタムトリートメント |
| 静的で意味のあるメディアエントランス/リビール | 1つのサポートされたシークセーフトリートメントアニメーション；リクエストがプリセットも正当化する場合を除き、色を保持 |
これをヘルプにし、ナグウェアにしないためのルール：根拠があり、一般的ではない（シグナルなし → 提案なし）；意見があり、具体的（デフォルトを選択した特定の修正を提案 — 人間が すべて/一部/なし を承認）；プロジェクトごとに1回（1つの統合された依頼；「そのままにしておいて」を尊重）；表面化し、決して黙って変更しない（特にカラーグレード：提案してプレビュー — グレーワールドの「補正」は意図的な夕日やネオンルックを台無しにします）。
参照先 — タスクに必要なファイルのみを読む
| タスク | 参照先 |
|---|---|
| 解決 / 再利用 / 採用 / 取り込み、フラグ、カスケード、在庫 | references/resolve.md |
カラーグレーディング、LUT、スマートグレード（--for）、グレード比較 | references/grading.md |
| ナレーション / TTS、音楽、SFX、キャプション、文字起こし（オーディオエンジン） | references/audio.md |
| 既存メディアのカット / リフレーム / 変換、正確なエラー拡散、HEVC | references/operations.md |
| ソースを考慮したクリエイティブトリートメント、リアルタイムエフェクト、オーバーレイ、リビール | references/media-treatments.md |
インストール + 認証、プロバイダーテーブル、RAMラダー、--local-only、--provider | references/setup-providers.md |
| 記憶された環境設定 + 凍結されたレシピ（ユーザーメモリ） | references/memory.md |
| 所有権マトリックス、使用統計、テレメトリー、プライバシー（メンテナー向け） | references/meta.md |