media-use は何をしますか？
HyperFramesのメディアOS：解決・生成・操作・記憶 — すべてのメディアタイプを一つのスキルで、コンテキストノイズゼロ。
初回実行：heygen CLIをインストールしてサインイン（無料利用パス）、その後 node <SKILL_DIR>/scripts/resolve.mjs --doctor で確認。セットアップとプロバイダーについては references/setup-providers.md を参照。
Resolve — 唯一の動詞
node <SKILL_DIR>/scripts/resolve.mjs --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 | 公式ブランドマーク（svgl → simple-icons → GitHubアバター → favicon；再描画禁止） |
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 を検査し、--capability <id> で1つの関連ファミリー/エフェクトをリクエストし、正規のコントロールからカスタムトリートメントを組み立てます。通常のオーサリングでは --all をロードしないでください。トリートメントは補正、プリセット、仕上げ、互換性のあるシェーダーエフェクト、サポートされているキーフレーム、オプションのRegistryオーバーレイを構成できます。ソースで正当化された範囲内のチューニングと互換性のある部分のみを追加し、結果をより洗練された見た目にするためのみのエフェクトは追加しないでください。最終的な複合ペイロードは 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 |