winterwindwang/super-video-cut

super-video-cut 是做什麼的？

定位

將每一次剪輯工作視為一個帶有證據鍊的工程交付，而非憑感覺拼湊的片段。此技能提供可複現的客觀衡量、逐項且有理有據的評估、可重複使用的時間軸模板、交付前品質檢查，以及貫穿整個流程的版權邊界。

references/ 存放深度素材，按能力領域分類（約 50 個文件，大部分為 100–250 行的參數表和規格說明）。不要預先閱讀全部——請依照下方的路由指引，僅閱讀當前階段所需的 1–3 個文件。

本文件使用的卷號簡寫：09/02 代表 references/09-material-memory/02-*.md。

三條紅線

違反任何一條都不得交付。

1. 參考風格：先評估，後剪輯。 當使用者提供參考影片時，你必須完成三維度評估（剪輯手法 / 音效 / 場景），並為每一項提供逐項論證，在獲得使用者確認前不得碰觸時間軸。未經確認就產出剪輯視為返工。
2. 素材：在呼叫模型前先檢查快取。 在分析任何影片素材之前，請執行 material_cache.py lookup。如果命中，直接讀取素材描述卡——再次呼叫影片模型進行分析是禁止的；只有在未命中時，才能執行一次完整分析並註冊。
3. 合規與品質檢查優先。 請勿剪輯版權風險未確定的計劃，也請勿交付未通過 qc_scan.sh 的最終檔案。法律相關卷宗僅供參考，不構成法律建議；對於商業或高風險項目，請告知使用者諮詢法律顧問。

主要工作流程 M0–M6

階段	目標	必讀文件	輸出
M0 需求釐清	鎖定可執行參數	本文件	簡報
M1 素材處理	絕不為相同的 tokens 付兩次錢	09/02 + scripts/material_cache.py	素材卡或快取命中
M2 風格評估	將「感覺」轉化為參數	08/02 + 08/03 + scripts/reference_probe.sh	評估表 + 指紋 + 一頁結論
M3 剪輯計劃	指紋 → 時間軸	08/04 + 匹配的類別卷宗	秒級計劃
M4 製作	剪輯 / 配音 / 字幕 / 調色	按需閱讀 01 / 02 / 03	粗剪與專案檔
M5 交付品管	技術 + 合規檢查	06/01 + 06/02 + 06/03	品管報告 + 偵測日誌
M6 回饋循環	僅產出候選方案，永不自動更改規則	08/05	自我改進記錄

M0 需求釐清：詢問缺失參數，最多 3 個問題

你必須取得：平台與畫面比例（決定安全區域和時長）、總時長、是否需要配音 / 旁白、是否為商業用途、交付規格（解析度 / 碼率 / 容器）。

根據你已掌握的資訊推斷並說明任何可推斷的項目；不要逐項盤問使用者。作品是否為商業用途直接決定你可以使用哪些音樂和素材——如果這點不明確，你必須提問。

M1 素材處理：五種狀態的應對方式已固化

SK="$HOME/.workbuddy/skills/super-video-cut"
export MDC_HOME="$PWD/material-cache"     # 將快取保留在專案目錄內，絕不放在技能目錄中
python "$SK/scripts/material_cache.py" lookup "<素材路徑>"

狀態	應對方式
HIT	不要呼叫影片模型。 讀取 $MDC_HOME/cards/<MID>.yaml 並僅進行主題適配
MISS	本機 E1 探查 → 一次完整的分析請求，使用 references/09-material-memory/templates/model-analysis-prompt.md → 填寫卡片 → validate → register
STALE	素材已變更；將舊卡片標記為 superseded 並重新執行 MISS 流程
HIT_BLOCKED	權利狀態未清除；請勿使用——先解決權利問題
緊急停止	當 _config.json 中 cache_enabled=false 時，將所有情況視為 MISS；禁止繞過此設定

描述卡包含三層：L0 身份（雜湊 / 規格）、L1 素材描述（內容 / 拍攝地點 / 風格 / 是否可用）、L2 主題適配（此主題使用哪些秒數，及其敘事角色）。「很適合作為主題 X 的開場」屬於 L2 內容——放在 L1 會污染所有其他主題。

地點欄位是一條硬性規則：沒有畫面上文字、地標或拍攝記錄時，請設定 place_name: null。絕不能因為「有海和棕櫚樹」就推斷城市。

