動畫生成器 是做什麼的?
從自然語言描述建立動畫影片與動態圖形。輸出一個可在瀏覽器中播放的獨立 Vite + React + Framer Motion 專案。
工作流程
步驟 1:解析請求
將使用者的描述拆解為場景計畫:
- 3-7 個場景,每個持續 3-5 秒
- 識別故事架構:英雄/開場、問題、解決方案、功能、行動呼籲/結尾
- 挑選符合品牌/氛圍的色彩調色板與字型
- 使用
$ARGUMENTS取得使用者的動畫描述
步驟 2:選擇動畫堆疊
根據請求自動偵測最佳方式:
| 請求類型 | 堆疊 | 使用時機 |
|---|---|---|
| 產品介紹、簡報、行銷 | Framer Motion(預設) | 以文字、圖示、轉場為主的場景式動畫 |
| 生成式藝術、粒子、圖案 | p5.js | 創意/演算法視覺效果 |
| 3D 物件、環境、產品渲染 | Three.js + react-three-fiber | 需要 3D 場景 |
| 簡單文字/標誌動畫 | 純 CSS 動畫 | 輕量、無需複雜依賴 |
預設使用 Framer Motion,除非請求明確需要其他方案。
步驟 3:建立專案架構
- 建立目錄:
~/animations/[專案名稱]/ - 執行腳本:
bash ~/.claude/skills/animate/scripts/scaffold.sh [專案名稱] [堆疊] - 從
~/.claude/skills/animate/assets/template-files/複製範本檔案到專案中
步驟 4:生成場景元件
參閱動畫預設與場景模式的參考文件:
references/animation-presets.md— 所有可用的轉場、彈簧、緩動函式references/scene-patterns.md— 範例場景程式碼模式
對每個場景,在 client/src/components/video/video_scenes/ 中建立 React 元件:
- 使用
motion.div搭配場景轉場預設(fadeBlur、scaleFade、slideLeft、splitHorizontal、morphExpand 等) - 使用
containerVariants和itemVariants實現錯開內容顯示效果 - 使用
vw單位確保響應式尺寸(可在任何解析度下正常運作) - 使用 CSS 變數進行主題設定(
var(--color-accent)、var(--color-bg-dark)等) - 使用 Lucide 圖示作為視覺元素
- 使用
.glass-panel類別實現毛玻璃卡片效果 - 使用
.text-gradient和.text-gradient-accent實現漸層文字效果
步驟 5:生成 VideoTemplate
建立 client/src/components/video/VideoTemplate.tsx:
- 匯入所有場景元件
- 定義
SCENE_DURATIONS物件(場景名稱 -> 毫秒) - 使用
useVideoPlayer鉤子管理場景推進 - 使用
AnimatePresence mode="wait"包裹場景以實現平滑轉場 - 每個場景根據
currentScene索引條件式渲染
步驟 6:客製化主題
更新 client/src/index.css 中的顏色:
- 如果使用者指定了品牌顏色,更新 CSS 變數
- 選擇符合氛圍的字型(科技感用 Space Grotesk,優雅風格用 Playfair Display 等)
- 根據調色板更新漸層與光暈樣式
步驟 7:Gemini 3.1 Pro 增強(可選)
如果環境變數 GEMINI_API_KEY 可用:
- 閱讀
references/gemini-integration.md以取得 API 細節 - 將使用者的描述發送給 Gemini 3.1 Pro,要求其提供:
- 場景分解,包含描述與建議轉場方式
- 以 CSS 變數表示的色彩調色板
- 每個場景的文案/標題
- 適用的 SVG 圖形
- 使用 Gemini 輸出輔助場景生成
- 如果沒有 API 金鑰,則跳過此步驟 — Claude 直接處理所有創意決策
步驟 8:建置與預覽
cd ~/animations/[專案名稱]
npm install
npm run dev
告知使用者動畫正在 http://localhost:5173 執行,並在瀏覽器中開啟。
場景轉場參考(快速查詢)
根據故事節奏選擇轉場方式:
- fadeBlur — 柔和的開場/結尾,夢幻般的揭示
- scaleFade — 自信的揭示,產品展示
- slideLeft/slideRight — 序列式推進,時間軸流動
- splitHorizontal/splitVertical — 戲劇性的揭示,前後對比
- morphExpand — 華麗結尾,行動呼籲畫面
- clipCircle — 聚焦注意力,聚光燈效果
- perspectiveFlip — 卡片翻轉,視角變化
- wipe — 乾淨的轉場,方向性流動
- zoomThrough — 沉浸式,前進動感
- crossDissolve — 柔和、情感化的轉場
元素動畫參考(快速查詢)
- popIn — 圖示/徽章的彈跳縮放入場效果
- fadeUp/fadeDown — 隱晦的內容揭示
- slideInLeft/slideInRight — 方向性內容
- blurIn — 柔和的焦點揭示
- elasticScale — 俏皮、充滿活力的入場效果
- perspectiveRotateIn — 3D 卡片揭示
- pulse — 循環吸引注意
- float — 輕柔懸浮效果
重要規則
- 一律使用
vw單位設定尺寸,讓動畫在任何解析度下都能正常顯示 - 每個場景持續 3-5 秒 — 總影片長度 15-30 秒
- 使用
AnimatePresence mode="wait",確保一個場景結束後下一個再進入 - 每個場景都必須有背景處理(漸層、圖片或動態形狀)
- 對列表和網格使用錯開動畫(staggerChildren: 0.1-0.2)
- 如果素材較大,包含載入狀態
- 專案必須完全自足 — 除 npm 套件外不得有任何外部依賴
- 在生成的程式碼或內容中不要使用任何表情符號