Communitygithub.com

motion-spot

生成具有代理级质量的动态图形视频(产品广告、应用广告、概念广告、品牌宣传片、作品集),完全通过代码实现。使用 HTML、GSAP、CSS 3D 和 Three.js,逐帧渲染并带有真实运动模糊,支持画外音和自制或原创音乐。

motion-spot 是什么?

motion-spot 是一个 AI 驱动的电影级动态图形视频创作工具,用于生成如 Apple、Nike 或 Spotify 所使用的那种高水准广告。它完全依赖代码工作,通过在无头 Chrome 浏览器中逐帧播放 GSAP 时间线,并利用 FFmpeg 输出带有运动模糊、辉光和颗粒效果的 MP4 视频。该技能特别强调使用真实素材(UI 截图、产品照片、品牌字体)来避免通用感,并提供一个经过验证的渲染引擎,你可以在 `plantilla/motor/` 中找到。对于有参考视频的项目,它会反向分析参考视频,复刻其结构,并采用基于“概念张力”(而非功能列表)的创作方法。该工具与 Claude Code 兼容,并假设用户掌握 JavaScript 和 HTML 知识。它支持多种输出格式(9:16 竖屏、16:9 横屏)和音频集成(ElevenLabs 画外音、动态配乐),整个创作流程分为十个阶段,从交互式编剧脚本到最终成品交付,其中包含严格的质量检查,以确保最终输出的专业水准。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/santiagosantofimio/motion-spot/tree/HEAD

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

motion-spot 是做什么的?

制作出堪比工作室的广告片,方法源于对 45 个由 Claude 制作、达到百万观看量的广告片的分析(references/estudio.md)。所有这些广告片都遵循一个共同配方:

一个充满张力的概念(而非功能列表)+ 真实的界面或产品作为主角 + 动态排版 + 永不静止的镜头 + 每个元素在画外音提及的瞬间精准出现 + 品牌色彩的高光时刻 + 干净的结尾,包含标志和标语。

一切皆为代码:每一帧都是网页的一种状态。在无头 Chrome 中逐帧播放一个暂停的 GSAP 时间线,然后由 ffmpeg 生成带有运动模糊、辉光和颗粒效果的 MP4 视频。引擎已在 plantilla/motor/ 中构建并测试过,并在 plantilla/escenas.js 中有一个完整的示例广告片。

如果用户提供了参考视频(“照着做”):

  1. 在开始设计之前先拆解参考视频:提取关键片段,每秒 8 到 12 帧,保持合适尺寸并生成联系表(使用 Read),同时记录每个元素:出现的真实 UI、使用的字体、颜色、进入和退出的方式(拉伸、模糊、翻转)。
  2. 复制其结构和真实元素,而不是使用“通用等效物”:如果原版使用 iMessage 气泡,则使用 -apple-system(系统 SF 字体)和带尾巴的气泡;如果使用 Spotify 歌词卡片,则使用其标签、按钮和颜色进行复刻;如果使用巨大的文字,则使用 Arial Black(macOS 自带)。
  3. 排版:永远不要用千篇一律的字体。 用户已多次拒绝 Claude 的默认排版(黑色紧身无衬线字体 + 极紧的字间距、Inter、斜体衬线字体)。请使用品牌在其真实静态字体样式中的字体(例如,SocialMedia/fuentes/ 中的 MonaSans-Black/Bold/Regular.ttf,与插画视频中使用的字体相同),字间距正常(最多 -0.01em);如果用户提供了参考视频,则使用其中的字体;或者,在渲染前询问或展示 3 个样本。切勿使用具有中等字重和紧凑字间距的可变字体。 3b. 默认禁止使用“Claude 风格”:仅当参考视频或品牌本身使用时,才可以使用 Inter / Anton / 斜体衬线字体 / HUD 等宽字体。如有参考视频,排版和元素必须与其一致。
  4. 请求无法精确复刻的内容的真实截图(应用程序、播放器、封面):用户将截图放入 activos/。Spotify 和其他应用程序可能因策略限制而无法通过 API 控制:不要试图绕过限制,而是请求截图或使用公共图像,并告知用户。
  5. 展示您的版本与参考视频的并排联系表,并在交付之前修正差异。
  6. 阅读 references/referencia-fiel.md:完整流程、每个元素的配方(Apple Messages 气泡、Spotify 歌词卡片、使用 SVG 制作的控件、滑入式阴影效果)、以及已经浪费过用户多次迭代的错误。现成的组件代码在 motor/ui.js 和 motor/ui.css 中;完整示例在 ejemplos/video-con-letra/ 中。

开始之前

