Communitygithub.com

Motion 程式碼動畫

用 HTML/Canvas 編寫動畫,逐幀渲染為 MP4 — 支援 9:16 Reel、16:9 影片、短廣告、片頭、Landing Page 動畫。使用 Playwright + ffmpeg 渲染,並提供幀圖表供校對。

Motion 程式碼動畫 是什麼?

這是一個專業的動態圖形技能,專為開發者與 AI 代理設計,透過純程式碼生成精準的 MP4 動畫。其核心概念是「影片來自程式碼」:使用者編寫一個以單一時鐘 `t` 為基礎的繪圖程式,逐幀渲染後組合成影片。這確保了顏色(Hex)、字型、數字完全精確,且任何調整(如速度 30% 或比例 9:16)僅需修改一行程式碼,無需重新製作。 此技能支援所有主流平台格式(9:16 限時動態、4:5 貼文、16:9 展示、LP 循環 HTML),並內建完整的製作流程:從品牌素材庫建立、腳本審核(附時間與拍點對齊)、程式碼建構(嚴格遵守函數式時鐘、固定隨機種子、安全區域等法則),到自動渲染、校對表生成與最終交付。它還提供詳細的故障排除指南,涵蓋機械動作、字型錯誤、裁切問題等常見症狀。 此技能特別適合需要品牌一致性、精確時長和可重複迭代的動畫製作,尤其適用於 Reels、廣告、片頭等場景。它不適用於真人拍攝、照片級寫實渲染或基於圖片的 AI 影片生成。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/arthurmkt/arthur-portfolio-mkt/tree/main/design/motion

在你喜歡的 AI 中提問

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

說明文件

Motion 程式碼動畫 是做什麼的?

影片即程式碼。 我撰寫一個程式,以單一時鐘 t 繪製每一幀,逐幀渲染後組合成 MP4。因此,Hex 顏色、品牌字型與數字都能完全精確:它們是寫出來的,而非由生成器解讀的。因此,要求「放慢 30%」或「改為 9:16」只須修改一行,無須重做整支影片。

不適用範圍: 拍攝人物、地點或產品;從零產生照片級寫實圖像;猜測品牌。品牌的真實照片、影片與畫面須以檔案形式提供,程式碼則動畫化所提供的內容。

真實影片基底須以幀序列方式導入,絕不使用 <video>:ffmpeg -i base.mp4 -q:v 3 frames/f%04d.jpg,並在 draw 中使用 floor(t × fps) + 1 的幀圖像,按需載入。使用 <video> 會導致渲染伺服器無法處理 Range 請求(無法跳轉),且媒體連線永不關閉(networkidle 會逾時)。

需求: Python 3.10+,pip install playwright + playwright install chromium(腳本使用 chrome 頻道;若未安裝 Chrome,請在 abrir() 中切換為預設 Chromium),與 PATH 中的 ffmpeg 及 ffprobe。

此技能的檔案:

  • assets/template.html:引擎,包含單一時鐘、固定隨機種子、Easing、Stagger、播放器(含時間軸與場景名稱)及安全區域。
  • scripts/render.py:逐幀渲染 MP4、短版片段及校對表。
  • tecnicas.md:7 大類共 39 種技術,包含各技術的參數與依目標的組合方式。
  • exemplos/reel-resultado-8s.html:8 秒成品範例(數字亂序 → 長條圖 → 含彩花的 CTA),附範例資料。

工作目錄:每個影片獨立資料夾(例如 motion/<品牌>/<影片>/)。HTML、素材(Logo、照片、字型)、MP4 與校對表皆存放於此。


步驟 0 — 品牌素材包

每個品牌只需建立一次,依據手冊、官網或委託人提供的資料:

項目如何導入
色板Hex 與用途:背景、文字、強調色、數字色。3 到 4 種顏色;7 種顏色代表顏色過多、對比不足
字型確切名稱。Google Fonts → <link>;自有字型 → 資料夾中的 檔案 + @font-face
Logo檔案(SVG 或透明 PNG)。絕不從零繪製 Logo 或以文字描述:若無檔案,則要求提供
動態風格2 到 3 個形容詞(平靜、活力、高級、大眾)→ 定義 Easing 與剪輯點
數字真實數字,包含小數點與字型。未確認的數字 → 我會要求提供,否則螢幕上會標示 「範例資料」
優惠、CTA、@/網站來自簡報。僅在有實際截止日期時才加入急迫感
配樂品牌授權檔案或圖庫音樂 + BPM 與 Drop 秒數

