Communitygithub.com

多影片變體工作流程 (multi-video-variants)

將一個已核准的主影片,轉換為多種輸出格式(不同長寬比、鉤子變體、平台版本、無音樂/無字幕版本),或平行處理多個影片,共用同一混音、遵循嚴格的命名規則,並透過清單防止使用過時的衍生版本。

多影片變體工作流程 (multi-video-variants) 是什麼?

這個AI代理技能「多影片變體工作流程」是專為需要從單一已核准的主影片產生多種輸出的影片後製團隊所設計,以確保版本控管與流程一致性。它會建立一個變體矩陣,凍結主影片狀態,並重新佈局每個長寬比的副本(而非裁切),同時共用相同的時間碼與混音檔案。此技能支援的平台包括 Claude Code、Codex、Cursor 以及類似的代理架構,並強制執行嚴格的規則:所有衍生版本必須從已通過完整品質檢查並記錄於 `manifest_check.py freeze` 的主影片中產生;後續的修復必須在主影片中進行,並套用至所有副本。它會管理一個一次只允許一項繁重工作(如渲染、合成)的佇列,使用 `manifest_check.py` 驗證清單,並在滿足所有閘道條件前,禁止將任何輸出標記為「就緒」。此技能明確不負責設計主影片(由其他「類型」技能負責)或執行單一可交付項目的逐檔案品質檢查(由 `render-qa-deliver` 負責)。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Malik-rgb43/editing-workflow/tree/HEAD/.agents/skills/multi-video-variants

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

多影片變體工作流程 (multi-video-variants) 是做什麼的?

將一個已核准的主影片轉換為 N 個輸出,同時保留每個檔案來源狀態的完整可追溯性。它負責管理變體矩陣、主影片凍結、重新佈局副本、共用混音、命名規則、一次只渲染一個任務的佇列、代理監督規則以及清單閘道。它不設計主影片(由「類型」技能負責),也不取代逐檔案品質檢查(render-qa-deliver)。

凌駕於本檔案其他規則之上的規則

  1. 先有主影片,然後凍結。 衍生版本僅能從已通過自身完整品質檢查並以 manifest_check.py freeze 記錄的主影片中產生。後續需要修復時,必須在主影片中進行,使用 change 記錄,並將修補套用至同一輪次中的每個副本,然後所有衍生版本都必須重新渲染並重新記錄。嚴禁僅修復單一副本。
  2. 重新佈局,絕不裁切。 每個長寬比都是主影片來源的副本(hf_9x16/、hf_1x1/ ...),擁有自己的畫布、安全區域、字型大小、字幕軌道、攝影機關鍵幀和臉部居中。對已渲染的主影片進行 FFmpeg 裁切或縮放不算是變體。
  3. 單一混音。 重新佈局和鉤子變體使用相同的 cues.js 和相同的 assets/mix.wav 位元組,並從該單一檔案進行混合;音訊不會為每個變體重新建構。真正需要自己混音(無音樂、自有旁白、重新剪輯長度)的變體必須在清單中聲明其原因。
  4. 整台機器一次只處理一項繁重工作(渲染、check、遮罩、ASR、Blender),並使用 render_lock 控制。平行工作僅限於非繁重任務(佈局、規格、審閱 QA)。最多 4 個代理同時執行,每個代理最多 2 個子代理。
  5. 「就緒」狀態是計算出來的,不是斷言的。 僅在 manifest_check.py check 返回退出碼 0 時才允許使用這個詞。逾時、空資料夾、缺少雜湊值、qa: not_run 或缺少證據都應標記為 blocked / INSUFFICIENT_EVIDENCE,絕不能標記為 pass。
  6. 未經 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逐輸出 QAframe_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-check 29 個案例,退出碼 0 READY / 1 BLOCKED / 2 INSUFFICIENT_EVIDENCE)和 scripts/test_manifest_check.py(單元測試)。

Individual skills in this repo

This repo contains 5 individual skills — each has its own dedicated page.

Malik-rgb43/editing-workflow

>- Script, edit or review a paid-social ad, sponsored post or brand promo for a business, product, app or store (Meta, Instagram, TikTok, 15-60 s): exact offer and CTA, ranked hooks, hook variants, end card, blocking compliance table, licence checks. Triggers: ad, promo, sponsored, campaign; מודעה, פרסומת, קמפיין, ממומן, פרומו, מבצע, הנחה, הוק. NOT for testimonials (edit-testimonial), organic expert reels (edit-talking-head), AI-only films (edit-ai-generated), ratio exports (multi-video-variants).

Malik-rgb43/editing-workflow

>- Design, build and review a motion-graphics piece in HyperFrames/GSAP: product or app launch, feature announcement, kinetic typography, logo reveal, UI explainer, animated screenshots. Triggers: מושן גרפיקס, אנימציה, השקה, טיפוגרפיה קינטית, לוגו אנימציה, "like a Higgsfield / Linear launch". Not for a speaker-to-camera reel (edit-talking-head), AI-generated shots (edit-ai-generated), caption-only work (hebrew-captions-asr) or ad compliance (edit-ad-promo).

Malik-rgb43/editing-workflow

>- Transcribe Hebrew speech and build burned-in Hebrew captions: ASR route per hardware, word timestamps, proofreading, RTL and mixed English/number lines, caption font, entrance and exit animation, safe zone, caption QA. Triggers: תמלול, תמלל, כתוביות, כתוביות בעברית, מילים בולטות, קריוקי, המילה יצאה לא נכון, Hebrew captions, transcribe Hebrew, word timestamps, ו/ז look-alike. NOT for translation-only, non-Hebrew ASR, analysis reports (video-analysis), or caption-free motion launches.

Malik-rgb43/editing-workflow

>- Turn a video the user sends or links (file, or YouTube/TikTok/Instagram URL) or a folder of clips into measurements (cuts, pacing, per-frame data), keyframe sheets, a Hebrew transcript and sound analysis (SFX, BPM, key, beats, song ID). Triggers: watch, analyse, break down, transcribe this video/reel/ad; תנתח, תעבור על, תמלל, מה קורה בסרטון, קאטים, BPM. NOT for cutting or rendering (type skills), applying a style (reference-style-transfer), or captions for a final render (hebrew-captions-asr).

Malik-rgb43/editing-workflow

Turn a new video idea, brief or list of specifics into a checkable Concept Ledger and ask questions until every parameter is precise, before any concept, prompt or build. Use at the start of any new video, with or without footage, or when the user pastes a concept with specifics. Hebrew - סרטון חדש, בריף, יש לי רעיון, קונספט, תכין לי סרטון, בוא נתחיל פרויקט. NOT for notes on an existing draft (revision-round), analysing a reference (video-analysis) or paid generation (paid-generation-gate).

相關技能