批評ループ(コースステップ11)
Opusは画像を読み取れるため、自身がレンダリングしたものを確認できます。この習慣が、「まあまあ」で終わる作品と、実際に成功する作品を分けます。反復は失敗ではなく方法です:広く共有された45秒のショート作品は、約6.75時間に163回のモデル呼び出しを要しました。このスキルはhigh努力レベルで実行されます。なぜなら、フレームを正直に判断するには意図的な注意力が必要だからです。
critique.mjs 証拠 -> すべてのPNGを確認 -> 7軸でスコア付け -> P0/P1/P2をタイムスタンプ付きで -> ラウンドを
docs/review_log.mdに追記 -> 最悪の3つを修正 -> 影響を受ける秒数を再確認 -> 次のラウンド
まで:
>= 3ラウンド かつ 最終ラウンドの全軸 >= 8 (gate.naAllowedで指定されたものはnaのみ) かつ P0なし -> npm run gate -> npm run render:final
映像プロジェクトルート(studio.jsonがあるフォルダ)で作業します。引数(フォーマットと変更内容、両方ともオプション。フォーマットのデフォルトはstudio.jsonのprimaryFormat)は、一度だけ表示されます:
このスキルのファイルは${CLAUDE_SKILL_DIR}にあります。以下の相対リンクはそこを指しています。
レビューのみ、再レンダリングなし:ユーザーが既存の証拠(コンタクトシート、静止画、動画)を確認するよう要求し、コードに触れない場合、ステップ1、5、6をスキップします。既存のファイルを確認し、スコアリングし、ラウンドを追記します(ステップ4)。
0. ラウンド1の前に
docs/shotlist.mdが承認され、npm run lintがクリーンで、npm run previewで映像が再生されること。- サウンド軸を評価するにはオーディオが必要です:最初に
npm run score(または提供されたトラックの場合はnpm run beats -- <track>)とnpm run sfxを実行し、キュー、ビートグリッド、同期メトリックが存在するようにします。 - サウンド軸はミックスされたレンダリングからスコアリングされ、批評家はレンダリングやミックスができません。キュー、音楽、または映像タイミングが変更されたすべてのラウンド(常にラウンド1と最終ラウンド)の前に、それをビルドします:
node tools/render.mjs --format <fmt> --draft --sub 1 --scale 0.5、npm run sfx、node tools/mix.mjs --format <fmt>。次に、スコアリングまたは批評家への指示の前に、ステップ1の両方の証拠パスを生成します。
1. 証拠の生成
互いに上書きしない2つのパス。このクラスのPCで測定:ライブパスは12秒のデモで約115秒、20秒の映像で約145秒(3つの決定性パスと15〜25秒のブラウザ起動時間が支配的)、--videoパスは20秒の映像で約85秒、1回のmotion-critic実行で5〜12分。各パスはバックグラウンドで開始し、そのログをポーリングします。フォアグラウンドで約2分以上待機しないでください:
node tools/critique.mjs --format 9x16 # ライブ映像 -> out/review/9x16/
node tools/critique.mjs --format 9x16 --video out/9x16/final.mp4 # ミックスレンダリング -> out/review/9x16/video/
ライブパスは、決定性、正確なピクセル、loop.png、キュー同期を保持します。そのオーディオ行はn/aと表示されます。ビデオパスは、ラウドネス、トゥルーピーク、オーディオ長、エンコードに実際に含まれるものを保持します。決定性パスをスキップし、loop.pngを書き込みません。サウンドはビデオパスから、その他は両方からスコアリングします。ミックスがない場合、サウンドには証拠がありません:欠落した証拠を示すP1(そのようなラウンドは最終ラウンドにはなれません)で4以下のスコアを付けます。
out/review/<fmt>/内のファイル(video/内も同名) | 内容 | 確認ポイント |
|---|---|---|
metrics.md / metrics.json | 決定性の不一致、描画テキストのグリフカバレッジ(フォント、ライブパス)、デッドスパン、ポップ、フレーム0、ループシーム、コーナー、ボーダー、キュー同期、オーディオおよび無音スパン(--videoパス)、すべてのシートの全ページリスト | 最初に読む。すべてのフラグは問題か文書化された却下のいずれかになる |
contact.png | ビートごとに1つの静止画、time · beat · shotとラベル付け。すべてのシート(contact、shots、phone、strip。npm run stillsとcritique.mjsの両方)は、ページ全体の行に分割されます:ページの高さは--page-height(デフォルト1800px)以下、幅は1990px以下。ページ1はcontact.png、次にcontact-2.png、contact-3.png...。metrics.mdはすべてのページをリストするので、すべてを開いてください。--from S --to Sで1チャプターをレビュー | デッドビート、ショットの繰り返し、状態変更時のオーバーラップ |
phone.png | 1秒あたり1つの静止画、幅360px | スマートフォンでの可読性 |
shots.png | ショットの中間点ごとに1つの静止画 | 構図、禁止ルック、階層 |
strip.png | 最も速いアクションの周囲の12連続フレーム(--strip-at Sで選択) | スライド、ポップ、再起動、テキストオーバーラップ |
loop.png | ループ映像のみ(studio.json loop: true、キャンバスフィルム、ライブモード):ペインは以下で説明 | シームジャンプ、閉じないループ |
node tools/critique.mjsのすべてのフラグ(--helpで同じリストを表示):
| フラグ | 効果 |
|---|---|
-f, --format <fmt> | レビューするフォーマット。デフォルトはprimaryFormat。ファイルはout/review/<fmt>/に保存される |
--video [path] | ライブ映像の代わりにレンダリングされたmp4をレビュー。--videoのみの場合はout/<fmt>/final.mp4、それ以外はsilent.mp4。統合LUFS、トゥルーピーク、オーディオ長を追加。決定性パスをスキップ。loop.pngを書き込まない(連続性メトリックのみ)。すべてはout/review/<fmt>/video/に保存されるため、ライブ証拠はそのまま残る。レポートは両方のフォルダを名前で示す |
--from <sec>, --to <sec> | 長い映像の1チャプターをレビュー:静止画、すべてのシートとすべてのメトリック(デッドスパン、ポップ、決定性サンプル、グリフカバレッジ、無音スパン、キュー)はその範囲のみをカバーし、metrics.jsonはrangeに記録する。フレーム0とループシームは映像全体に対してのみチェックされる(スキップされたと報告)、ラウドネスは常にファイル全体、自動ストリップは範囲内に留まる。不正な範囲(--fromが終了を超える、--toが--from以上でない、3フレーム未満)は使用エラーで終了コード2 |
--page-height <px> | 1枚のシート画像の最大高さ(デフォルト1800px。画像ビューアは約2000pxを超えるものを縮小する)。より高いシートは、タイル行全体のページに分割される(contact.png、contact-2.png...。0 = 1枚の高いシート)。ページ幅も1990pxを超えることはない(--colsが収まるように下げられる) |
--strip-at <sec> | 12フレームのストリップをある瞬間(例えば問題のある時間)に中央揃えする(デフォルト:最も動きのある瞬間) |
--no-determinism | このラウンドで決定性パスが合格し、画像のみが変更された場合、3つのハッシュパスをスキップする |
--skip-determinism-repeat | 映像ハッシュ、assets/(画像、フォント、オーディオ、キューデータ:名前、サイズ、コンテンツ)配下のすべてのファイル、フォーマット、--from/--to、およびパスのコードが変更されていない場合、前回のライブランの合格した決定性結果(フォルダ内のdeterminism-cache.json)を再利用する。film/**、lib/**、studio.json、assets/の編集はキーを変更するため、パスは再度実行される。不合格の結果は決して再利用されない。メトリック行はn/a ... reused from the run of <time>と読み取られる。Chromeのアップグレードはキーの一部ではない:アップグレード後は、フラグなしで1回実行する |
--check-hash | ブラウザを起動しない:ライブ映像(sha256 of film/** + lib/** + studio.json)とout/review/<fmt>/内の証拠を比較する(video/の場合は--videoを追加)。終了コード0 = 同じ映像、1 = 変更またはハッシュなしで、変更されたファイルをリストする |
--json | レポートの代わりに1行のJSON結果(パス、すべてのシートのpages、range、サマリー、findings、nextRound、ゲートステータス)を出力する |
-h, --help | 使用法 |
--jsonなしの場合、レポートが出力される:証拠リスト、メトリックテーブル、機械発見の候補問題、ルーブリック、次のラウンド番号が入った記入準備済みのレビューログブロック(metrics.mdとしても保存される)。ツールは決してスコアリングしない。--jsonの場合、行はdir(この実行が書き込んだ場所)とother(他方のモードのフォルダ、モード、時刻、またはnull)を運ぶ。
loop.pngペイン、左から右へ(すべて同じ方法でダウンスケール):
| ペイン | 表示内容 | 読み方 |
|---|---|---|
| 最終フレーム | フレームN-1 | シーム直前の状態 |
t=dur アンラップ | t = durationでの生の終了状態 | ランタイムがhash(t, { wrap: false })を尊重する場合のみ存在し、ツールが最初にテストする |
seek(0) | フレーム0 | シーム後の状態 |
|last - first| x4 | 最終フレームとフレーム0の差、4倍増幅 | 2つの連続フレーム間の通常の1ステップのように見えるべき |
|end - first| x4 | アンラップされた終了状態とフレーム0の差、4倍増幅 | 黒であるべき:t = durationはフレーム0。アンラップペインがある場合のみ存在 |
metrics.jsonのループ判定loop = { enabled, unwrapped, invariant, hashEqual, endDiff, seamDiff, prevDiff, ratio, continuity, closes, pass }。continuity = 最後から最初へのステップが、最後の2フレーム間のステップの最大1.5倍(またはcritique.staticEps未満)。closes = hash(0)がhash(duration, { wrap: false })と等しいか、それらの平均差が0.1未満。失敗は映像の終わりのP0。アンラップペインがない場合(古いランタイム、DOMフィルム)、連続性のみが測定され、レポートはそのように述べる。
すべての証拠フォルダはまた、film-hash.json(証拠が示すフィルムバージョン。filmHashはmetrics.jsonで繰り返される)とbaseline.json(最後の実行のポップ、ジャンプ、デッドスパン候補時間)を保持する。レビューに関する2つの結果:
- フィルムバージョン:ライブフィルムからズーム静止画をレンダリングする前に、
node tools/critique.mjs --check-hash --format <fmt>を実行する。不一致は、静止画がコンタクトシートよりも新しいフィルムを示すことを意味する:停止し、不一致を報告し(コマンドは変更されたファイルを名付ける)、新しい証拠を要求する。批評家がレビューしている間はフィルムを編集しない。 - デルタ:フォルダ内の2回目の実行から、
metrics.mdはsame as previous run: N of M candidatesを出力し、新しいものを最初にリストする(機械発見リストは各重大度内で新しい発見を最初に配置し、他のものに[same as the previous run]とマークする)。新しいものを完全にレビューし、フィルムがその時間近くで変更された場合にのみ古いものを再検証する。
ステップ(ピクセルアート、「オンツー」)フィルムは意図的にハードステップを作る。studio.jsonで設定:critique.stepped: trueはすべてのjumpをP2の発見の代わりに情報としてリストする(metrics.jsonのpops.info、metrics.mdの「Suppressed by studio.json」セクション)。1フレームのflickerはP1のまま。critique.popIgnore: [[t0, t1], ...](秒、0 <= t0 < t1)は、意図されたスパン内の両方の種類を黙らせる(pops.ignoredはそれらをスパンとともにリストする)。metrics.mdは、各設定がいくつの候補を保留したか、その理由を述べる。これはフィルムの文法であり、閾値調整ではない:本当のグリッチは、ステップスパン外のフリッカーまたはジャンプとして依然として表示される。
メトリックセマンティクス。フラグが正しくトリアージされるためのもの:
| メトリック | 失敗条件 | 発見 |
|---|---|---|
| 決定性 | サンプリングされた任意の時間のハッシュが、順序通り、シャッフル、または新しいページで異なる(サンプルはすべてのショット境界とキューにまたがる) | P0 |
| フォント(ライブパス) | フィルムが描画する文字に、そのフォントにグリフがない、またはファミリーが登録されていない、またはジェネリック(sans-serif)の場合:マシンはシステムフォント(コンピュータごとに異なる)またはトーフボックスを描画する。ページはwindow.__TEXT_TRACK__ = trueで開かれるため、text()、kinetic()、textWidth()は描画するものを記録し、__studio.coverage()がそれを判定する。フォント行ごとに1つの発見が、ファミリーとウェイト、最大40の欠落文字、合計数、修正を名付ける。textUse()のないページはpreflight: unavailableという注意を与え、発見にはならない。パスが描画しなかったフレーム上のテキストは見られない | P0 font-fallback |
| デッドスパン | critique.deadSpanSec(2秒)以上の間、平均フレーム差がcritique.staticEps(0.35)未満 | P1 |
ポップ、flicker | 1フレームが両方の隣接フレームと、それらが互いに異なる量のcritique.popRatio(3)倍以上異なる | P1(キューの隣の意図されたフラッシュは文書で却下される) |
ポップ、jump | 差のスパイクが、4つの隣接する差の平均のpopRatio倍以上:何かがテレポートした、ポップインした、または反転した | ツールからのP2。ショットを損なう場合はP1に引き上げる。critique.stepped: trueの場合は情報のみ。critique.popIgnoreスパン内のものはなし |
| フレーム0 | ほぼ空:ピクセルの0.5%未満がスムーズな背景(プレーンフィル、グラデーション、ビネットはすべて背景としてカウント)と異なる | P0 |
| コーナー、ボーダー | サンプリングされたフレームの30%以上で、コーナーボックス内に小さなコンテンツ(critique.cornerPct、8%)。3辺以上に突然の内部ステップを持つ細く均一なエッジラインが25%以上(ビネット、グラデーション、または色付き背景上のカードはボーダーではない) | ツールからP1、目視で確認された場合はP0(禁止ルック) |
| 同期 | ヒットしたキューの80%未満(4つ以上のキュー)がビートの25ミリ秒以内にある、またはショットチェンジがダウンビートから外れている。ライザー、ウーッシュ、スウーシュは意図的にビートをリードしカウントされない | P2 |
オーディオ(--video) | オーディオストリームなし、ラウドネスがターゲット外、トゥルーピークがターゲット超過、オーディオ長がビデオから1フレーム以上ずれている | オーディオストリームなしまたはトゥルーピークが0 dBTPを超える場合はP0、それ以外はP1 |
無音(--video) | -50 dB未満の1秒以上の無音スパン(ギャップごとに1つの発見、silence 3.2 s at 00:08.1)。最初の0.3秒以内に始まるもの、最後の1.0秒以内に始まるもの、またはcritique.allowSilence間隔内にあるものは除く。早期に終了するステムはミックス後も-14 LUFSを測定するため、ラウドネスはそれを検出できない | P1 audio-gap(オーディオ行はWARNと読み取られる) |
両方のポップ種類はまた、0〜255スケールで平均ステップが1.0を超える必要があるため、ほぼ静的シーンではトリップしない。ショット境界でのハードカットはポップとしてではなくカットとしてリストされる。キャンバスフィルムは半分以上のサイズ(pixelScale)でスキャンされる。なぜならChromeのCPUキャンバスは小さなサイズでグリフをピクセル全体にスナップし、偽のジャンプを引き起こすから。DOMフィルムはスクリーンショットから10 fpsでサンプリングされる。フラグを消すためにcritiqueの閾値を決して変更しない。
2. 適切に確認する
Readツールで全ての画像を開く。metrics.mdだけでスコアリングせず、コードの記憶からもスコアリングしない。順序:metrics.md、contact.png、phone.png、shots.png、strip.png、loop.png(それぞれが持つ全てのページ:contact-2.png、contact-3.png...。metrics.mdの証拠リストがそれらを名付けるか、フォルダをリストする)、次にvideo/metrics.mdのオーディオ行。docs/shotlist.md(承認されたもの)と比較する。