計測に基づくビデオ編集
原則: 色は計測で判断します。私が提案するすべての色変更には、その動機となった数値(スコープ、パーセンタイル、肌の角度)と変更後の数値が付随します。このスキルのすべてのルールには出典が明記されており、出典がないものは [出典なし] と表示され、ルールとして扱われません。
明示的な制限: 私はフレームと数値を確認できますが、動画を再生して視聴することはできません。リズム、カットの感触、ルックの好みは依頼者の判断に委ねられます。 納品時には、必ず依頼者にスマートフォンで確認するようお願いします。
必要条件: ffmpeg と ffprobe(バージョン 8.1.2 でテスト済み、R61 には libvidstab が必要)、Python 3.10+ に numpy と Pillow(pip install numpy pillow)。
ファイル
| ファイル | 用途 |
|---|---|
scripts/escopos.py | シーンごとの診断:スコープシート(波形、パレード RGB、肌色ライン付きベクタースコープ、ヒストグラム)+ 警告と出典を含む diagnostico.md/json |
scripts/comparar.py | シーンごとの編集前後比較:シート、1080p の split_cenaN.png、数値の表、解決済み/新規の警告 |
scripts/graduar.py | 補正計画(JSON)を信号順、RGB 16 ビットで適用;--previa で編集前後の静止フレームを生成 |
scripts/gerar_lut.py | 承認された補正を .cube(33/65)に変換(Premiere/Resolve/CapCut 用)、PSNR で検証 |
scripts/montar.py | カットリスト(JSON)に基づき、ストレートカット、J カット、L カットでセグメントを編集 |
scripts/receitas.py | 出典付きの 38 の ffmpeg レシピ;testar clipe.mp4 で全て実行;md で referencias/receitas-ffmpeg.md を生成 |
referencias/cor-fluxo.md | 信号順序、コントラスト、カーブ、彩度、16 ビット精度 |
referencias/niveis-e-escopos.md | BT.709、EBU R103 v3.0、各スコープの読み方、スクリプトによる計測方法 |
referencias/pele.md | 肌色ライン、クロマ範囲、症状→原因→修正 |
referencias/hdr-hlg.md | iPhone HLG→SDR、BT.2408 レベル、計測ベースのチェーン |
referencias/corte.md | Murch(6 つのルール、まばたき)、アクションカット、J/L カット、オーディオ編集、同期 |
referencias/plataformas.md | Meta と TikTok:フォーマット、セーフエリア、長さ、公式/非公式の情報 |
referencias/receitas-ffmpeg.md | グループ別の 38 レシピ(入力、診断、色、ルック、カット、レイヤー、動き、仕上げ、オーディオ、出力) |
ワークフォルダ:作品ごとに 1 フォルダ(例:editar-video/<プロジェクト>/<作品>/):生データ、計画、プレビュー、シート、最終成果物をまとめて管理。
以下のコマンドでは、~/.claude/skills/editar-video がスキルのインストール先です。別の場所にインストールした場合は適宜調整してください。
ステップ 0 — 入力(ゲートなし)
python ~/.claude/skills/editar-video/scripts/receitas.py mostrar R01 # ファイルで実行
何よりも先に、ffprobe の数値で以下を判断:
color_transfer=arib-std-b67(HLG)またはsmpte2084(PQ)→ 最初に SDR に変換(referencias/hdr-hlg.md、R03)。タグを変更するだけでは不十分。r_frame_rate ≠ avg_frame_rate→ 可変フレームレート:カット前に R02 を実行(Meta は固定フレームレートを要求、Ads Guide)。color_range=pc→ 変換前にコンテンツが本当に 0–255 範囲かを確認(R04)。signalstatsはレンジタグを無視。- AI 生成ファイル、スクリーンレコーディング:タグなしまたはフルレンジで来ることが多い。仮定せずに計測。
ステップ 1 — 計測に基づく診断(ゲート 1)
python ~/.claude/skills/editar-video/scripts/escopos.py bruto.mp4 -o diag # SDR
python ~/.claude/skills/editar-video/scripts/escopos.py bruto.mp4 -o diag --sdr # HLG:トーンマップ後に計測
python ~/.claude/skills/editar-video/scripts/escopos.py bruto.mp4 --pele 0.35,0.15,0.3,0.25 # 顔の領域
VER → 拡大 → 確認 の方法でシートを読む:フレーム、各スコープ、数値の順。以下を表示:
- シート(
folha_escopos.png)とシーンごとのテーブル; - 計測された事実を 1 行ずつ、ルールと出典と共に:「シーン 2:ハイライト R 98.6 / G 90.0 / B 80.2 → ハイライトに暖色優位、壁が白なら(Adobe、パレード RGB)」;
- 計測からわからないこと(例:暖色が意図的かどうか)。
自動肌マスク(Chai & Ngan)は木、ベージュ、オレンジをピックアップします。顔が小さい場合や同色のオブジェクトがある場合は、--pele で顔領域を指定します。
ゲート 1: 依頼者が問題点と意図を確認します。依頼者が希望する色味の偏りは修正しません。
ステップ 2 — 補正計画とプレビュー(ゲート 2)
plano.json を記述(フォーマットは graduar.py の先頭に記載)。各操作には、計測された理由を `