Communitygithub.com

motion-render-pro

用程式碼渲染專業級動態圖形影片(MP4),具備真實動態模糊、幀級精確時間、無淡出規則、命名緩動曲線與風格正確物理。適用於任何以程式碼製作的動畫影片、動態圖形、UI 動畫或宣傳片。

motion-render-pro 是什麼?

Motion Render Pro 是一個 AI 代理技能,旨在將 Claude 代碼生成的動畫從「網站風格」提升至「電影級」渲染品質。它強制執行六項不可妥協的規則:每一幀是時間的純函數、使用子幀平均實現真實動態模糊、禁止物件或文字淡出、僅使用命名緩動曲線、攝影機永不靜止或晃動,以及在動畫前先輸出靜態幀取得批准。它支援任何可執行 Node.js 的開發環境,依賴 `@napi-rs/canvas` 進行 2D 渲染,並使用 FFmpeg 進行最終輸出。工作流程包括從模板建立場景檔案、對主要時間點執行 `still()`、進行預覽渲染,然後以 180° 快門和可調整的子幀數(建議 8-32)進行最終幀渲染。該技能還根據「UI/圖形」與「寫實/3D」風格明確定義了物理規則、發光與文字渲染準則、構圖規範(如 Instagram 安全區與間距要求),以及禁止元素清單(如 emoji 與泛用粒子),確保動畫在視覺上保持一致且專業。

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

在你喜歡的 AI 中提問

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

說明文件

Motion Render Pro

樣式規則: 在所寫的任何內容(回覆、規格、字幕、檔案)中,絕對不要使用 em dash 或 en dash。請改用逗號、冒號、句點、括號或普通連字號。

Claude 以程式碼建立的動態影片之工作室級渲染標準。預設 Claude 動畫(CSS 過渡、線性/緩入緩出、透明度淡出、無模糊)看起來像個網站。這些規則讓它看起來像一部電影。

以使用者的語言回覆。此技能是渲染層。場景規劃請使用 motion-story-director,音訊請用 motion-sound-design,複製參考影片請用 motion-reverse-engineer。

0. 本技能中的檔案

檔案使用時機
scripts/engine.mjs每次渲染:決定性幀、子幀動態模糊、緩動、關鍵幀、節拍網格、攝影機平滑、打字效果、發光、遮罩文字、ffmpeg 輸出
assets/scene-template.mjs開始一個新的場景檔案
assets/DESIGN.template.md開始專案的 DESIGN.md