您需要了解以下信息,并在不清楚时一次性提出,同时附上建议的默认值:

  1. 要推广什么以及针对谁(一句话描述)。
  2. 真实素材:最好使用 SVG 格式的 logo、应用程序或网站的截图、产品照片、品牌色。一个网站也足够了。没有真实素材,品牌形象会显得通用:请务必请求这些素材。如果没有,则设计一组示例品牌标识并告知用户。
  3. 格式和时长:默认为 9:16 竖屏,时长 15 到 20 秒。用于网页或 YouTube 则使用 16:9 横屏。
  4. 画外音:使用 ElevenLabs(最终版)、say(草稿版)或无画外音。
  5. 音乐:由引擎创作或使用用户提供的音轨(推荐用于发布)。

如果用户带来了完整的任务说明(references/encargo.md)或说“由你决定”,则不要提问:直接制作,并在之后通过 DECISIONES.md 文件解释所有决策。

工作流程

1. 项目初始化

bash ~/.claude/skills/motion-spot/scripts/nuevo.sh <spot-folder>          # 使用“Turnito”示例作为参考
bash ~/.claude/skills/motion-spot/scripts/nuevo.sh <spot-folder> --limpio # 创建空骨架项目

该命令会复制模板、安装依赖项(约 10 秒),并检查 Chrome 是否可用。然后将用户的素材复制到 activos/ 目录。

2. 概念与原型

阅读 references/arquetipos.md 并选择一个原型(可以借用其他原型中的一个镜头来制造“哇”的瞬间)。然后撰写:

  • 一句话概念,体现其张力:“周六的混乱与三秒完成预订的宁静之间的冲突”。
  • 品牌洞察:品牌自身所具有的、无人能够复制的独特细节(例如,Amazon 箭头连接 A 和 Z,Nike 的 swoosh 划过屏幕)。如果找不到,那么最终的广告片就会显得通用。

3. 写画外音脚本 → guion.json

阅读 references/voz-y-musica.md。画外音必须在动画之前编写,因为它决定了所有内容的节奏。每场戏一句台词,2 到 8 个词,注意重音和开头符号。结构:情景钩子(“凌晨两点…”)、行动、好处、高潮、品牌 + 标语。编写 guion.json 文件,包含各个场景、BPM、音乐风格、pico(高潮)场景以及特效。

4. 场景分镜表

创建一个表格,每行代表一个场景:时间 · 画外音 · 主角 · 镜头运动 · 动态图形技术(至少 3 项,来自 references/lenguaje.md) · 转场方式。规则:

  • 每个镜头包含三个层次:动态背景 + 主角 + 细节。
  • 镜头必须始终运动。使用动态图形转场(根据节拍切换、缩放穿越、遮罩、虹膜效果、推动),不要使用淡入淡出。
  • 在时长约 70% 处出现一个使用品牌色或 3D 效果的高潮点。
  • 整个广告片至少使用 8 种不同的技术。

如果广告片较长或成本较高,请在开始构建前向用户展示此分镜表。如果用户说“直接做”,则继续。

5. 视觉系统 → estilo.css

阅读 references/diseno.md。定义 CSS 变量(--fondo、--tinta、--acento、--acento2...)以及使用自定义前缀(.ui ...)为复刻的界面元素创建类。排版:使用紧凑的黑色无衬线字体 + 一个使用斜体衬线字体的词汇 + HUD 使用等宽字体(系统已预装:Inter、Instrument Serif、JetBrains Mono 和 Anton)。

6. 画外音与时间

  • ElevenLabs:为每个场景单独生成 → audio/voz/<id>.mp3 → 运行 node motor/preparar.mjs --recortar。
  • 草稿版画外音:运行 node motor/preparar.mjs --borrador-voz。
  • 然后运行 node motor/preparar.mjs:测量画外音时长,将剪切点量化为音乐节拍,并生成 guion.tiempos.json 文件,其中包含每个词的预计时间。

7. 逐个场景构建 → escenas.js

阅读 references/motor.md(API、配方和已知陷阱)。对于每个场景:

  1. 使用 spot.escena('id', (capa, c) => { ... }) 定义,包含三个层次、镜头偏移和使用的技术。
  2. 使用 spot.cuando('id', 'palabra') 与画外音同步。
  3. 运行 node motor/render.mjs --fotos <start+0.1>,<mid>,<end-0.1> 并使用 Read 工具查看生成的联系表(salida/fotos/hoja.jpg)。在继续下一个场景前修正问题。

参考 plantilla/escenas.js(Turnito 示例),了解如何实现遮挡、轨道运动、时间轮、通知、体素 3D、遮罩效果和缩放穿越等技术。

8. 音乐与混音

