/video-review
1ラウンドのレビュー:全バッチを収集し、動画ごとに統合し、ノートのあったすべての動画を同時に修正し、各結果を自分で確認し、次のバージョンを納品し、報告します。
バッチ&並列の理由:これらのスキルの元になった制作現場では、3件のノートが5分間隔で届き、エージェントが最初の1件を自身のコンテキスト内で修正し始めました。コンテキストがいっぱいになり、レビュアーはそれを止めざるを得ず、1件ずつ処理するフィードバックは非効率だと言われました。1つのテーブルに統合し、3つの並列サブエージェントに渡したところ、同じ3件の修正がレビュー・納品までに70分で完了しました。修正は単なるレンダリングではありません。編集、ナレーション、レンダリング、QA、報告には動画1本あたり50〜90分かかるため、直列実行は倍々になります。
0. セットアップ
PVS_HOME="$(cd "$(cd "${CLAUDE_SKILL_DIR}" && pwd -P)/../.." && pwd)"
PY="$PVS_HOME/bin/pvs-py"
プロダクト(カレントディレクトリの上位で最も近い product.yaml)を見つけ、その動画一覧を現在のバージョンと納品状況とともにリストアップします(各動画で skills/video-build/scripts/stages.py を実行)。
1. 全バッチを取得する
引数がファイルの場合はそれを読み込み、テキストの場合はそのまま使用します。その後、1回だけ確認します:「これが今回のラウンドの全フィードバックで、すべての動画分ですか? ノートのない動画はそのまま維持されます。」修正を始める前に回答を待ちます。統合中にノートが届き続ける場合は、同じラウンドに追加します。メッセージごとに修正を開始しないでください。
2. 動画ごとに1つのテーブルに統合する
"$PY" "$PVS_HOME/skills/video-review/scripts/feedback_table.py" <product_dir> <notes file or -> \
--out <product_dir>/reviews/round-<date>.md
各ノートを、そのノートが示す動画(ID、タイトル、または見出しで識別)の下に、原文のまま並べ替えます。「全動画」に関するノートは共通セクションに配置し、配置できないノートはリストアップします。その後、各行に以下の項目を記入します:意味(あなたの解釈。変更してはいけないものを含む)、承認条件(どのように確認するか:時間範囲、ストリップ、フレーム)、全動画に適用するルール?
記入する前に references/review-protocol.md を読んでください。そこでは、ディクテーションエラー、実際はルールであるノート、プロダクトと矛盾するノートについて説明しています。
すべてのノートに対して問うべき3つの質問:
- これは本当にルールか? そうであれば、レビュアーが指摘した動画だけでなく、このラウンドのすべての動画に適用されます。かつてレビュアーが1つの動画に対してカバレッジルールを与え、数時間後にそれをすべての動画に適用するよう再度依頼したことがあります。
- プロダクトは実際にそれを行っているか? 修正を約束する前にコードを確認してください。もしそうでなければ、推奨オプション付きのクローズドクエスチョン(「存在するものだけを表示する」)を提示します。
- COVERAGE.md に欠けていた機能か? その場合、修正は行を追加します。
統合されたテーブルをユーザーに表示し、最大3つのクローズドな決定事項(デフォルトを明示)を提示します。沈黙はデフォルトを受け入れたものとみなします。ノートのない動画は未修正としてリストアップされます。
3. ノートのある各動画の次のバージョンを開く
"$PY" "$PVS_HOME/skills/video-review/scripts/bump_version.py" <video_dir> --note "<quote>" ...
lines.tsv、timings.json、video/src を v としてバックアップし、BRIEFのバージョンを N+1 に上げ、引用符付きの変更ログセクションを開きます。v が一度もレンダリングされていない場合は拒否します(バージョンをスキップすることになります)。v のレンダリングはそのまま維持されます。これはパリティの基準であり、レビュアーが共有した可能性のあるファイルが上書きされることはありません。
4. 動画ごとに1つの修正サブエージェント、すべて同時に
各動画に対して references/fix-prompt.md を記入し(レビュアーの言葉をそのまま、あなたの意味と承認条件、コード内で file:line ですでに見つけたもの、共有ルール)、すべての修正エージェントを同じターンで Agent ツールを使ってバックグラウンドで起動します。起動前に、自分で「すでに見つけたもの」のコード検索を簡潔に行ってください。これにより、各修正エージェントは同じ検索を省略でき、プロダクトが満たせないノートを捕捉できます。
サブエージェントが実行中は、自分で修正を行わず、メッセージでポーリングもしないでください。ファイル(stages.py、更新日時、レンダリングログ)を監視します。修正エージェントが承認を必要とする場合は、ユーザーに1つのクローズドクエスチョンをして回答を中継します。修正エージェントが停止した場合は、同じプロンプトと停止した場所を追加して新しいエージェントを起動します。状態はファイル内にあります。
5. すべての結果を自分で確認する
修正エージェントが報告した内容に関わらず、各動画について:
- 意図的に変更された範囲以外で、以前のバージョンとのパリティ:
"$PY" "$PVS_HOME/skills/render-qa/scripts/parity.py" <old mp4> <new mp4> --skip a:b ...。 承認された範囲で変更があった場合はリグレッションです。差し戻します。 - QA:
"$PY" "$PVS_HOME/skills/render-qa/scripts/qa.py" <video_dir> <new mp4> --strip ...変更されたビートごとにストリップを指定します。render-qaを読み込んで読み方を理解し、シートとストリップを自分で確認します。 - テーブルからの各ノートの承認条件チェック。レンダリングがノートを満たしていない場合は、同じ修正エージェントに差し戻します(SendMessage:問題、時間範囲、「それ以外は変更しない」)。
- BRIEF.md の変更ログセクションを記入します。
6. 納品してラウンドを終了する
"$PY" "$PVS_HOME/skills/render-qa/scripts/deliver.py" <video_dir> <new mp4> --archive-previous
その後、ラウンドをまとめて終了します。ルールとなったノートは kit/RULES.md に追加します(日付とレビュアーの言葉付き)。これにより、次のビルドがそれらを継承します。更新が停止したルールファイルは誤ったものになり、ルールは毎回プロンプトで手動で繰り返されることになります。レビュアーがすでに以前のバージョンをどこかにアップロードしている場合は、どのファイルを再度アップロードする必要があるかを伝えます。
7. 報告
| 動画 | 変更前 | 変更後 | 適用されたノート | 確認場所 | パリティ | QA | 納品バージョン |
|---|
次に、未修正の動画、kit/RULES.md に追加されたルール、未検証の項目、最大3つのクローズドな決定事項。ユーザーの言語で、簡潔に、表を先に。
参考資料
references/review-protocol.md:統合テーブルを記入する前に読むこと。references/fix-prompt.md:修正エージェントを起動する前に読むこと。