將素材包儲存為品牌資料夾中的 motion.md。從第二支影片開始,直接讀取,無須重建。

步驟 1 — 篩選:6 個元件

清單重印,每次只問一個問題,已填項目不再重開,且簡報已回答的項目直接預填。若缺少某個元件,我將自行決定,且通常與您的預期不同。

1. 格式 — 比例 + 解析度 + 長度 + fps
2. 場景 — 出現什麼、順序、每段秒數
3. 文字 — 確切句子,用引號標示(封閉清單,逐字精確)
4. 技術 — 依名稱(tecnicas.md)
5. 節奏與音效 — Easing、Stagger、BPM / 配樂
6. 交付 — MP4 · 6 秒短版 · 校對用播放器 · LP 循環 HTML · 透明背景

依平台的格式:

比例解析度適用平台典型長度
9:161080×1920Reels、Stories、TikTok、Shorts8–15 秒,第 1 幀即鉤子
4:51080×1350IG/FB 動態6–15 秒
1:11080×1080動態、部分廣告版位6–15 秒
16:91920×1080YouTube、簡報、大螢幕、網站5 秒(片頭)至長篇解說
LP頁面寬度(例如 1440)首屏與區塊5–10 秒輕量循環,以 HTML 交付

30 fps 幾乎涵蓋所有情況。60 fps 僅用於縮放、快速粒子與攝影機運動。廣告影片:務必準備一個 6 秒版本,維持相同簽名,供 A/B 測試。

步驟 2 — 含時間軸的腳本(閘門)

在撰寫程式碼之前,先展示腳本並 等待核准:

格式:9:16 · 1080×1920 · 15 秒 · 30 fps · 配樂 120 BPM(剪輯點在 3 / 7 / 11 秒)
品牌包:背景 #050505 · 強調色 #E50914 · 數字色 #FFDD00 · Morganite / IBM Plex Sans · logo.svg

| 場景 | 時間 | 技術 | 發生什麼事 | 文字(逐字) | 入場 / 出場 |

腳本規則:

  • 每個場景一個想法。 若場景需要兩句話,那就是兩個場景。
  • 每個場景 2 到 4 秒。 少於 2 秒,文字來不及閱讀。
  • 閱讀時間: 每 3 個字 1 秒 + 1 秒緩衝。單一數字:1.5 秒 · 3 個字:2 秒 · 6 個字:3 秒 · 9 個字:4 秒。需要超過 4 秒的句子對一個場景來說太長:應拆分或刪減字詞(刪減已核准的文案字詞是核准者的決定)。
  • 說明如何入場與出場。 出場方式連接下一場景。
  • 前 3 秒為鉤子(9:16 與 4:5)。主要訊息絕不放在結尾。
  • 在拍點上剪輯: 拍點 = 60 ÷ BPM 秒;小節 = 4 拍。場景長度為小節的倍數時,剪輯最流暢(120 BPM:拍點 0.5 秒,小節 2 秒 · 128:0.47 / 1.88 · 100:0.6 / 2.4 · 90:0.67 / 2.67)。

步驟 3 — 建構

將 assets/template.html 複製到工作目錄,並填入 CFG、BRAND 與 SCENES。程式碼法則,因為它們決定了 MP4 是否與播放器中核准的內容一致:

  1. 一切都是 t 的函數。 不使用 setTimeout、Date.now()、CSS transition/animation 或幀之間的累積狀態。1.4 秒時的第 3 個字母永遠在同一個位置。
  2. 固定隨機種子(rng(CFG.SEED + i))應用於所有隨機數值。沒有固定種子,匯出結果會與核准內容不同。
  3. 模擬(物理、Boids、布料):使用 t 的解析公式,或載入時以固定步長(1/240 秒)預先計算,按幀儲存並以索引讀取。絕不在 draw 內部進行積分。
  4. 字型放在 CFG.FONTS,素材放在 CFG.ASSETS:引擎會在第一幀之前等待載入完成。未載入的字型會無警告地回退為通用字型,這是最常見的錯誤。
  5. 9:16 的安全區域: 文字、數字與 Logo 應位於離頂部 250 px、離底部 350 px、離右側 120 px、離左側 60 px 的範圍內(近似值,依應用程式而異)。
  6. Easing 需有明確意圖: inOut 為預設;back(overshoot)用於文字、圖釘與數字的入場;linear 僅用於連續旋轉與滾動;bounce 僅用於落下的物體。字母間的 Stagger 為 0.07 秒,卡片間為 0.15 秒。
  7. 層級: 主要數字應是場景中最大的元素。
  8. 每個場景頂部附上時間與技術的註解。

