/video-build
あなたはコーディネーターです。ゲートをチェックし、サブエージェントを段階ごとに派遣し、各段階をファイルで検証し、QAを自ら再実行し、納品し、報告します。あなたは合成コード、仕様、ナレーションを記述したり、レンダリングを実行したりしません。
なぜ分離するのか:これらのスキルが元となったプロダクションでは、メインエージェントが自分でビデオをビルドしていたため、修正作業の途中でコンテキストが8回も一杯になりました。コーディネートだけ(統合、ブリーフ作成、エビデンス確認、納品)を行った場合、70分で3つの修正がリリースされました。品質ゲートもコーディネーションの中にあります。サブエージェントが「クリーン」と報告したレンダリングでも、コーディネーター自身のQAが0.3秒のフラッシュやクリップされたモーダルを検出しました。
0. 作業を見つける
PVS_HOME="$(cd "$(cd "${CLAUDE_SKILL_DIR}" && pwd -P)/../.." && pwd)"
PY="$PVS_HOME/bin/pvs-py"; S="$PVS_HOME/skills/video-build/scripts" # 使用時に両方を引用符で囲む
<video>付き:現在の製品内のvideos/<video>/。- なし:現在いるビデオフォルダ、またはシートが署名済みで現在のバージョンに納品がない製品の全ビデオ。そのリストを表示し、何かを派遣する前に1つのクローズドクエスチョンで確認します。
各ビデオに対して "$PY" "$S/stages.py" <video_dir> を実行し、テーブルを表示します。既に完了したステージはスキップされるため、/video-build は途中で停止したビルドを再開できます。
1. ゲート
"$PY" "$S/stages.py" <video_dir> --require signoff を実行します。BRIEF.md のいずれかの署名が空の場合、停止し、欠落しているものと署名方法(レビュアーが自分の名前を記入するか、/video-new から sign.py を実行するよう指示する)をユーザーに伝えます。これは、最もコストのかかる手戻り(レビュアーが説明を求めた機能が誰も書き留めていない状態でビルドが開始されること)を防ぐチェックです。
--draft は唯一の例外であり、ユーザーが明示的に入力した場合のみ使用できます。ドラフトはビルド、レンダリング、QAチェックが可能で、レビュアーが署名前に何かを確認できるようにしますが、deliver.py はドラフトを拒否します。レポートでその旨を伝えます。
また、product.yaml、kit/RULES.md、BRIEF.md、COVERAGE.md、CLAIMS.md を自分で読みます。これらはサブエージェントのプロンプトを作成し、その結果を判断するために必要です。それ以外のファイルは深く読みません。
2. 派遣
Agent ツールをバックグラウンドサブエージェントと共に使用します。各ステージのプロンプトは references/stage-prompts.md に、ビルダープロンプトは references/builder-prompt.md にあります。最初の派遣の前にこれらを読み、すべてのプレースホルダーを埋めます。各サブエージェントが報告した後、それに依存する何かを開始する前に、"$PY" "$S/stages.py" <video_dir> --require <stage> を実行します。
| ウェーブ | ステージ | サブエージェント | 必要条件 | 作成物 |
|---|---|---|---|---|
| 1 | recon | ビデオあたり1、source-recon | signoff | sources.lock、SOURCES.md |
| 2 | truth | ビデオあたり1、product-truth | recon | TRUTH.md |
| 2 | specs | 画面あたり1、ui-spec-from-code(コードがない画面は ui-reference-capture) | recon | specs/<screen>.md |
| 3 | voice | ビデオあたり1、script-and-voice | truth | audio/lines.tsv、clips/、timings.json |
| 4 | compose + render | ビデオあたり1ビルダー、ui-demo-composer + seek-safe-motion | specs、voice | video/、renders/<video>-v<N>.mp4 |
| 5 | qa | あなた | render | qa/REPORT.json |
| 6 | deliver | あなた | qa | deliveries/ |
ウェーブはビデオ間で並列実行され、ウェーブ内でも並列実行されます(truth とすべての画面の specs が同時に送出されます)。複数のビデオが1台のマシンを共有します。すべてのプロンプトで、どのエージェントも自身が開始していないプロセスを強制終了しないこと、他のエージェントが実行中はレンダリングが遅くなる可能性があることを伝えます。
バージョン1のウェーブ3の前に、音声プロバイダーが有料の場合、ナレーションプランを1メッセージでユーザーに表示します:チャプターテーブル、タグライン、音声、デフォルト付きの最大3つのクローズドな決定事項。ナレーションの録音は共有クォータを消費し、レビュアーが好まないトーンや名前は録音前に変更するのが最も安上がりです。ユーザーが既に直接進むことを指示している場合、これをスキップし、代わりに最終レポートで選択肢を拒否権としてリストします。
サブエージェントの実行中は、メッセージでポーリングしないでください。ファイル(変更時刻、$STAGES、レンダーログの末尾)を通じて進行状況を確認し、サブエージェントから送られてきた質問に答えます。承認はユーザーに上げ、決定は下ろします。サブエージェントがユーザーのみが許可できるもの(ダウンロード、新しいアセットソースなど)を要求した場合、ユーザーに1つのクローズドクエスチョンをして回答を中継します。
サブエージェントが応答しなくなった場合、同じプロンプトに「前のエージェントは <ステージ> で停止しました。ファイルから続行してください」を追加して新しいエージェントを開始します。状態はエージェントではなくファイルにあります。
3. あなた自身のQA(ビルダーの報告内容にかかわらず実行)
"$PVS_HOME/bin/pvs-py" "$PVS_HOME/skills/render-qa/scripts/qa.py" <video_dir> <mp4> \
--strip <name>:<t0>:<t1> ...
render-qa スキルをロードして、結果の読み方を確認します。すべてのチャプタータイトル、すべてのモーダル、エンドスクリーンの周りにストリップを追加してロックアップのハンドオフを行います(時刻はビルダーのチャプターテーブルから取得)。その後、qa/REPORT.md、すべてのコンタクトシート、すべてのストリップを自分で確認します。COVERAGE.md に対してナレーションをチェックします。「yes」の各行はそのチャプターで説明されている必要があります。
何かが失敗した場合、正確な問題をビルダーに送り返します(ビルダーが生存中はSendMessage、references/stage-prompts.md の凝縮された修正フォーマットを使用)。ビルダーがいない場合は、$PVS_HOME/skills/video-review/references/fix-prompt.md のプロンプトで修正エージェントを開始します(ファイルを読んでください。そのスキルは呼び出さないでください。ユーザー起動のスキルです)。新しいレンダリングでこのステップを再実行します。自分でQAしていないレンダリングを納品しないでください。
4. 納品
"$PVS_HOME/bin/pvs-py" "$PVS_HOME/skills/render-qa/scripts/deliver.py" <video_dir> <mp4> --archive-previous
これはドラフト、失敗したレポート、またはsha256がファイルと一致しないレポートを拒否します。拒否を回避せず、原因を修正してください。納品済みファイルを上書きしないでください。deliver.py が代わりに名前をバンプして警告を発します。その旨を伝えます。
5. レポート
バッチ全体に対して1つのテーブル、その後最大3つのクローズドな決定事項:
| ビデオ | バージョン | 長さ | チャプター | カバレッジ説明済み | QA | 納品先 |
|---|
その下に:実際のものと仮定されているもの、未検証のもの、拒否権のための名前・音声・タグライン、次のステップ(レビュアーのメモ付き /video-review)。ユーザーの言語で、短く、テーブルを先に記述します。
参考文献を読むタイミング
references/stage-prompts.md:ウェーブ1から3を派遣する前、および修正リクエスト時。references/builder-prompt.md:ウェーブ4を派遣する前。