motion-spot 是做什么的?
制作出堪比工作室的广告片,方法源于对 45 个由 Claude 制作、达到百万观看量的广告片的分析(references/estudio.md)。所有这些广告片都遵循一个共同配方:
一个充满张力的概念(而非功能列表)+ 真实的界面或产品作为主角 + 动态排版 + 永不静止的镜头 + 每个元素在画外音提及的瞬间精准出现 + 品牌色彩的高光时刻 + 干净的结尾,包含标志和标语。
一切皆为代码:每一帧都是网页的一种状态。在无头 Chrome 中逐帧播放一个暂停的 GSAP 时间线,然后由 ffmpeg 生成带有运动模糊、辉光和颗粒效果的 MP4 视频。引擎已在 plantilla/motor/ 中构建并测试过,并在 plantilla/escenas.js 中有一个完整的示例广告片。
如果用户提供了参考视频(“照着做”):
- 在开始设计之前先拆解参考视频:提取关键片段,每秒 8 到 12 帧,保持合适尺寸并生成联系表(使用 Read),同时记录每个元素:出现的真实 UI、使用的字体、颜色、进入和退出的方式(拉伸、模糊、翻转)。
- 复制其结构和真实元素,而不是使用“通用等效物”:如果原版使用 iMessage 气泡,则使用
-apple-system(系统 SF 字体)和带尾巴的气泡;如果使用 Spotify 歌词卡片,则使用其标签、按钮和颜色进行复刻;如果使用巨大的文字,则使用 Arial Black(macOS 自带)。 - 排版:永远不要用千篇一律的字体。 用户已多次拒绝 Claude 的默认排版(黑色紧身无衬线字体 + 极紧的字间距、Inter、斜体衬线字体)。请使用品牌在其真实静态字体样式中的字体(例如,
SocialMedia/fuentes/中的MonaSans-Black/Bold/Regular.ttf,与插画视频中使用的字体相同),字间距正常(最多 -0.01em);如果用户提供了参考视频,则使用其中的字体;或者,在渲染前询问或展示 3 个样本。切勿使用具有中等字重和紧凑字间距的可变字体。 3b. 默认禁止使用“Claude 风格”:仅当参考视频或品牌本身使用时,才可以使用 Inter / Anton / 斜体衬线字体 / HUD 等宽字体。如有参考视频,排版和元素必须与其一致。 - 请求无法精确复刻的内容的真实截图(应用程序、播放器、封面):用户将截图放入
activos/。Spotify 和其他应用程序可能因策略限制而无法通过 API 控制:不要试图绕过限制,而是请求截图或使用公共图像,并告知用户。 - 展示您的版本与参考视频的并排联系表,并在交付之前修正差异。
- 阅读
references/referencia-fiel.md:完整流程、每个元素的配方(Apple Messages 气泡、Spotify 歌词卡片、使用 SVG 制作的控件、滑入式阴影效果)、以及已经浪费过用户多次迭代的错误。现成的组件代码在motor/ui.js和motor/ui.css中;完整示例在ejemplos/video-con-letra/中。
开始之前
您需要了解以下信息,并在不清楚时一次性提出,同时附上建议的默认值:
- 要推广什么以及针对谁(一句话描述)。
- 真实素材:最好使用 SVG 格式的 logo、应用程序或网站的截图、产品照片、品牌色。一个网站也足够了。没有真实素材,品牌形象会显得通用:请务必请求这些素材。如果没有,则设计一组示例品牌标识并告知用户。
- 格式和时长:默认为 9:16 竖屏,时长 15 到 20 秒。用于网页或 YouTube 则使用 16:9 横屏。
- 画外音:使用 ElevenLabs(最终版)、
say(草稿版)或无画外音。 - 音乐:由引擎创作或使用用户提供的音轨(推荐用于发布)。
如果用户带来了完整的任务说明(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、配方和已知陷阱)。对于每个场景:
- 使用
spot.escena('id', (capa, c) => { ... })定义,包含三个层次、镜头偏移和使用的技术。 - 使用
spot.cuando('id', 'palabra')与画外音同步。 - 运行
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 条具体的改进建议。
不可违反的规则
- 一切都是时间
t的函数。 广告片中绝不允许使用Math.random、Date.now、CSS 动画、setTimeout或requestAnimationFrame。对于随机性,请使用ruido(i)或azar(seed)。 - 永远不要在 GSAP 动画元素的 CSS 中设置
transform(应使用xPercent/yPercent)。这是元素位置错乱的第一大原因。 - 在继续下一个场景之前,务必查看每个场景的渲染帧。 任何未经肉眼确认的素材都不得交付。
- 必须使用真实素材,否则必须声明为示例素材。 界面必须基于截图精确复刻,不得凭空发明“通用界面”。
- 第三方品牌: 为非用户所属的真实品牌制作的广告片仅作为作品集练习(“概念广告”)。不得将其作为官方广告发布,不得暗示与品牌之间存在关系,且不得歪曲其标志。
- 数据: 必须使用用户提供的数据,或明确标记为示意数据。
- 我无法试听。 我会检查响度水平(峰值 -1 到 -2 dB,-14 LUFS),并确保画外音清晰度高过音乐;最终听感判断由用户负责。
- 上下文管理: 广告片制作相当耗费上下文。如果当前会话的上下文使用率超过 40%,请在继续构建之前进行压缩。
- 歌词: 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 从未变为 true | escenas.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 参数 |