多影片變體工作流程 (multi-video-variants) 是做什麼的?
將一個已核准的主影片轉換為 N 個輸出,同時保留每個檔案來源狀態的完整可追溯性。它負責管理變體矩陣、主影片凍結、重新佈局副本、共用混音、命名規則、一次只渲染一個任務的佇列、代理監督規則以及清單閘道。它不設計主影片(由「類型」技能負責),也不取代逐檔案品質檢查(render-qa-deliver)。
凌駕於本檔案其他規則之上的規則
- 先有主影片,然後凍結。 衍生版本僅能從已通過自身完整品質檢查並以
manifest_check.py freeze記錄的主影片中產生。後續需要修復時,必須在主影片中進行,使用change記錄,並將修補套用至同一輪次中的每個副本,然後所有衍生版本都必須重新渲染並重新記錄。嚴禁僅修復單一副本。 - 重新佈局,絕不裁切。 每個長寬比都是主影片來源的副本(
hf_9x16/、hf_1x1/...),擁有自己的畫布、安全區域、字型大小、字幕軌道、攝影機關鍵幀和臉部居中。對已渲染的主影片進行 FFmpeg 裁切或縮放不算是變體。 - 單一混音。 重新佈局和鉤子變體使用相同的
cues.js和相同的assets/mix.wav位元組,並從該單一檔案進行混合;音訊不會為每個變體重新建構。真正需要自己混音(無音樂、自有旁白、重新剪輯長度)的變體必須在清單中聲明其原因。 - 整台機器一次只處理一項繁重工作(渲染、
check、遮罩、ASR、Blender),並使用render_lock控制。平行工作僅限於非繁重任務(佈局、規格、審閱 QA)。最多 4 個代理同時執行,每個代理最多 2 個子代理。 - 「就緒」狀態是計算出來的,不是斷言的。 僅在
manifest_check.py check返回退出碼 0 時才允許使用這個詞。逾時、空資料夾、缺少雜湊值、qa: not_run或缺少證據都應標記為blocked/INSUFFICIENT_EVIDENCE,絕不能標記為pass。 - 未經
paid-generation-gate許可,不得進行付費操作;絕不向另一個 Claude 工作階段發送訊息;使用者和專案限制優先於此程序。安全區域、-14 LUFS 和畫布均依據內部預設 v1(決策預設 Q5),而非平台法規。
輸入 -> 輸出
輸入:已核准的主影片(hf/、PROMPT.md、DESIGN.md、cues.js、assets/mix.wav)以及來自接收階段的變體矩陣。輸出:final/<name>_<platform>_<hook>_<aspect>.mp4 共 N 個檔案、final/manifest.json(僅最終檔案和清單)、_work/qa/<aspect>/<round>/ 下的逐檔案 QA 報告、_work/agents/<agent>.progress.md、_work/STATE.md(佇列)。
命名規則:<name>_<platform>_<hook>_<aspect>.mp4,其中 <name> 為小寫 ASCII 字串(允許底線),<platform> = meta|tiktok|yt|ig|linkedin|x|all,<hook> = master | hookA | hookA-nomusic | hookA-nocaps,<aspect> = 9x16|4x5|1x1|16x9。也接受短格式 <name>_<aspect>.mp4(平台為 all,鉤子為 master,如交付手冊中所定義)。如果使用者在記錄中指定了名稱,則該名稱優先於慣例,並以其記錄 ID 記錄(record --name-ledger-id)。
程序
| # | 階段 | 執行 | 產出物 |
|---|---|---|---|
| 0 | 接收時建立矩陣 | 每個檔案一行記錄:長寬比、平台、路徑(有機/廣告/Spark)、鉤子、版本(完整、無音樂、無字幕、長度)、主影片長寬比。後期「可能」需要的長寬比:立即撰寫佈局註記,以便後續請求只需一個代理處理,而非整個重建(references/variant-matrix-and-layout.md) | PROMPT.md <inputs> 中的矩陣;清單中的 matrix 列表 |
| 1 | 主影片閘道 | 主影片已核准,render-qa-deliver 全幀 QA 通過,manifest_check.py freeze <project> --hf hf --matrix ... | 已凍結的 src_hash + mix_sha256 |
| 2 | 重新佈局副本 | 每個長寬比由一個代理在副本上執行;使用相同時間碼和混音;填寫佈局表格(每個元素變更的內容,references/variant-matrix-and-layout.md);預檢零錯誤;在鉤子、優惠、片尾卡處拍攝重疊快照(--describe false,每次呼叫最多 5 個時間戳) | hf_<aspect>/、_work/qa/<aspect>/layout.md |
| 3 | 鉤子/版本變體 | 鉤子 = 綁定到長寬比副本中變數的子合成,每個變體一行;先測試一個變異(批次變數在專案中未經測試);混入共用混音;無音樂/無字幕 = 聲明的混音或圖層變體 | rows.json、變體檔案 |
| 4 | 佇列 | 在 _work/STATE.md 中寫入渲染順序(主影片,然後每個長寬比,然後變體);每次渲染前執行 manifest_check.py stamp;透過 hf_deliver / render_lock run 一次一個地進行渲染;渲染擁有者絕不啟動第二個繁重工作 | 鎖定日誌、戳記 |
| 5 | 記錄 | 每次渲染後:record(雜湊值、套用的主影片修補、混音變體、QA 狀態、在最終檔案上測量的響度) | manifest.json |
| 6 | 逐輸出 QA | frame_qa、caption_qa --band <top>:1450(9:16)、motion_qa(如果佈局改變了動畫)、face_center audit(針對講話者畫面)、qa delivery;視覺審閱僅軸 1(構圖/裁切)和軸 4(可讀性);除非動畫改變,否則軸 2-3 繼承自上游 | 報告 + 證據路徑 |
| 7 | 就緒閘道 | manifest_check.py check <project> --json 返回退出碼 0;向使用者顯示檔案列表,包含來源雜湊、QA 狀態、LUFS/TP;誠實列出缺口 | READY 報告 |
| 8 | 學習 | 每個檔案的計時記錄行、發送到收件匣的經驗教訓 | _work/timing_ledger.jsonl |
閘道
狀態為 pass | fail | blocked | n/a,並附有原因。逾時、空白取樣或缺少輸入為 blocked,絕非 pass。成功的工具呼叫是執行證據;已檢視的渲染是外觀證據。
| 閘道 | 條件 | 證據 | 若為假 | 負責方 | 何時重新檢查 |
|---|---|---|---|---|---|
| G1 矩陣 | 在開始任何建置前,每個輸出都有一行記錄(長寬比、平台、路徑、鉤子、版本) | PROMPT.md 和清單中的 matrix | 立即詢問缺失的軸;不要建置 | 本技能 + video-intake | 任何新的長寬比/變體請求時 |
| G2 主影片已凍結 | 主影片已通過完整 QA;已記錄 freeze;尚未開始製作衍生版本 | 清單中的 master.src_hash、frozen_utc 早於所有戳記 | 停止衍生版本;凍結主影片 | 本技能 | 任何主影片來源變更時 |
| G3 重新佈局 | 每個衍生版本都有自己的根畫布、每個元素的佈局行、其長寬比的安全區域;無裁切的主影片渲染 | layout.md 行 + 重疊快照 + 預檢 0 錯誤 | 重新佈局失敗的元素;不要縮放整個幀 | 該長寬比的代理 | 主影片佈局變更、新副本時 |
| G4 共用資產 | 每個重新佈局/鉤子副本中的 cues.* 和 assets/mix.wav 與主影片相同;鉤子變體是混入,而非重新混音 | manifest_check.py check:無 M035/M041 | 將主影片的 cues/mix 複製回來;重新渲染 | 本技能 | 主影片 cues 或 mix 變更時 |
| G5 逐輸出 QA | 每個檔案 qa: pass,附有證據檔案,最終檔案的 LUFS 為 -14 +/- 0.5,TP <= -1(內部閘道) | qa_evidence 路徑、lufs、tp 數字於清單中 | 僅修復並重新渲染該檔案 | render-qa-deliver | 任何重新渲染時 |
| G6 繁重任務紀律 | 一次僅一個繁重任務;<= 4 個代理,每個 <= 2 個子代理,每個子代理有檔案列表、輸出檔案、截止時間、進度檔案 | render_lock 日誌;_work/agents/*.progress.md 的修改時間 | 排隊,停止額外的工作(僅限自己的行程樹) | 本技能 | 每個代理啟動時 |
| G7 清單就緒 | 缺少、孤立、變更後渲染、全部不存在 | manifest_check.py check 退出碼 0 | 向使用者列出失敗的檔案;重新渲染過時的檔案 | manifest_check.py | 在說「就緒」之前、任何變更之後 |
數值(內部預設 v1,日期 2026-10-02,詳情見 references/house-presets.md)
- 畫布:9:16 1080x1920、4:5 1080x1350、1:1 1080x1080、16:9 1920x1080;H.264 SDR yuv420p、AAC 48 kHz、30 fps 預設。
- 安全區域、關鍵文字/CTA/標誌/價格:9:16 頂部 300 / 底部 672(y <= 1248)/ 左 140 / 右 192,字幕軌道底部 <= y 1450;16:9 x <= 1824、頂部 54、底部 162;4:5 和 1:1 每邊 54 px。未在裝置上驗證:執行重疊練習。
- 響度:-14 LUFS 整合 +/- 0.5,真實峰值 <= -1 dBTP,在最終檔案上測量;混音中間 TP <= -1.5。
- 監督:大約每 15 分鐘一次心跳檢查;靜默或超過截止時間達 20 分鐘 = 檢查、更換或停止;大約每 10 分鐘靜默向使用者發送狀態行;渲染逾時 = 3 倍預估時間。(來源:精煉 02 工作流程 §13.6,2026-10-01)
決策規則
| 如果 | 則 |
|---|---|
| 衍生版本存在後需要修復主影片 | 修復主影片,change,將修補套用至每個副本,重新渲染並重新記錄所有副本 |
| 某個副本需要不同的時間碼或 cues | 這是主影片的變更;或者是一個新的剪輯(recut)並有它自己的記錄行,絕不能是靜默分支 |
| 某個鉤子需要不同的台詞 | 聲明 own-vo 並附上原因;其他所有變體維持共用混音 |
| 後期請求一個長寬比 | 撰寫佈局表格,在凍結主影片的副本上啟動一個代理;不要觸碰主影片 |
| 同時請求兩個渲染 | 將它們排入佇列;由鎖定決定;在 STATE.md 中寫入順序 |
| 某個代理超過截止時間仍靜默 | 檢查其進度檔案,然後更換或停止它(僅限自己的行程樹),然後執行 render_lock status |
| finals 資料夾包含舊渲染 | 將其移動到 _work/delivered/v<N>/;「就緒」狀態會被阻擋,直到資料夾與清單相符 |
| 使用者為檔案命名 | 他們的名稱優先;使用 --name-ledger-id 記錄,並保持平台/鉤子/長寬比欄位明確 |
阻塞狀態(回報它們,不要繞過)
manifest_check.py 回傳 BLOCKED 或 INSUFFICIENT_EVIDENCE;衍生版本的 from_master 過時或缺少主影片修補;來源在渲染後變更;共用 cues 或 mix 偏移;qa 不是 pass;承諾的變體缺失;存在未規劃的檔案。請說明是哪個檔案、哪個代碼以及修復方式。
每個都會浪費實際時間的陷阱
在交付時才提出 16:9 請求(需要完整重新佈局,丟棄);一個 3.7 秒的主影片修補未套用至 1:1 副本;舊渲染與新渲染混在一起且無人標記;某個衍生版本代理發現主影片錯誤但只修復了其副本;三個代理同時渲染(平行 Blender 工作使渲染時間從 11.5 分鐘加倍至 21.5 分鐘,影響擁有者的筆記型電腦);Meta 和 TikTok 剪輯之間的命名衝突;某個鉤子變體靜默地使用了不同的混音。仍然需要檢視每個長寬比的聯絡表:雜湊無法看出字幕是否蓋到人臉。
參考資料(載入時機)
references/variant-matrix-and-layout.md- 撰寫矩陣、重新佈局長寬比、鉤子/無音樂/無字幕/長度變體。references/manifest-schema.md- 記錄檔案、讀取manifest_check.py的發現結果、過時衍生版本的生命週期。references/parallel-and-agents.md- 啟動代理、佇列、鎖定、心跳、停止、權杖預算。references/house-presets.md- 在引用任何畫布、安全區域、響度或平台數字之前(已註明日期的模組)。agent-content/references/platform-specs.md(規範平台事實,由其他團隊管理)和agent-content/playbooks/wf-08-deliver.md(交付手冊:命名、清單規則) - 匯出預設和手冊;如果數字不一致,規範檔案為準,並更新references/house-presets.md。- 其他技能:
render-qa-deliver(逐檔案 QA)、hebrew-captions-asr(字幕軌道)、edit-ad-promo(鉤子排名)、revision-round(跨長寬比的註記)、paid-generation-gate。 - 腳本:
scripts/manifest_check.py(--self-check29 個案例,退出碼 0 READY / 1 BLOCKED / 2 INSUFFICIENT_EVIDENCE)和scripts/test_manifest_check.py(單元測試)。