Communitygithub.com

cskwork/motion-graphics-skill

生成基于代码的动态图形视频,逐帧精确、完全可重现。适合制作产品发布、功能宣传或短视频等风格。

motion-graphics-skill 是什么?

此技能让你能够创建完全由代码驱动的动态图形视频,灵感源自专业动态设计师的作品集。它把视频视为一个HTML页面,页面中每个像素都是时间t的纯函数,通过无头Chromium逐帧渲染,再用ffmpeg编码。支持的格式包括产品发布视频(Apple/Google发布会风格)、SaaS推广片、以及针对YouTube Shorts、Reels或TikTok的竖屏短视频。工作流程涵盖格式选择、工作区初始化、使用灵活的`MG.*`辅助函数进行代码化合成、渲染、音频混音,以及严格的QA检查。它强调确定性、帧0即动的节奏感,以及专业级的音频响度标准。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/cskwork/motion-graphics-skill/tree/HEAD/skills/motion-graphics

在你喜欢的 AI 中提问

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

文档

动态图形

一个视频就是一张HTML页面,其每一个像素都是时间 t 的纯函数,在无头 Chromium 中逐帧渲染,并由 ffmpeg 编码。标准是高级动态设计师的作品集,绝非幻灯片。

1. 选择格式

请求阅读
发布、推广、广告、功能片、真实产品的应用预告片formats/launch-video.md
短视频、Reels、TikTok、竖屏解说或故事formats/shorts.md

遵循格式文件中的简介、内容步骤和节奏结构。它会引导回到这里进行构建。在编写合成之前,还要阅读 references/pitfalls.md。

每次运行都是全新的创意。 每个视频都有自己独特的想法、脚本和外观。当用户要求不查看过去作品时,请保持工作区中之前的视频和合成文件未被打开。

2. 工作文件夹

在用户指定的位置(默认为当前目录)创建 <slug>-<YYYYMMDD>/:

brief.md          格式简介表中的参数
beats.md          节拍表(时间、文案、素材、动作、过渡、强调点、节奏卡点)
assets/           截屏、图片、字体、音频
assets/manifest.md   每个素材文件一行:来源、许可证或“从 <表面> 捕获”、显示内容
motion.html       合成文件
motion.json       {"size": [W, H], "fps": 60, "duration": 30, "stills": [节拍时间点], "captions": []}
engine/           从此技能复制 engine/
out/              单帧图片、渲染结果、联系表

每个文件夹只设置一次引擎:

cp -R <this-skill>/engine engine && (cd engine && npm install && npx playwright install chromium)

3. 合成

motion.html 加载 engine/runtime.css 和 engine/runtime.js,构建其DOM,注册场景,然后调用 MG.ready()。

辅助函数用途
MG.scene(start, end, fn, el)fn(local, t, dur) 在 start <= t < end 期间运行;el 在外部隐藏。每次调用时设置所有动画属性。
MG.always(fn)每帧运行:背景、颗粒、进度条。
MG.prog(t, a, b, ease)缓动的0..1进度。缓动函数:MG.ease.*(linear、in/out/inOut Quad、Cubic、Quart、Expo、inBack、outBack、outElastic、outBounce)或任意函数。
MG.tween(t, [[t0, v0], [t1, v1, ease], …])关键帧;值可以是数组。
MG.spring(t, {stiffness, damping})物理模拟0 → 1运动,带有超调。
`MG.split(el, "grapheme""word")`
MG.set(el, {x, y, s, sx, sy, r, o, blur, ...css})每帧对每个元素调用一次。
MG.clip(videoEl, start, rate)从 start 开始逐帧精确播放屏幕录制。
MG.rng(seed), MG.noise(x, seed)确定性随机数和抖动。
MG.fmt(n, {decimals})用于计数器的区域设置数字格式化。
MG.captions()在底部UI区块上方绘制 motion.json 中的字幕。

确定性:渲染逻辑中不使用 Date、performance.now()、requestAnimationFrame 或 Math.random。允许使用 CSS @keyframes;运行时会在 t 处暂停它们,因此使用 animation-delay 控制时间。仅使用 manifest 中列出的字体和图片。

预览一帧:open "motion.html?w=1920&h=1080&t=3.2&guides=1"(guides 显示安全区)。实时:?play=1。字幕仅在渲染时显示。

4. 工艺标准

  • 第0帧已经开始运动。 不要从黑场淡入,不要有logo开场。
  • 每0.8–2秒内有实质变化:布局、缩放、颜色、数字或镜头。
  • 入场使用弹簧或 ease-out-expo 并带有轻微超调;30–60毫秒错开;只有计数器使用线性运动。
  • 仅在快速移动时使用运动模糊;静态镜头使用缓慢推近(缩放1→1.04);2–3个深度层上实现视差。
  • 一种背景风格、一种文字颜色、一种强调色。添加颗粒或渐变噪点,使纯色填充在上传后不会出现色带。
  • 文案在屏幕上停留足够长时间以供阅读两次;关键文字保持在安全区内。
  • 节奏与声音对齐:每次变化配合一个风声、打击声或音乐拍点。

5. 渲染

node engine/render.mjs --html motion.html --config motion.json --stills <t1,t2,...> --stills-dir out/stills
node engine/render.mjs --html motion.html --config motion.json --out out/video.mp4 --workers 4

先在单帧图片上确定布局:每个节拍点一张、每个补间内部一张、每个弹簧超调峰值一张。每次只运行一次完整渲染(在1080p60下4个worker,约25秒视频耗时10分钟)。

6. 音频

仅使用 manifest 中列出且许可证允许使用的音乐和音效,或用户提供的文件。如果没有,则输出无声视频并说明。混音提示,然后封装:

ffmpeg -i music.wav -i whoosh.wav -filter_complex \
  "[0]volume=-16dB[m];[1]adelay=1200|1200,volume=-8dB[a];[m][a]amix=inputs=2:normalize=0[out]" -map "[out]" out/mix.wav
ffmpeg -i out/video.mp4 -i out/mix.wav -map 0:v -map 1:a -c:v copy \
  -af "loudnorm=I=-14:TP=-1.5:LRA=11" -c:a aac -b:a 256k -shortest -movflags +faststart out/final.mp4
ffmpeg -i out/final.mp4 -af ebur128=peak=true -f null - 2>&1 | grep -E "^ +(I|Peak):"

目标约-14 LUFS集成响度,真峰值低于-1 dBFS。音效约-6至-14 dB,音乐-14至-18 dB。有屏幕文字的背景下使用纯音乐。

7. QA检查

  1. 使用 ffprobe 检查时长、尺寸和帧率是否与简介匹配。
  2. 联系表:ffmpeg -i out/final.mp4 -vf "fps=2,scale=360:-1,tile=10x6" -frames:v 1 out/contact.png。查看联系表以及每个节拍变化点的全尺寸帧(ffmpeg -ss <t> -i out/final.mp4 -frames:v 1 out/check-<t>.png)。
  3. 每帧检查:边缘无裁剪、无空白或半透帧、无残留参考线、无错别字或占位符文本、无任何超过2秒的静态内容。
  4. 格式文件自身的检查。

修复并重新渲染,直到所有检查通过。将任何新经验添加到技能中的 references/pitfalls.md,格式为 日期 · 视频 · 经验教训。

交付

报告最终的MP4路径、长度、尺寸和帧率、内容说明、音频状态(包括需要的署名),以及重新渲染命令。保留工作文件夹。仅在用户要求时上传或发布。

相关技能