M2 風格評估：每當使用者提供參考影片時，執行六個步驟

S1 合規預檢查 → S2 客觀探查 → S3 兩次完整觀看 → S4 逐維度評估
→ S5 一頁結論 → S6 ★使用者確認關卡★

• S1 僅分析，絕不重複使用其表達。片頭片尾、對話、音樂、動態文字和鏡頭設計均標記為 protected: expression。
• S2 執行探查腳本以取得可複現的數據（剪輯點、鏡頭長度、響度、靜音、色彩統計、連拍表）。
• S3 完整觀看兩次：第一次只看畫面，第二次只看音訊。快轉會遺失節奏和保留的拍點——這是最常見的方法論錯誤。
• S4 針對三個核心群組逐項評估——A 剪輯手法 / B 音效 / C 場景（每組 10 個子項）——以及 D 字幕、E 敘事、F 平台情境，以及 G 合規邊界（強制）。
• S5 提供一頁結論：3 個關鍵特徵、3 個不可轉移項目、整體信心度。
• S6 交給使用者確認。未經確認，不得進入 M3。

每個評估項目必須填寫全部五個部分；缺失任何一部分，該項目無效：

① 觀察（時間碼 + 具體現象） ② 依據（證據 ID） ③ 推論（為何如此設計） ④ 行動項（此剪輯如何使用它） ⑤ 信心（高/中/低 + 原因）

反面示例（絕不能輸出）：「剪輯流暢且非常電影感。」——沒有時間碼、沒有依據、沒有行動項，沒有任何可執行內容。

每個行動項必須帶有轉移標籤：transferable: parameter（節奏、時長、響度、鏡頭大小序列——可學習）或 protected: expression（特定鏡頭、對話、音樂、動態文字——不可複製）。風格與公式屬於思想範疇，可以借鑑；表達則不能被複製。 這是此技能的版權底線，而非建議。

M3 剪輯計劃：將指紋轉化為秒級時間軸

閱讀 08/04 中的映射規則，產出可直接執行的時間軸：每個片段的入/出點、鏡頭大小、轉場類型與時長（以幀為單位）、音效提示點、字幕入/出點，以及響度目標。

衝突解決順序：明確的使用者要求 > 平台硬性限制 > 參考影片特徵 > 預設美學。當素材無法支援某項要求時，應直接說明——「參考影片使用了技術 X；此專案沒有匹配的素材，因此由 Y 替代」——而不是強行製作。

M4 製作：每個當前動作只閱讀一個卷宗

正在執行	閱讀
節奏、轉場、軸線	01/01, 01/02
專案組織、代理、套底、交付	01/03
調色、Log/LUT、HDR	01/04
錄音、交付、ADR	02/01
混音、響度、EQ/壓縮	02/02
配樂、音效、聲音設計	02/03
AI 語音、TTS、SSML	02/04
字幕排版與時長	03/01
SRT/VTT/ASS/TTML 格式	03/02
轉寫、對齊、內嵌	03/03
多語言、CC/SDH、無障礙	03/04
如何剪輯特定類型	04/01–04/06

響度基準（完整目標表在 02/02）：串流約 -14 LUFS、播客/Apple 約 -16 LUFS、廣播 EBU R128 為 -23 LUFS，真峰值通常需 ≤ -1 dBTP。應遵循目標平台的官方文件；若不確定，先測量，再決定。

M5 交付品管：先執行腳本，再人工判斷

bash "$SK/scripts/qc_scan.sh" "<完成檔案>" "<輸出目錄>"

一次執行可獲得規格 JSON、解碼完整性、黑幀/凍結偵測、靜音、響度及連拍表。腳本僅能找出技術異常——內容與合規部分必須逐項手動檢查表格：

• 06/01 技術規格檢查清單（解析度 / 幀率 / 色彩 / 碼率 / 音軌 / 時長 / 命名）
• 06/02 內容與合規審查（事實、敏感內容、禁止的廣告宣稱、權利文件）
• 06/03 表 A–G 填寫範本（用於歸檔）

品管嚴重級別：阻擋（黑幀、缺少音軌、響度超出公差、侵權風險）必須修復；改進項經記錄後可交付；建議項等待下個版本。

M6 回饋循環：一支爆款影片永遠不會改變規則

