Videoskill — 端到端影片編輯（白標）
白標技能：程式碼中沒有固定名稱、Logo 或顏色。所有內容來自
marca/（marca.json 品牌識別與顏色、canal.json 頻道與社群、proyecto.json
團隊與資料夾）。工作語言：繁體中文。
啟動合約
當使用者要求編輯影片或其原始素材、製作 Shorts / Reels / TikTok、
剪輯 YouTube 集數、建立含語音的動畫廣告、縮圖或 LinkedIn 輪播時使用。
也適用於使用者提供腳本進行錄製（videos/_shared/plantillas/guiones.md）
或想要執行完整專案流程（proyecto01、promo01、anuncio01）。
硬性規則
- 未經詢問，不得發布任何內容、消耗額度或上傳檔案至任何服務
（例外：始終將交付成果複製到其 Drive
final/<id>/）。消耗額度時， 應告知已消耗多少及剩餘多少。 - 公開連結：一律使用
https://tumarca.com（絕不使用長網域）。社群媒體設定在marca/canal.json。 - 始終使用真實攝影機畫面；數位分身（如 HeyGen）僅作為備用方案。
- 在進行任何操作前，請先閱讀
references/reglas-tecnicas.md。 發生錯誤並修正後，請記錄於此：系統會隨著每個影片學習。 - 在設計場景、背景、卡片、縮圖或其他內容前，請查閱
references/diseno.md。 - 每次渲染前執行
npx tsc --noEmit；始終進行影格品質檢查 （node remotion/scripts/qa.mjs…）並在完整渲染前檢查結果。 - 始終從本地磁碟處理； 僅用於複製，絕不用於處理
（
pipeline/brutos.py traer|entregar <id>）。
目錄結構
marca/ 品牌識別（唯一包含名稱、顏色、Logo、社群媒體的位置）
pipeline/ Python 腳本（按流程順序編號）+ comun.py
remotion/ 合成：Intro|Disclaimer|Catalogo (Parte), Grueso/GruesoGraficos,
Short, Linkedin, Lamina, Miniatura · 場景在 src/escenas · 腳本 scripts/qa.mjs
videos/ Remotion 的 publicDir：僅 Remotion 讀取的內容（剪輯片段、JSON、B-roll、音樂、Logo）
_shared/ music/, logos/, fx/, marca/, obj/, descripciones/, plantillas/
<id>/ plan.md, guia_grabacion.md, partes.json, <parte>.json, shorts.json, …
references/ 輔助手冊（參見決策閘道）
raw/<id>/ 從 Drive 複製的原始素材 + 大量中間檔案（在 git 之外）
out/ 渲染輸出、qa/、縮圖、交付成果/<id>/（在 git 之外）
流程（摘要）
| 步驟 | 內容 | 關鍵指令 |
|---|---|---|
| 0 | 腳本與錄製指南 | 模板在 videos/_shared/plantillas/ |
| 1 | 拉取原始素材並檢查（ffprobe、鏡像、旋轉） | python pipeline/brutos.py traer <id> … |
| 2 | 攝影機片段：語音同步 → 轉錄 → 分段 → 移除靜默 | 05_sync → 02 → 03 → 01 (+ 僅 alinear.py) |
| 3 | 概念與錨定於語音的場景 | lectura.py → historial.py → <parte>.json → qa.mjs |
| 4 | 螢幕畫面區塊（主體）：準備、像素化、縮放、混合渲染 | 04_grueso → 06_zooms → render_grueso |
| 5 | B-roll、縮圖（Higgsfield + Remotion）與逐部分渲染 | out/lote_<id>.cmd |
| 6 | 最終剪輯至 -14 LUFS，含章節與描述 | 07_final.py |
| 7 | 直式 + LinkedIn（Shorts/Reels/TikTok/4:5，PDF 輪播） | 09_shorts.py → 10_linkedin.py |
| 8 | 結案：記錄歷史與報告 | historial.py registrar <id> → LEEME_<id>.md |
變體：短廣告（promo01，搭配 cola 的密集直式內容）與含旁白的動畫廣告
（anuncio01，無攝影機畫面，3D 面板）。逐個指令詳細說明：references/flujo.md。
決策閘道
| 你需要… | 請閱讀 |
|---|---|
| 執行完整流程或特定步驟及其指令 | references/flujo.md |
從目錄中選擇場景（type）、圖層、背景、風格與音效 | references/escenas.md |
| 設計：開場/鉤子、CTA、結尾、玻璃卡片、3D 圖示、動畫背景 | references/diseno.md |
| 縮圖、Higgsfield、ElevenLabs 語音、Logo、本地模型、環境 | references/herramientas.md |
| 調試已知錯誤或避免已踩過的坑 | references/reglas-tecnicas.md |
輸出合約
每個專案最終包含：
- 橫向 YouTube（1920×1080，-14 LUFS）：已剪輯片段、有效章節、 含來源說明的描述與縮圖。
- 直式 → 3 種不同文字的版本：YouTube Shorts（附音樂）、 Instagram Reels 與 TikTok（無音樂；使用者發布時自行添加）。
- LinkedIn：4:5 影片、PDF 輪播、單張圖片與貼文文字。
- 全部位於
<DRIVE>/final/<id>/（shorts/、linkedin/）以及報告out/entregas/<id>/LEEME_<id>.md： 包含哪些內容、需要檢查什麼、已消耗的額度與可直接貼上的文案。發布為手動操作。