motion-spot 是做什麼的?
製作出媲美工作室等級的廣告,運用的是從分析 45 支 Claude 製作的廣告(觀看次數達數百萬)中提煉出的方法(詳見 references/estudio.md)。所有成功廣告的共同配方是:
一個帶有張力的概念(而非功能列表)+ 真實的介面或產品作為主角 + 動態字體排版 + 永遠不靜止的鏡頭 + 每個元素在旁白提到時恰好出現 + 品牌色彩的高潮 + 乾淨的結尾(Logo 與標語)。
一切皆為程式碼:每個影格都是一個網頁的狀態。一條暫停的 GSAP 時間軸在無頭 Chrome 中逐格播放,然後由 ffmpeg 組裝成 MP4 影片,包含動態模糊、光暈與底片顆粒。引擎已建置完成並在 plantilla/motor/ 中測試過,並附有完整的範例廣告在 plantilla/escenas.js。
如果使用者提供參考影片(「做一個一樣的」)
- 在設計前先拆解參考影片:以良好尺寸從關鍵片段每秒提取 8 到 12 個影格(使用 Read 做成聯絡表),並註記每個元素:出現的真實 UI 是什麼、使用了什麼字體、什麼顏色、如何進出畫面(拉伸、模糊、翻轉)。
- 複製其結構與真實元素,而非「通用的替代品」:如果原始影片使用 iMessage 的對話泡泡,請使用
-apple-system(系統 SF 字體)與帶尾巴的泡泡;如果使用 Spotify 的歌詞卡,請複製其標籤、按鈕與顏色;如果使用巨大的單詞,請使用 Arial Black(macOS 內建)。 - 字體排版:永遠不要用預設的。 使用者已多次拒絕 Claude 的預設字體(緊湊的黑色無襯線字體、過大的負字距、Inter、斜體襯線字體)。請使用品牌實際的靜態字體(例如
SocialMedia/fuentes/中的MonaSans-Black/Bold/Regular.ttf,與插圖影片相同),設定正常字距(最多 -0.01em);若有參考影片則使用其字體;或是在渲染前詢問/展示 3 種測試選項。永遠不要使用中等字重的可變字體搭配緊湊字距。 3b. 預設禁止「Claude 風格」:只有當參考影片或品牌使用 Inter/Anton/斜體襯線字體/HUD 等寬字體時,才能使用它們。若有參考影片,字體與元素必須與之一致。 - 要求提供真實截圖,針對無法忠實重現的內容(應用程式、播放器、封面):使用者會將檔案放入
activos/。Spotify 與其他應用程式可能因政策而封鎖操作:不要繞過封鎖,而是要求截圖或使用公開圖片並告知使用者。 - 展示一份你的版本與參考影片並列的截圖,並在交付前修正差異。
- 閱讀
references/referencia-fiel.md:完整流程、每個元素的配方(Apple Messages 對話泡泡、Spotify 歌詞卡、SVG 控制項、滑動陰影)以及已花費多輪修改的錯誤。現成可用的元件在motor/ui.js與motor/ui.css中;完整範例在ejemplos/video-con-letra/。
開始之前
你需要知道以下資訊,如果不清楚,請在一次訊息中詢問,並提出預設值建議:
- 要宣傳什麼以及受眾是誰(一句話)。
- 真實素材:Logo(最好是 SVG)、應用程式或網站的截圖、產品照片、顏色。網站也可以。沒有真實素材,品牌看起來就會很一般:務必要求提供。如果沒有,就設計一個範例品牌識別並告知使用者。
- 格式與長度:預設為 9:16 與 15 到 20 秒。16:9 用於網頁或 YouTube。
- 旁白:ElevenLabs(最終版)、
say(草稿版)或無旁白。 - 音樂:由引擎創作或使用使用者自己的音軌(建議用於發佈)。
如果使用者帶來完整的專案文件(references/encargo.md)或說「你自己決定」,不要問:直接製作,並在 DECISIONES.md 中解釋。
流程
1. 專案
bash ~/.claude/skills/motion-spot/scripts/nuevo.sh <廣告資料夾> # 以「Turnito」範例為參考
bash ~/.claude/skills/motion-spot/scripts/nuevo.sh <廣告資料夾> --limpio # 空白骨架
複製模板、安裝相依套件(約 10 秒),並檢查 Chrome 是否可用。將使用者的素材複製到 activos/。
2. 概念與原型
閱讀 references/arquetipos.md 並選擇一個(再借用一個鏡頭來製造「哇」的時刻)。撰寫:
- 一句話的概念,包含其張力:「星期六的混亂與 3 次點擊預訂的寧靜之間的對比」。
- 品牌洞察:一個只有該品牌才有的獨特細節(Amazon 的箭頭連接 A 到 Z、Nike 的勾勾劃過螢幕)。如果沒有,廣告就會顯得很一般。
3. 旁白腳本 → guion.json
閱讀 references/voz-y-musica.md。旁白的撰寫必須在動畫之前,因為它決定了所有時間點。每個場景一句話,2 到 8 個字,包含重音與開頭標點符號。情境鉤子(「凌晨 2 點…」)、行動、好處、高潮與品牌 + 標語。撰寫 guion.json,包含場景、BPM、音樂風格、pico 場景與特效。
4. 鏡頭分鏡表
一個表格,每個場景一行:時間 · 旁白 · 主角 · 鏡頭 · 動態圖像技巧(3 個以上,來自 references/lenguaje.md) · 轉場效果。規則:
- 每個鏡頭三層:動態背景 + 主角 + 細節。
- 鏡頭必須始終移動。使用動態圖像轉場(在節拍上剪切、穿越變焦、簾幕、光圈、推鏡),而非淡入淡出。
- 在約 70% 的時間點,使用品牌色彩或 3D 達到高潮。
- 整支廣告至少使用 8 種不同的技巧。
如果廣告很長或成本較高,請在開始建構前向使用者展示分鏡表。如果使用者說「做吧」,就繼續。
5. 視覺系統 → estilo.css
閱讀 references/diseno.md。定義變數(--fondo、--tinta、--acento、--acento2…)以及使用自訂前綴(.ui ...)的 UI 重現類別。字體排版:緊湊的黑色無襯線字體 + 一個斜體襯線字體的單詞 + 用於 HUD 的等寬字體(已安裝:Inter、Instrument Serif、JetBrains Mono 與 Anton)。
6. 旁白與時間點
- ElevenLabs:每個場景生成一次 →
audio/voz/<id>.mp3→node motor/preparar.mjs --recortar。 - 草稿:
node motor/preparar.mjs --borrador-voz。 - 然後執行
node motor/preparar.mjs:測量旁白長度、將剪切點量化到節拍、並寫入guion.tiempos.json,其中包含每個單詞的預估時間。
7. 逐場景建構 → escenas.js
閱讀 references/motor.md(API、配方與已知陷阱)。每個場景:
spot.escena('id', (capa, c) => { ... })包含其三層結構、鏡頭飄移與技巧。- 與旁白同步:
spot.cuando('id', 'palabra')。 - 執行
node motor/render.mjs --fotos <起始+0.1>,<中間>,<結束-0.1>並查看產出的聯絡表(salida/fotos/hoja.jpg)。在繼續前修正問題。
使用 plantilla/escenas.js(Turnito)作為品質標竿:如何處理遮擋、軌道、時鐘轉盤、通知、體素 3D、簾幕與穿越變焦。
8. 音樂與混音
node motor/musica.mjs # 根據 BPM 創作音樂,在「pico」場景有高潮;或使用 guion.json 中的自訂音軌
node motor/mezcla.mjs # 旁白 + 音樂(含閃避效果)+ 特效,達到 -14 LUFS
使用 node motor/servir.mjs,使用者可以預覽包含音訊的廣告並進行瀏覽。
9. 渲染、審查與打磨
node motor/render.mjs --fotos # 12 張影格的聯絡表:檢查構圖、拼寫與安全區域
node motor/render.mjs --subida # 最終版:30 fps、4 倍模糊、後製、以及小於 10 MB 的上傳版本(每 20 秒約 2 到 3 分鐘)
檢查 references/calidad.md 中的清單(三輪檢查)。然後進行一輪專門的打磨:次要的微動畫、重音節拍上的強調、每個場景的第一與最後影格。第二輪打磨是區分好與卓越的關鍵。
10. 交付
salida/spot.mp4與salida/spot-subida.mp4。- 封面:選取最吸睛的時刻,而非第一個影格。
DECISIONES.md:概念、原型、決定、捨棄的內容、迭代次數與時間(模板在calidad.md中)。- 在對話中提供:檔案路徑、哪些是草稿(
say旁白、合成音樂)以及 2 到 3 個具體的改進建議。
不可違反的規則
- 所有元素都是時間
t的函數。 廣告中禁止使用Math.random、Date.now、CSS 動畫、setTimeout或requestAnimationFrame。隨機性請使用ruido(i)或azar(semilla)。 - 絕對不要將
transform放在 GSAP 會動畫化的 CSS 中(改用xPercent/yPercent)。這是元素錯位的第一大原因。 - 在繼續前必須查看每個場景的影格。 未經檢視的內容不得交付。
- 使用真實素材,否則必須註明為範例。 介面必須根據截圖忠實重現,不得發明「通用」版本。
- 第三方品牌: 為非使用者所有的真實品牌製作廣告,僅作為作品集練習(「spec」廣告)。不得宣稱其為官方廣告、不得暗示與該品牌有關聯、且其 Logo 不得變形。
- 資料: 必須使用使用者的資料,或標示為僅供示意。
- 我無法聆聽。 我會檢查音量(峰值在 -1 到 -2 dB 之間,-14 LUFS)並確保旁白聲音高於音樂;由使用者用耳朵判斷。
- 上下文: 一支廣告會消耗較多上下文。如果會話超出 40% 的上下文限制,請在繼續建構前先壓縮。
- 歌詞: Claude 不得在任何地方(程式碼、
letra.json、對話)撰寫歌詞,即使由使用者提供。對於含歌詞的影片:letra.json中時間點保持文字空白,廣告本身需在無歌詞狀態下也能運作,使用中性句子在測試副本中驗證,然後使用者貼上歌詞並執行最終渲染。詳情請見references/motor.md→「letra.json」。
音樂影片與使用背景影片的影片
node motor/extraer.mjs <video> --desde S --hasta S 會提取指定時間範圍的影格(activos/clip/)與音訊;videoCuadros(...) 可同步顯示這些影格;motor/letra.js 根據 letra.json 製作卡拉 OK 效果。原型 9 請見 references/arquetipos.md。
如果發生問題
| 徵狀 | 可能原因 |
|---|---|
window.spot.listo 永遠不是 true | escenas.js 中的 JS 錯誤:渲染器會輸出頁面錯誤。檢查 import 以及是否已執行 await spot.terminar() |
| 元素顯示偏移或跳動 | CSS 中包含 transform 再加上 GSAP;或類別與其他類別衝突(例如 .app);或後代選擇器範圍過大 |
| 場景顯示為全白或全黑 | 該 id 不在腳本中(請執行 preparar.mjs),或轉場效果將圖層設為 opacity: 0 |
| 3D 效果看起來平面 | 中間容器缺少 transform-style: preserve-3d,或中間有 overflow 或 filter |
| 旁白與畫面不同步 | 調整 spot.cuando(...) 中的時間 ± 0.1 秒;在 servir.mjs 中搭配音訊檢查 |
| 渲染時間過長 | 草稿階段使用 --blur 1 --escala 0.5;減少陰影或模糊節點;降低 voxelOla 或 particulas 中的 n 值 |
| MP4 檔案過大 | 原因是底片顆粒:使用 --grano 3 或 --crf 22;要上傳時使用 --subida |