Communitygithub.com

motion-spot

製作媲美專業工作室等級的動態圖像廣告(產品廣告、應用程式廣告、spec廣告、新品發表、品牌片頭、展示影片),完全使用程式碼打造。採用 HTML、GSAP、CSS 3D 與 Three.js,以逐格渲染方式呈現真實動態模糊、配上旁白與自訂或原創音樂。當有人要求「幫我做一支廣告」、「動畫廣告」、「動態圖像」、「我的 App 或品牌的商業影片」、「Apple、Nike、Spotify 或 Google Maps 風格的影片」、「產品宣傳片」、「itskeo 風格的影片」、「讓我的品牌動起來」、「展示影片」或「從這個網站做一支影片」,或需要將某個產品轉化為 10 到 45 秒的精緻影片時,即可使用此技能。

motion-spot 是什麼?

motion-spot 是一個強大的 AI 技能,專為製作高品質、電影級動態圖像廣告(spots)而設計,完全透過程式碼實現。它從分析數十個觀看次數達數百萬的 Claude 生成影片中提煉出「秘方」:一個帶有張力的概念(而非功能列表)+真實的介面或產品作為主角+動態字體排版+永遠不靜止的鏡頭+每個元素在旁白提到時恰好出現+品牌色彩的高潮+乾淨的結尾(Logo 與標語)。支援的主要平台包括 Claude Code、Cursor 與 Codex。 此技能的核心是一套完整的渲染引擎,位於 `plantilla/motor/` 目錄中。它將每個影格視為網頁的一個狀態:一條暫停的 GSAP 時間軸在無頭 Chrome 中逐格播放,並由 ffmpeg 組裝成 MP4 影片,包含真實動態模糊、光暈與底片顆粒。使用者只需提供專案名稱和可選的原始素材資料夾,或透過 `--limpio` 標記從空骨架開始。 工作流程從「專案建立」腳本開始,接著撰寫旁白腳本(`guion.json`),規劃每個鏡頭的畫面分鏡(包含三層結構:動態背景、主要元素、細部點綴),設計視覺系統(`estilo.css`,避免 Claude 預設的「Inter/Anton 字體」外觀),然後逐場景建構動畫(`escenas.js`)。最後進行音樂合成與音訊混合(可達 -14 LUFS 廣播標準),以及最終渲染(支援 `--subida` 參數產生小於 10MB 的上傳版本)。 此技能強制執行多項嚴格規則:禁止使用 `Math.random`、`Date.now`、CSS 動畫或 `requestAnimationFrame`;所有元素必須是時間函數;必須真實複製第三方介面(如 iMessage 對話泡泡、Spotify 歌詞卡片),不可使用「通用」替代品;並且音樂歌詞必須由使用者手動嵌入,以避免版權問題。它還包含失敗排查指南與效能最佳化技巧(例如在草稿階段使用 `--blur 1 --escala 0.5` 以節省時間)。

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

在你喜歡的 AI 中提問

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

說明文件

motion-spot 是做什麼的?

製作出媲美工作室等級的廣告,運用的是從分析 45 支 Claude 製作的廣告(觀看次數達數百萬)中提煉出的方法(詳見 references/estudio.md)。所有成功廣告的共同配方是:

一個帶有張力的概念(而非功能列表)+ 真實的介面或產品作為主角 + 動態字體排版 + 永遠不靜止的鏡頭 + 每個元素在旁白提到時恰好出現 + 品牌色彩的高潮 + 乾淨的結尾(Logo 與標語)。

一切皆為程式碼:每個影格都是一個網頁的狀態。一條暫停的 GSAP 時間軸在無頭 Chrome 中逐格播放,然後由 ffmpeg 組裝成 MP4 影片,包含動態模糊、光暈與底片顆粒。引擎已建置完成並在 plantilla/motor/ 中測試過,並附有完整的範例廣告在 plantilla/escenas.js。

