动画生成器
根据自然语言描述创建动画视频和动态图形。输出一个独立的 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/[project-name]/ - 运行脚手架脚本:
bash ~/.claude/skills/animate/scripts/scaffold.sh [project-name] [stack] - 将
~/.claude/skills/animate/assets/template-files/中的模板文件复制到项目中
步骤 4:生成场景组件
阅读动画预设和场景模式的参考资料:
references/animation-presets.md— 所有可用的过渡、弹簧、缓动效果references/scene-patterns.md— 示例场景代码模式
为每个场景创建一个 React 组件,位于 client/src/components/video/video_scenes/:
- 使用
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/[project-name]
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 包外,没有外部依赖
- 生成的代码或内容中不得使用表情符号