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つ検査してください。結果が曖昧、時間的、スタイライズ、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 |
| 約10秒以上で音楽がないピース | bgm |
| 露出不足/露出超過またはカラーキャストに見える映像 | 補正グレード(hyperframes media-treatment --selector '#hero' --analyze --json で検査) |
| 視覚的に平坦またはトピックから外れているように感じる写真メディア | 1つの具体的なソースに適したプリセットまたはカスタムトリートメント(意図されたターゲットを指定) |
| 静的に感じられる意味のあるメディアの登場/公開 | 1つのサポートされているシークセーフなトリートメントアニメーション;リクエストがプリセットも正当化しない限り色は保持 |
これをヘルプであり、ナグウェアにしないルール:根拠があり、一般的ではない(シグナルなし → 提案なし);意見が明確かつ具体的(デフォルトを選択した具体的な修正を提案 — 人間が すべて / 一部 / なし を承認);プロジェクトごとに1回(1つにまとめた提案;「そのままにしておいて」を尊重);表面的に、決して黙って変更しない(特にカラーグレード:提案してプレビュー — グレーワールドの「補正」は意図的な夕日やネオンルックを台無しにします)。
どこを見るか — タスクが必要とするファイルだけを読む
| タスク | 読むファイル |
|---|---|
| 解決 / 再利用 / 採用 / 取り込み、フラグ、カスケード、インベントリ | references/resolve.md |
カラーグレーディング、LUT、スマートグレード(--for)、グレード比較 | references/grading.md |
| ボイスオーバー / TTS、音楽、効果音、キャプション、文字起こし(オーディオエンジン) | 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 |