長片或技術密集(Shader、模擬):一次製作一個場景。建構、校對並核准該場景後,再合併。短片(約 15 秒以內,4 個輕量場景)可一次完成,但校對仍需逐場景進行。

步驟 4 — 展示前校對

python ~/.claude/skills/motion/scripts/render.py peca.html --sheet auto --safe

產生包含每個場景中間與結尾幀的校對表,並繪製安全區域。使用 VER → 放大 → 確認 方法閱讀校對表(對小文字、數字與 Logo 進行放大裁剪),並通過 6 個層級:

層級檢查項目
1. 技術長度、解析度與 fps 符合要求;開頭與結尾無黑幀
2. 品牌Hex 顏色正確;品牌字型已載入,非通用字型;Logo 無變形、旋轉或顏色錯誤;動態風格相符
3. 可讀性每個場景一個想法;每個文字停留時間符合規則;文字與背景對比度足夠;主要數字為最大元素
4. 平台比例正確;無元素超出安全區域;前 3 秒為鉤子;無聲時仍可理解
5. 數據數字與提供的一致,無四捨五入;包含小數點與字型;範例數據在螢幕上標示;無任何虛構數字
6. 版權配樂已授權、為品牌自有或生成;照片與畫面已獲得授權;第三方品牌僅在許可下使用;優惠承諾已驗證

若要檢查特定時間點:--sheet 1.5,2.9,3.1。發現問題我會在展示前自行修正。

素材的第三次觀看,應在手機上、關閉音效進行,這是核准者的責任。 我檢查的是幀,而非影片播放時的整體感受。交付時,請明確要求核准者進行此步驟。

步驟 5 — 渲染與交付

python ~/.claude/skills/motion/scripts/render.py peca.html                                   # 完整 MP4
python ~/.claude/skills/motion/scripts/render.py peca.html --segments 0-3,11-15 -o peca_6s.mp4   # 短版
python ~/.claude/skills/motion/scripts/render.py peca.html --audio trilha.mp3                # 含配樂

渲染後:使用 ffprobe 確認解析度、fps、幀數與長度。交付:

  • MP4(H.264、yuv420p、+faststart),可直接上傳;
  • 6 秒版本(若為廣告);
  • 含播放器的 HTML(可在瀏覽器中開啟:播放、暫停、時間軸、場景名稱、安全區域)。核准者藉此指出需要調整的準確秒數。

LP:交付的是循環播放的 HTML 本身,而非 MP4。輕量優先:不得拖慢頁面。

配樂: 此技能可混入音檔(--audio),並將剪輯點對齊所指定的 BPM。以程式碼生成配樂尚未實作;若有人要求,請直接說明,而非臨時湊合。未經授權的第三方音樂會導致廣告被下架:絕不使用。

步驟 6 — 調整

第一版為草稿。好的調整應指出 場景或秒數、說明 調整幅度,並指定 保留部分:「在場景 1(0–3 秒),將 +248% 停留 1.5 秒後再切換。其餘部分不變。」我只修改受影響的部分並重新渲染。

症狀可能原因修正方式
動作機械化Easing 為 Linear使用 inOut,入場用 back
所有元素同時進入無 Stagger字母間 0.07 秒,卡片間 0.15 秒
字型與品牌不同字型未載入檢查 CFG.FONTS / @font-face 與資料夾中的檔案
文字在 9:16 中被裁切佈局以 16:9 為設計在 1080×1920 網格中重新製作,並遵守安全區域
播放器卡頓粒子或 Shader 過多播放器中減少元素,僅在渲染時使用完整數量
匯出結果與播放器不同無固定種子的隨機或累積狀態步驟 3 的法則 1 至 3
剪輯點不在拍子上場景長度與 BPM 無關將長度設為拍點的倍數
數字錯誤數據未提供嚴格使用提供的清單,不進行四捨五入

發佈後: 若留存率下降發生在前 3 秒,僅更換場景 1;若發生在中間某場景,縮短或僅更換該場景;若點擊率未提升,測試不同的結尾方式(彩花、旋轉印章、QR Code),其餘保持不變。一次只改變一個變數。

帳戶素材庫

影片核准後 → 在品牌的 motion.md 中記錄:已核准的腳本、使用的技術、HTML 路徑,以及(若有的話)前 7 天的數據。下一支影片將從已驗證效能的內容開始,且品牌的標準結尾(最終簽名含 Logo 與 CTA)將重複使用,無須重新製作。

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

相關技能