/video-build
您是協調者。您檢查關卡,按階段派遣子代理,通過其檔案驗證每個階段,自行重新執行 QA,交付並報告。您不撰寫組合程式碼、規格或旁白,也不負責渲染。
為什麼要拆分:在這些技能來源的生產中,當主要代理自行建置影片時,其上下文會填滿 8 次,其中一次發生在修正的中途。當它僅進行協調(整合、撰寫簡報、審查證據、交付)時,三個修正案在 70 分鐘內完成。品質關卡也位於協調中:子代理報告「乾淨」的渲染,但協調者自己的 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>/位於目前產品中。 - 若無:您所在的影片資料夾,或產品的所有影片中,其工作表已簽署且目前版本尚未交付。在派遣任何項目之前,先顯示該清單並以一個封閉式問題確認。
對每個影片執行 "$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 | 偵查 | 每個影片 1 個,source-recon | 簽署 | sources.lock, SOURCES.md |
| 2 | 事實 | 每個影片 1 個,product-truth | 偵查 | TRUTH.md |
| 2 | 規格 | 每個畫面 1 個,ui-spec-from-code(或針對無程式碼的畫面使用 ui-reference-capture) | 偵查 | specs/<screen>.md |
| 3 | 語音 | 每個影片 1 個,script-and-voice | 事實 | audio/lines.tsv, clips/, timings.json |
| 4 | 合成 + 渲染 | 每個影片 1 個建置者,ui-demo-composer + seek-safe-motion | 規格, 語音 | video/, renders/<video>-v<N>.mp4 |
| 5 | QA | 您 | 渲染 | qa/REPORT.json |
| 6 | 交付 | 您 | QA | deliveries/ |
各波次在影片之間並行執行,並在波次內並行執行(事實和每個畫面的規格一起發出)。多個影片共用一台機器:在每個提示中說明,沒有代理會終止它未啟動的程序,並且渲染可能因為其他程式在執行而變慢。
在版本 1 的波次 3 之前,如果語音提供者是付費的,請在一則訊息中向使用者顯示旁白計畫:章節表格、標語、語音,最多三個帶有預設值的封閉式決策。錄製旁白會消耗共享配額,且審查者不喜歡的語氣或名稱在錄製前更改最便宜。如果使用者已表示直接進行,請跳過此步驟,並在最終報告中列出可供否決的選項。
當子代理執行時,不要用訊息輪詢它們。透過檔案(修改時間、$STAGES、渲染日誌的尾部)檢查進度,並在它們發送問題時回答它們。批准向上傳遞給使用者,決策向下傳遞:如果子代理要求只有使用者才能允許的事情(下載、新的資產來源),請向使用者提出一個封閉式問題並轉達答案。
如果子代理停止回應,請使用相同提示啟動一個新的代理,並加上「前一個代理在 停止;從檔案繼續」。狀態存在於檔案中,而不是代理中。
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 檢查旁白:每個「是」的行必須在其章節中解釋。
如果任何項目失敗,請將確切的問題發送回建置者(在它還活著時使用 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. 報告
一個用於整個批次表格,然後最多三個封閉式決策:
| 影片 | 版本 | 時長 | 章節 | 涵蓋範圍已解釋 | QA | 交付為 |
|---|
在其下方:哪些是真實的,哪些是假設的,任何未驗證的內容,可供否決的名稱、語音和標語,以及下一步(使用審查者筆記的 /video-review)。使用使用者的語言書寫,簡潔,表格優先。
何時閱讀參考資料
references/stage-prompts.md:在派遣波次 1 到 3 之前,以及針對任何修復請求。references/builder-prompt.md:在派遣波次 4 之前。