Communitygithub.com

cskwork/motion-graphics-skill

製作由程式驅動、逐幀精確且可重現的動態圖形影片。支援產品發表會、功能公告影片(Apple/Google keynote 風格,SaaS 在 X 上發布),以及 YouTube Shorts、Reels 或 TikTok 的垂直短片(鉤子開場、可循環)。

motion-graphics-skill 是什麼?

此技能將影片製作轉化為程式設計任務。它會建立一個 HTML 頁面,頁面中的每個像素都是時間 `t` 的純函數,然後在無頭 Chromium 中逐幀渲染,最後使用 ffmpeg 進行編碼。它遵循類似高階動態設計師作品集的標準,而非簡報幻燈片。支援的輸出格式包括標準的產品發表影片和垂直短片,每種格式都有對應的結構和內容指引。此技能會建立一個結構化的工作資料夾,其中包含簡報、節拍表、素材清單和引擎設定。核心是 `motion.html` 檔案,它利用 JavaScript 輔助函式庫 `MG.*` 來定義場景、補間動畫和互動效果。這個工作流程強調可重現性(透過確定性函式)、逐幀精確度(使用函數 `t`)以及符合業界標準的輸出(例如 -14 LUFS 音訊、符合格式檢查)。它整合了版本控制的資產管理、自動化渲染流程和嚴格的品質保證檢查,確保最終輸出是可直接發布的影片檔案。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/cskwork/motion-graphics-skill/tree/HEAD/skills/motion-graphics

在你喜歡的 AI 中提問

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

說明文件

motion-graphics

一支影片就是一個 HTML 頁面,其每一個像素都是時間 t 的純函數,在無頭 Chromium 中逐幀渲染,並用 ffmpeg 編碼。目標是達到資深動態設計師的專業水準,絕非幻燈片簡報。

1. 選擇格式

需求請閱讀
為實際產品製作發布、宣傳、商業廣告、功能集錦、應用程式預告formats/launch-video.md
短片、Reels、TikTok、垂直解說或故事formats/shorts.md

依照格式檔案來獲取簡報、內容步驟和節拍結構。完成後會回到此處進行建置。在開始撰寫腳本之前,也請閱讀 references/pitfalls.md。

每次運行都是全新概念。 每支影片都應有其獨特的構想、腳本和外觀。當使用者要求不要參考過去作品時,請保持工作區中之前的影片和腳本檔案未被開啟。

2. 工作資料夾

在使用者指定的位置(預設為當前目錄)建立 <slug>-<YYYYMMDD>/ 資料夾:

brief.md         從格式檔案簡報表取得的參數
beats.md         節拍表(時間、文案、素材、動作、轉場、重音提示)
assets/          螢幕錄製、圖片、字型、音訊
assets/manifest.md  每行一個素材檔案:來源、授權或「從 <畫面> 擷取」、內容說明
motion.html      腳本檔案
motion.json      {"size": [W, H], "fps": 60, "duration": 30, "stills": [節拍時間點], "captions": []}
engine/          從此技能的 engine/ 複製而來
out/             靜止圖格、渲染成果、連絡表

每個資料夾只需設定一次引擎:

cp -R <this-skill>/engine engine && (cd engine && npm install && npx playwright install chromium)

3. 編排

motion.html 會載入 engine/runtime.css 和 engine/runtime.js,建立其 DOM、註冊場景,然後呼叫 MG.ready()。

輔助函式用途
MG.scene(start, end, fn, el)fn(local, t, dur) 在 start <= t < end 期間執行;el 在此區間外隱藏。每次呼叫都需設定所有會動的屬性。
MG.always(fn)每一幀都執行:背景、噪點、進度條。
MG.prog(t, a, b, ease)0..1 之間的緩動進度。緩動函式:MG.ease.*(linear, in/out/inOut Quad, Cubic, Quart, Expo, inBack, outBack, outElastic, outBounce)或任何自訂函式。
MG.tween(t, [[t0, v0], [t1, v1, ease], …])關鍵影格;數值可以是陣列。
MG.spring(t, {stiffness, damping})物理模擬的 0 → 1 回彈效果,含 overshoot。
`MG.split(el, "grapheme""word")`
MG.set(el, {x, y, s, sx, sy, r, o, blur, ...css})每幀對每個元素呼叫一次。
MG.clip(videoEl, start, rate)從 start 開始,逐幀精確播放螢幕錄製。
MG.rng(seed), MG.noise(x, seed)確定性亂數和波動。
MG.fmt(n, {decimals})數字格式化,用於計數器。
MG.captions()在底部 UI 區塊上方繪製 motion.json 中的字幕。

