ビデオチェック:レンダリングの問題を誰よりも先に見つける
これは video-check 0.2.3 です。
ユーザーは、プロの編集者が書き出しをチェックするようにチェックされた動画と、測定内容、確認した項目、修正した項目、誰もチェックしなかった項目を簡潔に記した REVIEW.md を受け取ります。
以下の3つのことは常に当てはまります。
- 最初に測定し、その後で目視する。 フレームだけを見ているモデルは、無変化の領域や1フレームのグリッチを見逃します。FFmpeg は見逃しません。目視する前に
check.pyを実行し、動画が「問題なさそうに見えた」という理由でスキップしてはいけません。 - 作成者は最悪のレビューアです。 各ショットが何を示すべきか知っているため、絵ではなく計画を見てしまいます。あなたの計画を知らない人にフレームシートを確認してもらいましょう(ステップ3)。
- あなたは音を聴けません。 スクリプトはラウドネス、ピーク、無音を測定します。音楽が合っているか、効果音が正しいか、話し言葉が明瞭かは、人間が聴く必要があります。その都度、その旨を伝えてください。
入力がない場合
レンダリングされたファイルがこのマシンにある必要があります。ユーザーが動画を口頭で説明するだけ、またはプラットフォームへのリンクを提供する場合は、ファイルを要求してください。TikTok、YouTube、Instagram からはダウンロードしないでください。自分で動画を作成した場合は、サイズ、フレームレート、長さ、ラウドネスターゲット、意図的な静止画やフラッシュといった計画も把握しています。ユーザーが自身の編集を持ち込む場合は、用途(プラットフォーム、長さ)を尋ね、その他は後述のデフォルト値を使用してください。
ワークフロー
-
測定する。 計画をスクリプトに渡して、欠陥と選択を区別させる:
python scripts/check.py final.mp4 --out work/check1 --loudness -14自分で動画を作成した場合、またはユーザーから計画を聞いた場合、それを追加します:例
--expect 1080x1920 --fps 30 --duration 32 --holds 28.5-32 --flashes 12.4。サイズ、フレームレート、長さをプラットフォームから推測しないでください:誰も1080pを要求していない960x540のファイルはサイズ欠陥ではありません。計画がない場合は--expectを省略してください。--holdsは意図的な静止画(エンドカード、静止したタイトル)をリストします。--flashesは計画された1フレームのフラッシュやディップをリストします。--loopはループ用の作品に使用します。--audio noneは無音の作品に使用します。オンライン動画は約-14 LUFSにノーマライズされています。ポッドキャストには-16、放送には-23を使用してください。結果はP0/P1/P2 t=… code: what -> fixとして出力され、check.json、overview_NN.png、findings.pngが書き出されます。references/reading-the-checks.mdは各チェックが捕捉するものと見逃すものを説明しています。 -
P0は今すぐ修正する。 サイズ違い、フレームレート違い、長さ違い、音声があるべきところにない、クリッピング:これらはレンダリングミスであり、好みの問題ではありません。コマンドを修正し、再度レンダリングし、誰かが見る前にステップ1を再実行してください。ラウドネス、クリッピング、トゥルーピークについては、編集プロジェクトがあればミックスを修正します(音楽、最も大きい音を下げる)。完成したファイルしかない場合は、
python scripts/fix_sound.py in.mp4 out.mp4 --loudness -14を実行します。これによりピークを制限し、2パスでノーマライズし、映像をそのままコピーして、ターゲットの±0.2 LU以内、-1.5 dBTP未満に収めます。シングルパスのloudnormはピークターゲットを外し、単純なリミッターはミックスを静かにしたままにします。フィルタを何度も手動で調整しないでください。 -
新鮮な目で見る。 すべての概要シートと
findings.pngを Read ツールで開きます。次に、あなたの計画を知らない別の人にチェックを依頼します:- サブエージェントを起動できる場合は、シート、プラットフォーム、動画の目的についての一文だけを渡します。計画、コード、意図は渡さないでください。
references/review-guide.mdのブリーフを使用します。 - できない場合は自分で見ますが、計画は覆い隠します:各シートを他人のように説明し、1フレームにつき一文で、判断する前に説明します。
REVIEW.mdに「one context」と書きます。
各問題は
t=12.4s · 画面上の位置 · 問題内容 → 修正方法と書き、P0(壊れている、読めない)、P1(視聴者が気づく)、P2(微調整)に分類します。10段階評価は付けません。評価は修正点を見つけられません。references/review-guide.mdのリストを確認します。このリストには、テンプレートや機械が作ったように見える編集の兆候(スライド風の進行バーやステップカウンター、すべてのラインが同じように表示される、プラットフォームボタンの下のテキスト、空の最初のフレーム、誰も指定していない数字)が含まれています。 - サブエージェントを起動できる場合は、シート、プラットフォーム、動画の目的についての一文だけを渡します。計画、コード、意図は渡さないでください。
-
最悪の3つを修正し、再チェックする。 P0と最も悪いP1を3つ取ります。それぞれについて、レンダリングされたファイルではなく、編集リストまたはコマンドを変更します。修正方法を知らない場合は、
search_techniquesで目的の結果(例「音楽をスピーチに合わせて下げる」「カットで音声をフェードアウトする」)を検索し、get_techniqueでプロンプトを取得します。レンダリング後、--before work/check1/check.json --out work/check2を指定してステップ1を再実行します。修正された項目、まだ残っている項目、新たに発生した項目がリストされ、before_after.pngが描画されます。変更したフレームを確認します。 -
3ラウンドで停止する。 3ラウンド目でもP0が残っている、または大きな変更が必要な場合は、ループせずにユーザーに残っている問題とその理由を伝えます。ユーザーの判断が必要な問題(別の曲、存在しないショットなど)は質問としてユーザーに投げかけます。
成果物
最初に、バージョンチェック。 EditAtlas MCP が接続されている場合、get_skill を名前なしで呼び出します。video-check が 0.2.3 より上をリストしている場合、返信の最初の行に新しいバージョンが存在することとその更新方法(Claude Codeの場合:/plugin、次に Marketplaces、editatlas-skills、Update marketplace;それ以外の場合:get_skill に name video-check で手順が表示されます)を記述します。MCP がない場合はスキップします。
動画の隣に、ユーザーの言語で REVIEW.md を書き、references/review-guide.md のテンプレートを使用します:
- 1行での判定:準備完了(残っている問題なし)、注意事項付き準備完了(注意事項には残っているすべての所見を列挙し、残っている各P1は編集プロジェクトなど、あなたが持っていないものが必要な場合)、または準備未完了(P0がまだある、またはあなたが修正可能なP1がある)。
- スクリプトが測定した内容(サイズ、フレームレート、長さ、ラウドネス、トゥルーピーク、1分あたりのカット数)と各ラウンドで修正された所見。
- 各ラウンドで残っている所見とその時間、および
check.pyが出力したパターン(例「0.4秒から12フレームごとに1回;11.7秒から14.9秒までは2~6フレームごとに1回」)、単なるカウントだけではありません。 - レビューアが確認した内容、別のレビューアか one context かの別。
- まだ人間が必要なもの:ミックスと音楽の選択の聴取、画面上のスペルと名前、リップシンク、実機電話での色、およびあなたが修正できなかったものすべて。誰も音を聴いていないという文を、平易な言葉で、ユーザーの言語でのみ記載してください。
最後のラウンドの before_after.png をユーザーに見せます。動画に「エラーがない」と書かないでください。代わりに何をチェックしたかを書いてください。
リファレンス
references/reading-the-checks.md:各測定値、そのしきい値、捕捉するものと見逃すもの、既知の動画での結果。所見が間違っているように見える場合、または--holdsを設定する前に読んでください。references/review-guide.md:レビューアへのブリーフ、兆候のリスト、問題のフォーマット、REVIEW.mdのテンプレート。ステップ3で読んでください。