收到實際回饋後（完成率、轉換率、客戶意見），依照 08/05 進行錯誤歸因，並寫入 08/case-library/<CASE-ID>/self-improvement-record.md。

硬性規則：單一案例僅產出候選方案；只有在累積 ≥5 個同方向樣本、擁有凍結的回歸測試集、人工簽核、版本控制以及金絲雀發布後，變更才能生效。自我改進引擎不得自動改寫素材描述卡的 E1/E2 客觀欄位——快取會將一個錯誤擴散到所有後續主題，而命中記錄仍看似完全正常。

觸發後的最短路徑

使用者說	執行方式
「按照這支爆款影片的風格剪輯」	完整 M2 流程 → S6 確認關卡；不要開始剪輯
「幫我剪這支影片」	M0 詢問平台/時長/商業用途 → M1 素材 → M3 計劃
「這支素材能用嗎？內容是什麼？」	M1 lookup；命中直接回答，未命中才分析
「加字幕」	03/01 排版 + 03/03 轉寫與對齊；檢查閱讀速度與最小時長
「配音聽起來很糟」	02/01 錄音 → 02/02 處理鏈 → 測量響度
「導出給抖音 / 微信視頻號 / B 站」	04/01 平台規格 + 06/01 交付檢查
「這個剪輯會侵權嗎？」	05/02 決策樹 + 08/02 中的維度 G；給出風險等級，而非結論性法律意見
「完成的剪輯可以嗎？」	qc_scan.sh + 06/01 / 06/02 逐項檢查

腳本

腳本	用途	依賴項
scripts/material_cache.py	素材指紋、快取查詢、註冊、重複使用、驗證、統計（8 個子命令）	Python 3，無第三方套件
scripts/reference_probe.sh	參考素材或檔案的客觀探查：剪輯點、鏡頭長度、響度、靜音、色彩、連拍表	bash + ffmpeg/ffprobe
scripts/qc_scan.sh	完成檔案的技術品管：規格、解碼、黑幀、凍結、靜音、響度、連拍表	bash + ffmpeg/ffprobe

先檢查環境：ffmpeg -version && ffprobe -version && python --version。沒有 ffmpeg 就無法進行任何客觀測量——在這種情況下，應明確告知使用者只能進行人工評估，無法提供可複現的指標。絕不能捏造數字。

交付前自我檢查

• 參考影片已通過 S1–S6 且使用者已確認（如果使用了參考影片）
• 每支素材都能在快取中追溯到其來源與權利狀態
• 評估或計劃中未出現「流暢」、「高級」、「質感」等無依據詞彙
• 響度已測量且在目標公差內；真峰值低於限制
• 字幕未超出安全區域，無錯別字，且符合閱讀速度限制
• qc_scan.sh 未報告任何阻擋項目，且表 A–G 已填寫
• 音樂 / 字型 / 肖像 / 素材庫的權利文件齊全，或已說明風險等級
• 交付檔案命名、容器與碼率符合平台要求

素材範圍（必須向使用者說明）

• 法律相關卷宗並非法律建議。 文章與司法見解會隨時間變動；對於商業或高風險項目，應請法律顧問審查並依賴最新的官方文字。
• 平台參數會變動。 時長、碼率、安全區域與響度目標在不同來源間可能有衝突，因此一律標註「以平台最新官方文件為準」——交付前請上傳預覽以確認。
• 自我改進參數無行業標準。 08 卷中的 η、δ、N_min 等是此資料庫自身的起點數值，其存在是為了讓流程可執行，並非經過驗證的最佳值。
• 大約 190 個「待驗證」項目位於各文件正文或結尾，主要集中在 references/00-overview/sources-and-reliability.md（附有 A/B/C/D 證據等級與 P0/P1/P2 優先級）。在引用任何資訊前，請先檢查該檔案的證據等級。

路由與索引

• references/INDEX.md — 每個階段或任務的最短路徑與最低必讀內容
• references/00-overview/knowledge-map.md — 完整能力領域映射與故障排除快速查詢
• references/00-overview/sources-and-reliability.md — 證據等級、來源列表、待驗證項目
• references/00-overview/manifest.csv — 機器可讀的檔案索引

搜尋大型檔案時，應使用關鍵字定位而非從頭讀到尾，例如 grep -n "LUFS" references/02-audio-and-voice/02-audio-post-and-mixing.md。