設定(每個專案一次)

  1. 建立一個專案資料夾並將引擎複製進去:mkdir -p motion-tools && cp <此技能>/scripts/engine.mjs motion-tools/。它必須位於專案內部,以便 Node 找到專案的 node_modules。請勿編輯複製的檔案;場景程式碼放在自己的檔案中。
  2. cd 進入專案,然後 npm init -y && npm i @napi-rs/canvas(預先建置,無系統依賴)。FFmpeg 必須存在(which ffmpeg)才能使用 render();still() 可在沒有 FFmpeg 的情況下運作。
  3. 將 assets/DESIGN.template.md 複製為 DESIGN.md 並填寫(調色盤十六進位碼、字型、主角物件、動作詞彙庫、禁止清單),然後建立 CLAUDE.md,其中只放一行指向它的路徑,如此設計才能在跨對話時保持。
  4. 字型:使用 @napi-rs/canvas 的 GlobalFonts.registerFromPath(path, family) 註冊真實字型(透過 npm @fontsource/* 套件下載 Google Fonts .ttf,或詢問使用者)。切勿依賴預設的襯線/無襯線字型作為成品。

若在存在 Motion/Design 成品類型的對話中執行,且使用者未要求 MP4 檔案,則這些成品類型可能是更好的交付方式;此技能適用於程式碼渲染的 MP4。

1. 六項不可妥協規則

  1. 每一幀都是時間的純函數。 只能使用 draw(ctx, t)。沒有計時器、沒有 Math.random()(請使用 rng(seed)),沒有跨幀的狀態。這讓渲染可重複、幀精確且可模糊。
  2. 真實動態模糊。 每個輸出幀 = 快門期間(預設 180° = shutter: 0.5)平均 N 個子幀。一般運動使用 8 個子幀,快速甩動使用 16-32 個;subframes 可以是 t 的函數,因此只有快速部分需要付出代價。液體/形狀邊緣在每個子幀中評估,靜止時仍保持銳利。
  3. 物件或文字不淡出。 物體透過移動、從其起因縮放、擠壓成一個點、從線狀遮罩中滾出(maskedText)、被形狀揭示,或從邊緣離開來進入和離開。透明度僅允許用於光線(發光、光暈、光輝),以及規格明確要求的情況。
  4. 僅使用命名緩動。 可見物體永遠不要使用線性(除非是恆速旋轉)。從下方詞彙表中挑選,並在計劃中命名。
  5. 攝影機從不靜止也從不晃動。 全域攝影機 = 帶關鍵幀的 smoothPath()(高斯 sigma ≈ 0.16 秒,≤ 25 像素/幀);重點在物件中,而非攝影機抖動。
  6. 在動畫化之前先批准靜態幀。 使用 still() 在關鍵時刻渲染 2-4 個關鍵幀,展示它們,獲得同意,然後再渲染動畫。渲染完成後,再次提取相同時間戳作為檢查點。

2. 緩動詞彙表(全部在 E 中)

名稱用途感覺
E.start開始移動的物件第一個移動幀跳躍約 35%,長煞車
E.drop = bezier(.42,0,.25,1)掉落、爬行、行進加速,每秒 7-8% 峰值,約 15 幀煞車
E.camera = bezier(.42,0,.36,1)鏡頭在鏡位間移動在事件發生時或之前完成
E.spread漣漪、填充、擴展加速到全速,+10% 超射,回彈
E.push列表、堆疊、輸送帶速度 20u(1-u)³;重疊推送使列表永不停止
E.spring(t, z, w)UI 元素落地小幅超射(z 0.6-0.8)
E.critical(t, w)標誌、硬幣、高級揭示臨界阻尼,無超射
E.sine呼吸、搖擺、循環對稱緩入緩出
pop(t, t0, fps, 1.18)徽章、圖示、勾選標記2-3 幀內 115-120%,7 幀內穩定,無彈跳

持續時間:大多數進/出動作為 7-12 幀(30 fps 下約 0.23-0.4 秒)。沒有任何東西在一幀內出現或消失。

3. 不同風格的物理(絕不混合)

  • UI / 圖形風格: 彈出、超射、著陸時壓縮 10-15%、彈簧、液體元球、會發光的光線。
  • 寫實 / 3D 風格: 真實重力(y = ½gt²)、每次接觸 = 衝擊 + 一次小反彈、無壓縮、無物件從零縮放、無滑動滾動、紙張有空氣阻力(飄動、滑行、永不漂浮)。在 Blender 中,使用剛體/布料模擬或根據這些公式設定關鍵幀;使用 Cycles 加降噪器渲染,180° 快門動態模糊,f/2.8 風格景深,對焦於引導物件。

4. 光線、發光與字型

  • 發光 = 使用 glow()(globalCompositeOperation 'lighter')的疊加光暈,範圍至約 2.1 R(1.2 R 處半強度,2 R 處消失)。在白色背景上,疊加光會消失;請在物件後方繪製一個大的飽和柔軟色塊。
  • 只有光線是透明的。左上角高光,光澤物件有微弱 Fresnel 邊緣光。
  • 字型設計:最多 2 個字型系列;主角文字使用顯示字型(粗體/窄體或斜體襯線),輔助文字使用乾淨無襯線字型。大數字使用緊密字距。iOS/系統 UI 永不打出;它會整體滑入或滾入。
  • 打字效果:typing() 提供逐字母抖動(0.55-1.45 倍平均,空格後更長),每個字母在 2 幀內從其遮罩升起;最後一個字母後游標實心 0.35 秒,然後柔和閃爍(caret())。新字母可以強調色出現,並在大約 6 個字元後冷卻為白色。
  • 數字碼錶:數字在硬遮罩下在滾輪上,每幀 ≤ 0.5 個數字,個位數最後落地。

5. 構圖規則

  • 除非另有說明,否則為 1080×1920 垂直方向;保持文字/圖示距離邊緣 ≥ 75 像素(或 0.11 W);Instagram UI 區域:頂部約 250 像素,底部約 420 像素,右側約 120 像素。
  • 主角元素在畫面中要大;裁剪到畫面邊緣是可以的。2-3 個深度層,具有視差和失焦。
  • 將群組置中於畫面,並彼此置中。
  • 禁止清單(預設 AI 汎濫):emoji、泛用粒子、脈衝環、虛線、外框圖示、發明標誌、到處都是的「科技」泛濫發光、繪製的人物/臉孔。只允許規格要求的內容。
  • 循環:當要求時,最後一幀必須等於第 0 幀(使用 motion-reverse-engineer analyze 驗證 → 首/尾相似度 > 0.95)。

6. 工作流程

  1. 取得或撰寫定時規格(motion-story-director)。
  2. 將 assets/scene-template.mjs 複製為 scene.mjs 並在其上建構:常數(W、H、FPS、D、調色盤)、grid(bpm)、攝影機 smoothPath、每個場景一個函數、一個按時間分配並處理過渡重疊的 draw(ctx,t)。
  3. 在關鍵時刻使用 still()(使用模板執行 node scene.mjs --stills)→ 展示 → 批准。
  4. 草稿渲染:半解析度、subframes: 1、preset: 'ultrafast' 以檢查時間。
  5. 最終版:全解析度、子幀 8(快速部分 16-32)、crf 16-18、preset: 'veryfast'(僅在要求最佳品質時使用 'slow')。
  6. 使用 motion-sound-design 混合音訊並混流。
  7. 檢查點:在計劃的時間戳提取幀,並與靜態幀/參考進行比較。將 MP4 發送給使用者。

渲染成本指南(1080×1920、Node、單核心):簡單 2D 約 0.05-0.15 秒/子幀。15 秒 × 30 fps × 8 子幀 ≈ 3600 子幀 ≈ 3-9 分鐘。在渲染超過 15 分鐘前警告使用者;必要時使用 from/to 幀範圍選項分塊渲染,並使用 ffmpeg 串接。

7. 最小場景範本

assets/scene-template.mjs:一個背景、一個使用 E.camera 的攝影機推進、一個在節拍 1 上彈出並以 E.drop 搭配發光移動的圖示。node scene.mjs --stills 寫入檢查幀,node scene.mjs 使用 16 個子幀(快速移動期間)和 8 個子幀(其他部分)渲染 out.mp4。

Individual skills in this repo

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

motion-sound-design

Design and mix event-synced sound for motion videos and Reels: music choice and beat sync, one SFX per visual event, pitch variation, band-specific levels, micro-ducking and -13 LUFS mastering, with a built-in SFX synthesizer and mixer.

motion-story-director

Turn an idea into a frame-exact, beat-locked motion video spec (hero object, object-handoff transitions, camera language, ban list) and lint any motion prompt for timing, count and density errors.

reels-edit-director

Turn a Reel, TikTok or YouTube Shorts idea, script, voiceover or footage description into a precise, timestamped edit plan and a copy-paste editor brief covering typography, colour-screen breaks, music, sound effects, motion and pacing. Also diagnoses drafts that feel boring, chaotic or lose viewers. Use this whenever someone wants to edit, cut, plan, improve or brief a short vertical video, asks how to make a Reel more engaging, needs subtitles or on-screen text timed, or says things like "my video feels flat", "write a brief for my editor" or "how should I edit this", even if they never say "edit plan".

reels-music-picker

Pick background music for an Instagram Reel, TikTok or YouTube Short by mood rather than genre, then tell the editor exactly where the track's changes land, how loud it sits under the voice, which version to use and whether a business account may use it. Includes beat and bar maths, a loudness checker and licensing guidance. Use this whenever someone asks what song or sound to use for a short video, wants trending audio, needs music that fits a voiceover, asks how to sync cuts to the beat, how loud music should be under talking, or whether they are allowed to use a track on a business account.

相關技能