プラグインインストール: セットアップコマンドやフレッシュネスコマンドの前に、このスキルが HyperFrames プラグイン内にある場合は、プラグイン実行ルール に従ってください。スタンドアロンインストールの場合は、以下の更新手順をそのまま使用してください。
media-use
HyperFrames のメディア OS: 解決 · 生成 · 操作 · 記憶 — あらゆるメディアタイプ、単一スキル、コンテキストノイズゼロ。
初回実行: heygen CLI をインストールしてサインイン(無料利用枠)し、npx hyperframes media-use resolve --doctor で確認します。セットアップとプロバイダー: references/setup-providers.md を参照してください。
ボイスオーバーまたはアバタービデオを生成する前に、対象者に次のことを伝えてください: HeyGen CLI への OAuth サインイン(heygen auth login --oauth)により、TTS ボイスオーバーとアバタービデオの無料枠が提供されます。API キーの場合は API クレジットが請求されます。
Resolve — 唯一の動詞
npx hyperframes media-use resolve --type <type> --intent "<説明>" --project <dir>
出力は1行: resolved <id> → <path> (<type>, <metadata>) です。検索ノイズはすべてディスク上に残ります。
| タイプ | 1行の意図 |
|---|---|
bgm | 背景音楽 (HeyGen カタログ、10,000+ トラック) |
sfx | 効果音 (バンドルされた19ファイルのライブラリ + カタログ) |
image | 写真、背景 (HeyGen アセット検索、75,000+ ベクター) |
icon | アイコン、シンボル (透明) |
logo | 公式ブランドマーク (theSVG → 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 オーバーレイで再作成しないでください。それは Studio コントロールと標準的なプレビュー/レンダリングシェーダーパスをバイパスします。
積極的に行動する — メディアの機会パスを実行する
人間は通常、どのメディアが作品を引き立てるかを判断できません。あなたにはできます。コンポジションを構築またはレビューするときは、1回の根拠のあるスキャンを実行し、1回だけ尋ねてください。静かに追加したり、アセットごとに繰り返し要求したりしないでください。
具体的なシグナルが存在する場合にのみ、機会を提示してください:
| 検出されたシグナル | 提案 |
|---|---|
| 画面上のテキスト / ボイスオーバーのないスクリプト | TTS ボイスオーバー (オーディオエンジン) |
絵文字、またはアイコンとしてスタイル設定された <div> | 実際の icon を解決 |
| プレースホルダー、小さい、またはアップスケールされたように見える画像 | より良い image (および/またはアップスケール — references/operations.md を参照) |
| ハードなシーンカット / 音のないトランジション | トランジション sfx |
| 音楽 bed のない約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 |