如果使用者提供參考影片(「做一個一樣的」)

  1. 在設計前先拆解參考影片:以良好尺寸從關鍵片段每秒提取 8 到 12 個影格(使用 Read 做成聯絡表),並註記每個元素:出現的真實 UI 是什麼、使用了什麼字體、什麼顏色、如何進出畫面(拉伸、模糊、翻轉)。
  2. 複製其結構與真實元素,而非「通用的替代品」:如果原始影片使用 iMessage 的對話泡泡,請使用 -apple-system(系統 SF 字體)與帶尾巴的泡泡;如果使用 Spotify 的歌詞卡,請複製其標籤、按鈕與顏色;如果使用巨大的單詞,請使用 Arial Black(macOS 內建)。
  3. 字體排版:永遠不要用預設的。 使用者已多次拒絕 Claude 的預設字體(緊湊的黑色無襯線字體、過大的負字距、Inter、斜體襯線字體)。請使用品牌實際的靜態字體(例如 SocialMedia/fuentes/ 中的 MonaSans-Black/Bold/Regular.ttf,與插圖影片相同),設定正常字距(最多 -0.01em);若有參考影片則使用其字體;或是在渲染前詢問/展示 3 種測試選項。永遠不要使用中等字重的可變字體搭配緊湊字距。 3b. 預設禁止「Claude 風格」:只有當參考影片或品牌使用 Inter/Anton/斜體襯線字體/HUD 等寬字體時,才能使用它們。若有參考影片,字體與元素必須與之一致。
  4. 要求提供真實截圖,針對無法忠實重現的內容(應用程式、播放器、封面):使用者會將檔案放入 activos/。Spotify 與其他應用程式可能因政策而封鎖操作:不要繞過封鎖,而是要求截圖或使用公開圖片並告知使用者。
  5. 展示一份你的版本與參考影片並列的截圖,並在交付前修正差異。
  6. 閱讀 references/referencia-fiel.md:完整流程、每個元素的配方(Apple Messages 對話泡泡、Spotify 歌詞卡、SVG 控制項、滑動陰影)以及已花費多輪修改的錯誤。現成可用的元件在 motor/ui.js 與 motor/ui.css 中;完整範例在 ejemplos/video-con-letra/。

開始之前

你需要知道以下資訊,如果不清楚,請在一次訊息中詢問,並提出預設值建議:

  1. 要宣傳什麼以及受眾是誰(一句話)。
  2. 真實素材:Logo(最好是 SVG)、應用程式或網站的截圖、產品照片、顏色。網站也可以。沒有真實素材,品牌看起來就會很一般:務必要求提供。如果沒有,就設計一個範例品牌識別並告知使用者。
  3. 格式與長度:預設為 9:16 與 15 到 20 秒。16:9 用於網頁或 YouTube。
  4. 旁白:ElevenLabs(最終版)、say(草稿版)或無旁白。
  5. 音樂:由引擎創作或使用使用者自己的音軌(建議用於發佈)。

如果使用者帶來完整的專案文件(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、配方與已知陷阱)。每個場景:

  1. spot.escena('id', (capa, c) => { ... }) 包含其三層結構、鏡頭飄移與技巧。
  2. 與旁白同步:spot.cuando('id', 'palabra')。
  3. 執行 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 個具體的改進建議。

不可違反的規則

  1. 所有元素都是時間 t 的函數。 廣告中禁止使用 Math.random、Date.now、CSS 動畫、setTimeout 或 requestAnimationFrame。隨機性請使用 ruido(i) 或 azar(semilla)。
  2. 絕對不要將 transform 放在 GSAP 會動畫化的 CSS 中(改用 xPercent/yPercent)。這是元素錯位的第一大原因。
  3. 在繼續前必須查看每個場景的影格。 未經檢視的內容不得交付。
  4. 使用真實素材,否則必須註明為範例。 介面必須根據截圖忠實重現,不得發明「通用」版本。
  5. 第三方品牌: 為非使用者所有的真實品牌製作廣告,僅作為作品集練習(「spec」廣告)。不得宣稱其為官方廣告、不得暗示與該品牌有關聯、且其 Logo 不得變形。
  6. 資料: 必須使用使用者的資料,或標示為僅供示意。
  7. 我無法聆聽。 我會檢查音量(峰值在 -1 到 -2 dB 之間,-14 LUFS)並確保旁白聲音高於音樂;由使用者用耳朵判斷。
  8. 上下文: 一支廣告會消耗較多上下文。如果會話超出 40% 的上下文限制,請在繼續建構前先壓縮。
  9. 歌詞: 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 永遠不是 trueescenas.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

相關技能