node motor/musica.mjs   # 按照 BPM 创作音乐,在“pico”场景处出现节奏停歇;或使用 guion.json 中用户提供的音轨
node motor/mezcla.mjs   # 混音:画外音 + 音乐(带闪避效果)+ 音效,目标响度 -14 LUFS

使用 node motor/servir.mjs,用户可以预览带音频的广告片,并可逐帧浏览。

9. 渲染、审阅与精修

node motor/render.mjs --fotos                 # 生成包含 12 帧的联系表:检查构图、拼写和安全区域
node motor/render.mjs --subida                # 最终输出:30 fps、4 倍运动模糊、后期处理,以及一个 < 10 MB 的版本(每 20 秒耗时 2-3 分钟)

对照 references/calidad.md 中的清单进行检查(分三轮)。然后,专门进行一轮精修:添加次要的微动画、突出打击感、检查每个场景的首帧和末帧。正是这第二遍修改,将好作品与卓越作品区分开来。

10. 成品交付

  • salida/spot.mp4 和 salida/spot-subida.mp4。
  • 封面图片:选用最引人注目的那一帧,而不是第一帧。
  • DECISIONES.md:概念、原型、设计决策、被否决的方案、迭代记录和耗时(模板在 calidad.md 中)。
  • 在聊天中回复:文件路径、稿件状态(画外音为 say 合成、音乐为合成音轨属于草稿版),以及 2-3 条具体的改进建议。

不可违反的规则

  1. 一切都是时间 t 的函数。 广告片中绝不允许使用 Math.random、Date.now、CSS 动画、setTimeout 或 requestAnimationFrame。对于随机性,请使用 ruido(i) 或 azar(seed)。
  2. 永远不要在 GSAP 动画元素的 CSS 中设置 transform(应使用 xPercent/yPercent)。这是元素位置错乱的第一大原因。
  3. 在继续下一个场景之前,务必查看每个场景的渲染帧。 任何未经肉眼确认的素材都不得交付。
  4. 必须使用真实素材,否则必须声明为示例素材。 界面必须基于截图精确复刻,不得凭空发明“通用界面”。
  5. 第三方品牌: 为非用户所属的真实品牌制作的广告片仅作为作品集练习(“概念广告”)。不得将其作为官方广告发布,不得暗示与品牌之间存在关系,且不得歪曲其标志。
  6. 数据: 必须使用用户提供的数据,或明确标记为示意数据。
  7. 我无法试听。 我会检查响度水平(峰值 -1 到 -2 dB,-14 LUFS),并确保画外音清晰度高过音乐;最终听感判断由用户负责。
  8. 上下文管理: 广告片制作相当耗费上下文。如果当前会话的上下文使用率超过 40%,请在继续构建之前进行压缩。
  9. 歌词: Claude 绝不能在代码(letra.json、聊天记录)中写入歌词,即使用户提供了也不行。对于包含歌词的视频:letra.json 中歌词文本留空,广告片应设计为无论有/无歌词都能正常工作,使用中性短语在测试副本中进行验证,最终由用户粘贴真实歌词并完成最终渲染。详见 references/motor.md → “letra.json”部分。

音乐视频和使用背景视频的项目

运行 node motor/extraer.mjs <url-del-video> --desde HH:MM:SS --hasta HH:MM:SS 提取帧(保存到 activos/clip/)和音频片段;使用 videoCuadros(...) 同步显示帧;motor/letra.js 从 letra.json 生成歌词同步效果。相关原型在 references/arquetipos.md 中的原型 9。

故障排查

症状可能的原因
window.spot.listo 从未变为 trueescenas.js 中存在 JavaScript 错误:渲染过程会输出页面错误。检查导入语句,并确保存在 await spot.terminar()
某个元素位置或大小异常,或位置跳动CSS 中的 transform 与 GSAP 冲突;或某个类(如 .app)与其他类冲突;或后代选择器范围过宽
某个场景显示为白屏或黑屏该场景的 id 不在脚本中(请运行 preparar.mjs),或某个转场效果将图层的不透明度设为 opacity: 0
3D 效果看起来扁平中间容器缺少 transform-style: preserve-3d,或中间元素设置了 overflow 或 filter
画外音与画面不同步微调 spot.cuando(...) 中的时间 ±0.1 秒;使用 servir.mjs 带音频进行预览检查
渲染耗时过长为草稿版渲染指定 --blur 1 --escala 0.5;减少使用阴影或模糊效果的节点;降低 voxelOla 或 particulas 中的 n 值
MP4 文件过大由颗粒效果导致:指定 --grano 3 或 --crf 22;对于上传版本,使用 --subida 参数

相关技能