プラグインインストール: セットアップまたはフレッシュネスコマンドの前に、このスキルがHyperFramesプラグイン内にある場合は、プラグイン実行ルールに従ってください。スタンドアロンインストールの場合は、以下のアップデート手順を使用します。
media-use
HyperFramesのためのメディアOS:解決・生成・操作・記憶 — すべてのメディアタイプ、1つのスキル、コンテキストノイズゼロ。
初回実行:heygen CLIをインストールしてサインイン(無料利用パス)、その後npx hyperframes media-use resolve --doctorで確認します。セットアップとプロバイダについては、references/setup-providers.mdを参照してください。
音声ナレーションやアバタービデオを生成する前に、次のことをユーザーに伝えてください:OAuthでheygen CLIにサインインする(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を検査し、関連する1つのファミリー/エフェクトを--capability <id>でリクエストし、正規のコントロールからカスタムトリートメントを組み立ててください。通常のオーサリングでは--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 |
| 約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 |