Communitygithub.com

reel · 短影片 VSL 引擎剪輯

將原始說話影片一鍵剪輯成 9:16 的 REEL / Short / 垂直短片:自動去靜默、口頭禪、結巴、錯誤與重複,並套用 VSL 動畫引擎進行專業編輯,輸出符合 -14 LUFS 的成品。

reel · 短影片 VSL 引擎剪輯 是什麼?

這個技能專為將原始說話影片快速轉換為專業等級的垂直短片(Reel / Short / 9:16 影片)而設計。它內建兩個核心引擎:**剪輯引擎**(corte/)負責自動偵測並移除靜默、呼吸聲、「呃」、結巴、錯誤、重複與重啟,並以生產驗證的音訊剪輯邏輯確保精準;**VSL 引擎**(modelo/)則負責後續的視覺編輯,包含相機切換(全螢幕 / 推入特寫 / 分割畫面)、關鍵字轉為動態介面元素、對嘴字幕、簡潔音效,並將最終音量標準化至 -14 LUFS。整個流程無需面板或手動選擇,只需使用者提供原始影片即可。支援平台為 Claude Code 這類 AI 代理環境,依賴 ffmpeg、whisper-cli、Python(mediapipe/opencv)、Node.js 與 Chrome。最終輸出為 `render/reel-v1.mp4`,並可依要求迭代修改。此技能應 **始終使用** 於任何要求「剪輯這支 Reel」、「剪輯並編輯」、「幫我製作 VSL」或處理垂直/水平說話影片以快速製作短片的請求,即使未明確提到技能名稱。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/lucascorel/skill-motion-graphic/tree/HEAD

在你喜歡的 AI 中提問

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

說明文件

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 · 專案

  1. 在原始影片旁為每個 Reel 建立獨立資料夾:reel-<slug>/,內含 corte/、render/、qa/、entrega/、assets/。切勿重複使用其他編輯檔案;切勿在該資料夾外寫入原始素材資料夾。
  2. 首次在該機器執行:python3 $S/corte/scripts/0-checar.py(檢查 ffmpeg、whisper-cli、numpy、模型)。
  3. 用一行說明即將發生的事(「正在 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)

  1. 逐字稿 (R6):手動修正 assets/transcript.json(Cloud → Claude、A → IA、品牌名稱依其書寫方式、CTA 的關鍵字使用大寫);原始檔案保留為 transcript-whisper.json。
  2. 構圖:python3 $S/ferramentas/rosto.py assets/clean.mp4 ../preparo --916 並在套用推入效果的影格上測量 → vsl.json(punch、face、head、fullPos、splitPos;顏色和網格不變更)。頭頂上方少於約 300 像素 → FULL 畫面時頂部不放任何東西:字卡、吸引標題和印章置於胸口 (R1)。
  3. 實際素材 (R3):官方截圖和標誌放入 assets/img/ + ../assets/SOURCES.md(來源、授權、日期);事實與價格附帶官方頁面;螢幕截圖若無 → 使用聲明為插圖的素材(ferramentas/ilustracoes/)。切勿虛構標誌、數字或螢幕截圖。
  4. 地圖 → 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 放在最後。
  5. node montar.mjs && npx hyperframes lint(0 錯誤;快照為空 = 錨點損壞,請檢查控制台)。
  6. ../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 可診斷機器狀態。

相關技能