reel · 在 VSL 引擎上剪輯與編輯
一個技能、兩個引擎、零面板。使用者提供影片;你使用剪輯引擎 (corte/) 進行剪輯,並使用 VSL 引擎 (modelo/,產生已核准參考影片的原始套件) 進行編輯,遵循基本規則 (regras-da-casa.md,優先於一切) 與 ESTILO.md (引擎規格說明)。結果與工作室以原生外觀 VSL 風格交付的內容相同:相同的顏色、字型、音效與規則。切勿發布或傳送影片 (R9)。影片或檔案中不得出現任何第三方名稱 (R11)。
開始前請依序完整閱讀:regras-da-casa.md → corte/CORTE.md → ESTILO.md → modelo/README.md → modelo/exemplo/LEIA.md。值得花時間閱讀的重點是:品質標準是範例,而非最低門檻 (modelo/exemplo/beats-exemplo.js 是標竿;每個影片都有其專屬地圖)。
技能地圖
SKILL.md 此檔案(流程總覽)
regras-da-casa.md R1–R11:臉部永不遮擋、音效節制、實際素材、不漏字、−14 LUFS…
ESTILO.md VSL 引擎規格:佈局、構圖、動態、字幕、元件、音效、流程、驗收、經驗教訓
pele.json 原生數值(字型、五色、不變量)— 參考影片的外觀
corte/ 剪輯引擎:CORTE.md(腳本)· references/EDICAO-BRUTA.md(設計原因)· scripts/ · exemplo/
modelo/ VSL 引擎:kit/(保持不變)· montar.mjs · preparar.sh · ferramentas/ · exemplo/(已核准的 Reel)· README.md
ferramentas/ preparar.py · rosto.py · ancoras.py · verificar.py · zona-segura.py · recortar.py · audio-final.sh
anexos/ 參考影格的畫面以及調色前後對比
S=~/.claude/skills/reel (或 REEL_SKILL)。環境變數 (R10):WHISPER_MODEL、VSL_PYTHON (含 mediapipe 或 opencv 的 Python)、FACE_MODEL、VSL_NODE_MODULES、CHROME、RVM_PYTHON(僅用於 matte)。
流程(固定順序)
0 · 專案
- 在原始影片旁為每個 Reel 建立獨立資料夾:
reel-<slug>/,內含corte/、render/、qa/、entrega/、assets/。切勿重複使用其他編輯檔案;切勿在該資料夾外寫入原始素材資料夾。 - 首次在該機器執行:
python3 $S/corte/scripts/0-checar.py(檢查 ffmpeg、whisper-cli、numpy、模型)。 - 用一行說明即將發生的事(「正在 VSL 引擎上進行剪輯與編輯;v1 將在幾分鐘內完成」),並在每個耗時步驟前預告。長時間步驟在背景執行。
1 · 剪輯(剪輯引擎,完整閱讀 corte/CORTE.md)
B=$S/corte/scripts · 所有操作均在 corte/ 內:
python3 $B/1-tomadas.py "<bruto>" corte && cat corte/tomadas.txt # 選擇前完整閱讀
# 寫入 corte/keeps.json(保留規則:每個句子中最完整的鏡頭;排除假起跑)
python3 $B/2-vicios.py corte
python3 $B/3-corte.py "<bruto>" corte # 4 影格的 J/L 剪輯(VSL 標準)
python3 $B/4-conferir.py corte --prompt "<影片中的專有名詞>" && cat corte/conferencia.txt
標準 (R5):conferencia.txt 中所有區塊皆通過;不漏掉任何字;無停頓 > 0.25 秒。若有漏字 → 保護該區間 (raw/force) 並重新剪輯。如果使用者說影片已經乾淨,則跳過:cp "<vídeo>" corte/clean.mp4 並使用 $S/ferramentas/preparar.py corte/clean.mp4 preparo 進行轉錄。輸出:corte/clean.mp4、corte.wav、edl.json、cortepalavras.json。
2 · VSL 引擎 · 準備
cp -R "$S/modelo" motor && cd motor && bash preparar.sh
建立 9:16 的相機畫面(assets/clean.mp4)、套件格式的逐字稿、執行 npm install、嘴唇追蹤與首次組裝。若無 pele-resolvida.json,外觀為原生(即參考影片的外觀):請勿自行建立。
3 · 第一階段 · 藍圖(modelo/README.md)
- 逐字稿 (R6):手動修正
assets/transcript.json(Cloud → Claude、A → IA、品牌名稱依其書寫方式、CTA 的關鍵字使用大寫);原始檔案保留為transcript-whisper.json。 - 構圖:
python3 $S/ferramentas/rosto.py assets/clean.mp4 ../preparo --916並在套用推入效果的影格上測量 →vsl.json(punch、face、head、fullPos、splitPos;顏色和網格不變更)。頭頂上方少於約 300 像素 → FULL 畫面時頂部不放任何東西:字卡、吸引標題和印章置於胸口 (R1)。 - 實際素材 (R3):官方截圖和標誌放入
assets/img/+../assets/SOURCES.md(來源、授權、日期);事實與價格附帶官方頁面;螢幕截圖若無 → 使用聲明為插圖的素材(ferramentas/ilustracoes/)。切勿虛構標誌、數字或螢幕截圖。 - 地圖 → beats:
assets/map.md(時間 × 話語 × 相機 × 元件,如exemplo/mapa.md),然後建立src/beats.js,每行地圖對應一個K.*呼叫,時間僅透過K.at("精確話語")設定(請先完整閱讀exemplo/beats-exemplo.js)。每 1.5–3 秒出現新元素;FULL ≈ SPLIT;每次切換和每個字卡都使用K.hideMouth;K.mouthCaps放在最後。 node montar.mjs && npx hyperframes lint(0 錯誤;快照為空 = 錨點損壞,請檢查控制台)。../entrega/planta.json(編號、佈局、起始、結束、話語、畫面)以及node ferramentas/cards.mjs→entrega/cards/P01.png…。
關卡: 預設情況下直接進入第二階段 — 使用者要求快速。僅在使用者要求(「先讓我看」)或內容有疑問需要使用者確認時(事實、價格、名稱)才暫停並顯示地圖或卡片。
4 · 第二階段 · 渲染(modelo/README.md)
npx hyperframes snapshot --at <每次切換與每個 beat> -o snapshots # 臉部無遮擋 (R1)、無裁切/重疊
node ferramentas/zona-segura-dom.mjs . --strict # "安全區域 OK"
npx hyperframes render -q high -o ../render/_reel-bruto.mp4
node montar.mjs --so-camera && npx hyperframes render -q high -o ../render/_camera-so.mp4 && node montar.mjs
bash ferramentas/audio-final-vsl.sh ../render/_reel-bruto.mp4 ../render/reel-v1.mp4 # −14 LUFS ±0.3 · 峰值 ≤ −1 dBTP
node ferramentas/sons.mjs && bash ferramentas/folha.sh ../render/reel-v1.mp4 ../qa/folha-final.png
python3 "$S/ferramentas/verificar.py" .. --video render/reel-v1.mp4 --sfx ../sons.json --camera ../render/_camera-so.mp4
完成後在專案資料夾中寫入 MINUTAGEM.md(逐 beat 記錄:時間、話語、顯示內容、佈局、音效)與 progresso.md。在展示前先自行審查: VERIFY.md 全部通過、影格檢查表、R1(臉部)、R2(精簡模式下音效 ≤ 0.8 個/秒)、R6(字幕)、R7(安全區域)、R8(音訊)。最多 2 輪調整後再交付。
5 · 交付與迭代
回覆內容包含:reel-v1.mp4 路徑、時長(原始 → 剪輯後 → 最終)、LUFS 與峰值、畫面數與特效數、剪輯時排除的內容與保護的內容、字幕修正、事實來源、未解決事項。要求調整 → reel-v<N+1>.mp4(先前版本保留在 render/);若變更剪輯 → 重新轉錄並重新規劃地圖 (corte/scripts/remapear.py),切勿手動重新計時。
執行規則
- 引擎不可改寫。
modelo/kit/與corte/scripts/保持不變;每個影片僅寫入src/beats.js、vsl.json、keeps.json與調整參數。剪輯參數的變更僅能根據corte/references/EDICAO-BRUTA.md第 9 節的診斷,一次變更一個,並記錄變更。 - 每輪一個版本,完整且經過驗證。
- 精簡音效(
"sfxModo": "enxuto",vsl-padrao.json的預設值):≤ 0.8 個特效/秒,包含打字聲,打字聲必須持續不間斷。參考影片的原始音效 ("referencia") 僅在要求時使用。 - 始終使用實際素材;插圖必須明確標示。臉部永不遮擋。 安全區域。
- 你在本次對話中負責產出。 如果使用者要求特定代理或模型,請啟動一個通用代理,並以本 SKILL.md +
ESTILO.md+modelo/README.md作為簡報,然後審查其交付成果。 - 有任何失敗(ffmpeg、whisper、模型、npm、Chrome)?用一行說明該如何處理;
corte/scripts/0-checar.py可診斷機器狀態。