確定性:渲染邏輯中不得使用 Date、performance.now()、requestAnimationFrame 或 Math.random。允許使用 CSS @keyframes;運行時會在時間 t 將其暫停,因此請使用 animation-delay 來設定時間。僅使用素材清單中列出的字型和圖片。

預覽某一幀:open "motion.html?w=1920&h=1080&t=3.2&guides=1"(guides 會顯示安全區域)。即時預覽:?play=1。字幕僅在渲染時顯示。

4. 工藝標準

  • 第 0 幀已處於動作中。 沒有從黑畫面淡入,沒有 logo 開場。
  • 每 0.8–2 秒內有有意義的變化:佈局、縮放、顏色、數字或鏡頭。
  • 入場使用 spring 或 ease-out-expo,並帶有輕微 overshoot;使用 30–60 毫秒的錯開時間;僅計數器使用線性動畫。
  • 僅在快速移動時使用動態模糊;靜止畫面上緩慢推近(縮放 1 → 1.04);在 2–3 個深度層之間創造視差。
  • 一種背景系列、一種文字顏色、一種強調色。添加顆粒或漸層噪點,以免大片純色在上傳後出現色塊。
  • 文案停留在畫面上的時間足夠閱讀兩次;關鍵文字保持在安全區域內。
  • 節拍要與聲音同步:每次變化都伴隨一聲嗖聲、撞擊聲或音樂節拍。

5. 渲染

node engine/render.mjs --html motion.html --config motion.json --stills <t1,t2,...> --stills-dir out/stills
node engine/render.mjs --html motion.html --config motion.json --out out/video.mp4 --workers 4

先用靜止圖格確認佈局:每個節拍一張、每個補間動畫內部一張、每個 spring 的 overshoot 峰值一張。一次只運行一個完整渲染作業(25 秒、1080p60、4 個 worker 約需 10 分鐘)。

6. 音訊

僅使用素材清單中明確列出、授權允許使用,或使用者提供的音樂和音效。若無,則輸出無聲影片並明確說明。混合音軌後進行封裝:

ffmpeg -i music.wav -i whoosh.wav -filter_complex \
  "[0]volume=-16dB[m];[1]adelay=1200|1200,volume=-8dB[a];[m][a]amix=inputs=2:normalize=0[out]" -map "[out]" out/mix.wav
ffmpeg -i out/video.mp4 -i out/mix.wav -map 0:v -map 1:a -c:v copy \
  -af "loudnorm=I=-14:TP=-1.5:LRA=11" -c:a aac -b:a 256k -shortest -movflags +faststart out/final.mp4
ffmpeg -i out/final.mp4 -af ebur128=peak=true -f null - 2>&1 | grep -E "^ +(I|Peak):"

目標:綜合響度約 −14 LUFS,真實峰值低於或等於 −1 dBFS。音效約 −6 至 −14 dB,音樂約 −14 至 −18 dB。畫面上有文字時,背景音樂應為純音樂。

7. 品質檢查

  1. 使用 ffprobe 確認時長、尺寸和幀率符合簡報要求。
  2. 製作連絡表:ffmpeg -i out/final.mp4 -vf "fps=2,scale=360:-1,tile=10x6" -frames:v 1 out/contact.png。檢視連絡表以及每個節拍變化處的全尺寸幀(ffmpeg -ss <t> -i out/final.mp4 -frames:v 1 out/check-<t>.png)。
  3. 每一幀:邊緣無裁切、無空白或半透明幀、無殘留輔助線、無錯字或預留位置文字、無靜止超過 2 秒的畫面。
  4. 格式檔案本身的檢查項目。

修正並重新渲染,直到所有檢查通過。將任何新學到的教訓以 日期 · 影片 · 教訓 的格式添加到技能中的 references/pitfalls.md 檔案。

交付

報告最終 MP4 的路徑、長度、大小和幀率、內容說明、音訊狀態(含必要的聲明),以及重新渲染的指令。保留工作資料夾。僅在使用者要求時才上傳或發布。

相關技能