技術概念直式短片（附旁白）for Carli Code
概念：Carli 提供主題，技能建構視覺內容（以品牌風格呈現的動畫投影片），並配合她的旁白的長度與節奏；她只需錄製語音（並在少數時刻出現在鏡頭前）。影片核心是程式碼與圖表，而非臉部畫面。
流程分為三個步驟，各設有檢查點。不可跳過步驟：在她核准草稿之前，不會建構任何內容。
全程使用繁體中文。品牌風格：references/style.md（黑色、粉紅色 = 強調色、紫色 = 結構色、Space Grotesk + JetBrains Mono 字型、Lucide 圖示，影片中不使用表情符號）。
儲存位置
一律儲存於 ~/Documents/Contenido tech skill/<slug>/（若資料夾不存在則建立之；使用技能者可在此修改路徑；以 kebab-case 格式建立主題縮寫子資料夾，不含變音符號）。最終內容：
<slug>/
├── video-completo.mp4 （所有場景合併，1080x1920，30 fps）
├── clips/01-gancho.mp4 … （每個場景一個片段）
├── copy.txt （含 SEO 描述 + 5 個主題標籤）
├── guion.txt （僅旁白文字，供提詞機使用）
├── portada.txt / portada.png （影片封面標題：文字 + 影像 1080x1920）
└── fuente/ spec.json, video.html, meta.json （供編輯與重新匯出）
必要相依性（請檢查一次）
python3 --version && node --version && ffmpeg -version | head -1 && ls "/Applications/Google Chrome.app" >/dev/null && echo OK
若有缺少，請提供安裝指令（brew install ffmpeg）。
步驟 1 — 提問
閱讀 references/flujo.md（步驟 1 部分）。以你自己的話摘要你對主題的理解，並一律提出 4 個問題（技術層級、切入角度、程式碼範例、影片長度及臉部畫面出現時機）使用 AskUserQuestion。等待回覆。
步驟 2 — 詳細草稿：每秒出現的內容 + 旁白腳本
閱讀 references/flujo.md（步驟 2）、references/escenas.md 和 references/voz.md。撰寫 fuente/spec.json 並以以下指令驗證：
python3 ~/.claude/skills/video-concepto-tech/scripts/build_video.py spec.json --plan
在對話中呈現草稿（需包含時間；以表格呈現「秒數 | 畫面內容 | 你的旁白」，並列出場景、臉部畫面出現時機、假設），詢問哪些需要修改。反覆迭代直到她核准為止。草稿中的時間必須與 --plan 輸出一致，不可自行編造。
步驟 3 — 完整影片 + 場景片段 + 文案 + 旁白
僅在核准後執行。依照 references/flujo.md（步驟 3）：編譯 → 以 --still 檢查每個場景 → 背景匯出 → 撰寫 copy.txt（參考 references/copy-seo.md）→ entregar.py。最終回覆需以純文字呈現：路徑、各影片長度、封面標題（也寫入 portada.txt 與 portada.png；若第一場景的標題不適合當封面，請在 spec 中定義 portada）、完整文案與完整旁白腳本，每個項目以獨立程式碼區塊呈現（無表格、可直接複製貼上；旁白腳本僅為她所說的文字，不含時間、標題或標記，場景之間以空行分隔，因為她會貼到提詞機）；並將文案與旁白分別存為 .txt 檔案於資料夾中。
若她已有音檔
build_video.py spec.json --out fuente --audio voz.m4a 會根據單詞分配場景長度；若提供每個場景結束的準確秒數（--cortes 9.8,24.1,…），則可精確對齊至毫秒。接著 export_video.mjs … --audio voz.m4a 會將語音混入完整影片及每個場景片段中。
預設格式：旁白型 TikTok（Carli 修正版，2026 年 10 月）
除非另有要求，旁白影片應動態且文字精簡：重點在於標題、程式碼與執行結果。
- 封面：僅顯示標題（
cover搭配solo_titulo: true），向上靠齊並置中（下方保留空間給她的臉部畫面），5 秒（dur: 5）。無 Logo、無紫色線條、無「第 N 部分」字樣於畫面上（這些放在文案中）。 - 貼紙風格標題（Carli 參考，2026 年 10 月 14 日）：使用 Poppins 800 字型、全大寫、置中且大字（108 px；封面 120 px），略微傾斜，帶黑色邊框與實色陰影。文字逐字出現（彈跳效果）。關鍵字以粉紅色標示（
*關鍵字*），可選黃色（~關鍵字~）。標題下方放置一個黃色藥丸形標籤（pill），內含 2–4 個字的概念說明，不重複標題文字，兩側帶粉紅/黃色閃光效果。 - 黃色
#ffd60a：第三品牌強調色（僅用於藥丸標籤與閃光；粉紅色仍用於重點標示，紫色用於結構）。Carli 核准為標準（搭配 Poppins 800 字型）。 - 概念場景：簡短標題 + 程式碼（
code_focus）+ 可見的執行結果（salida），關鍵數值以粉紅色標示。無紫色提示行、無程式碼下方文字筆記、無文字量大的圖表（versus,list…）。若概念為指令，則程式碼顯示指令，執行結果顯示其輸出。 - 正確的技術術語（英文）：當業界普遍使用英文時（如 "lazy imports"、"frozendict"、"profiler"），切勿直譯（如「懶匯入」）。
- 真實結果：查閱官方文件以確認程式碼的輸出；若需摘要（長表格），請在假設中說明。切勿編造輸出或指令。
- 無畫面上回顧（「你學到了什麼」）：結尾僅為品牌動畫（
outro：CARLICODE 逐字出現帶光澤，並有游標點擊「追蹤我」），約 5 秒，旁白僅「追蹤我以獲得更多技術內容」。 在建構前，對於不清楚的部分（封面內容、結尾效果、如何將圖表轉為程式碼）務必提問。
變體：混合臉部畫面的技術概念影片（60% 圖表 / 40% 她本人）
適用於概念（非程式碼）類內容：交替使用 cara（臉部）與 diagram（圖表）段落。已於「Kubernetes on AWS (EKS) in 70 seconds」中驗證。
- 步驟 1 中額外提問：切入角度、臉部/圖表比例分配（預設交替進行，鉤子與結尾為臉部）、是否使用比喻 + 架構圖或僅其中一項、以及如何接收臉部段落。
cara：她出現在鏡頭前的段落。僅保留標題（無邊框、無圖示、無文字；她會在後製時疊加自己的影片；dur為必填）。若設定"marco": true，則繪製「你的臉部在此」的邊框與進度條（僅在她要求時）。需標記cara: true。diagram：1000×1000 的大型畫布，元素逐一建構（box、dbox、arrow、text、pill、icon、poly、wave；cae使元素墜落；escala放大元素）。詳見references/escenas.md。將t與旁白正在唸的句子同步，並使用--still檢查。- 標題：
==關鍵字=== 黃色螢光標記，*關鍵字*粉紅色，~關鍵字~黃色文字；title_px調整大小。每個段落的標題置中並以大號字體顯示。 - 70 秒結構範例：臉部 8 秒 → 圖表 12 秒 → 臉部 6 秒 → 圖表 14 秒 → 臉部 6 秒 → 圖表 12 秒 → 臉部 6 秒 → 結尾 6 秒（≈63/37）。第一個場景可以為
cara（不再強制要求cover）。 - 使用通用圖形（具名稱的方框），而非 AWS 官方圖示；請在假設中說明。
規則
- 無音訊的影片是視覺基礎：她播放影片觀看同時錄製旁白，並在標記為
cara的場景上方疊加自己的臉部畫面。 - 技術準確性：若內容經過簡化，請在旁白及假設中說明；切勿編造數據。僅供示意之數據 →
// 範例資料。 - 每部影片僅探討一個概念。若需超過約 90 秒，建議拆分為兩部系列影片。
- 畫面文字簡短（
escenas.md中標示欄位限制）；程式碼不超過 12 行，每行不超過 40 個字元，以確保在手機上可讀。 - 如需編輯：修改
fuente/spec.json，重新編譯並重新匯出（--only N可重新匯出單一場景並重新合併完整影片）。