Communitygithub.com

motion-render-pro

从代码中渲染专业级动态图形视频(MP4),支持真实运动模糊、帧级精确时序、无淡入淡出规则、命名缓动曲线和风格正确的物理效果。适用于任何用代码构建的动画视频、动态图形、UI 动画或宣传片。

motion-render-pro 是什么?

Motion Render Pro 是一个 AI 代理技能,旨在指导 Claude 或其他 AI 编码代理生成电影级、代码渲染的动态图形视频。它强制执行严格的渲染标准,包括将每一帧作为时间的纯函数、通过子帧采样实现真正的运动模糊,以及禁止使用透明度进行对象或文本的渐隐渐现。该技能提供了一套全面的命名缓动曲线(如 `E.drop`、`E.camera`、`E.spread`),并提供了适用于 UI/图形风格(使用弹跳和挤压)和写实/3D 风格(使用真实重力和滚动)的物理指导方针。它包含了自动文字排版、发光效果和摄像机运动(平滑路径,无抖动),并且内置了一个渲染引擎 (`scripts/engine.mjs`),可处理子帧运动模糊、缓动、关键帧、节拍网格和 ffmpeg 输出。该技能专为代码构建的动画而设计,可与运动叙事导演(运动-story-director)和音效设计(运动-sound-design)等其他技能配合使用,支持在 Node.js 环境中使用 `@napi-rs/canvas` 进行渲染,并且强调在制作完整动画之前先批准静态帧。

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

在你喜欢的 AI 中提问

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

文档

Motion Render Pro

样式规则: 在你写的任何内容(回复、规格说明、字幕、文件)中,绝对不要使用 em 破折号或 en 破折号。请改用逗号、冒号、句号、括号或普通的连字符。

针对 Claude 在代码中构建的动态视频的工作室级渲染标准。默认的 Claude 动画(CSS 过渡、线性/缓动、不透明度淡入淡出、无模糊)看起来像一个网站。这些规则使其看起来像一部电影。

请用用户的语言回复。此技能是渲染层。场景规划请使用 motion-story-director,音频请使用 motion-sound-design,如需复制参考视频请使用 motion-reverse-engineer。

0. 本技能中的文件

文件何时使用它
scripts/engine.mjs每次渲染:确定性帧、子帧运动模糊、缓动、关键帧、节拍网格、摄像机平滑、打字效果、发光、遮罩文本、ffmpeg 输出
assets/scene-template.mjs开始一个新的场景文件时
assets/DESIGN.template.md开始项目的 DESIGN.md 时

设置(每个项目一次)

  1. 创建一个项目文件夹并将引擎复制进去:mkdir -p motion-tools && cp <此技能路径>/scripts/engine.mjs motion-tools/。它必须位于项目内部,以便 Node 能找到项目的 node_modules。不要编辑副本;场景代码放在其自己的文件中。
  2. cd 进入项目,运行 npm init -y && npm i @napi-rs/canvas(预构建,无系统依赖)。ffmpeg 必须存在(which ffmpeg)才能使用 render();在没有 ffmpeg 的情况下 still() 也能工作。
  3. 将 assets/DESIGN.template.md 复制到 DESIGN.md 并填充它(调色板十六进制值、字体、主要对象、运动词汇表、禁用列表),并创建 CLAUDE.md,其中包含一行指向它的内容,以便外观在多个会话中保持一致。
  4. 字体:使用 @napi-rs/canvas 的 GlobalFonts.registerFromPath(path, family) 注册真实字体(可通过 npm 的 @fontsource/* 包下载 Google Fonts .ttf 文件,或询问用户)。在最终输出中,切勿依赖默认的衬线/无衬线字体。

如果在存在 Motion/Design 工件类型的聊天环境中运行,并且用户没有要求 MP4 文件,那么这些工件类型可能是更好的交付方式;此技能适用于代码渲染的 MP4。

1. 六项不可妥协的规则

  1. 每一帧都是时间的纯函数。 仅使用 draw(ctx, t)。没有定时器,没有 Math.random()(请使用 rng(seed)),帧之间不携带状态。这使得渲染可重复、帧级精确且支持模糊。
  2. 真正的运动模糊。 每个输出帧 = 在快门开启时间内(默认 180° = shutter: 0.5)的 N 个子帧的平均值。正常运动使用 8 个子帧,快速运动使用 16-32 个;subframes 可以作为 t 的函数,这样只有快速部分才需要付出代价。每个子帧评估的液体/形状边缘在静止时保持清晰。
  3. 对象或文本上无淡入淡出。 物体通过从其原因移动、缩放,压缩成一个点,从线条遮罩中滚出(maskedText),被形状揭示,或从边缘离开来进入和退出。仅允许对光(发光、光晕、辉光)以及规格明确要求的情况下使用不透明度。
  4. 仅使用命名缓动。 对于任何可见事物,切勿使用线性缓动(恒定旋转除外)。请从下方词汇表中选取并命名到计划中。
  5. 摄像机从不停滞,也从不抖动。 全局摄像机 = 关键帧的 smoothPath()(高斯 sigma ≈ 0.16 秒,≤ 25 像素/帧);强调效果存在于物体内部,而非摄像机的突然移动中。
  6. 在动画化之前批准静态帧。 在关键时刻使用 still() 渲染 2-4 个关键帧,展示它们,得到肯定答复,然后再渲染运动。渲染后,再次提取相同的时间戳作为校验点。

2. 缓动词汇表(全部位于 E 中)

名称用途感觉
E.start开始移动的物体在第一个移动帧上跳跃约 35%,长制动
E.drop = bezier(.42,0,.25,1)下落、爬行、移动加速,峰值 7-8%/帧,约 15 帧制动
E.camera = bezier(.42,0,.36,1)镜头之间的摄像机移动在事件发生时或之前完成
E.spread扩散、填充、扩张加速到全速,+10% 超调,回弹
E.push列表、堆叠、传送带速度 20u(1-u)³;重叠推动使列表永不停止
E.spring(t, z, w)UI 元素着陆小超调(z 0.6-0.8)
E.critical(t, w)标志、硬币、高级揭示临界阻尼,无超调
E.sine呼吸、摇摆、循环对称缓入缓出
pop(t, t0, fps, 1.18)徽章、图标、勾选标记2-3 帧达到 115-120%,7 帧内稳定,无弹跳

持续时间:大多数进/出动作为 7-12 帧(30 fps 下为 0.23-0.4 秒)。没有事物在一帧内出现或消失。

3. 按风格划分的物理效果(切勿混合)

  • UI / 图形风格: 弹出、超调,着陆时挤压 10-15%,弹簧,液体粘性球体,光晕绽放。
  • 写实 / 3D 风格: 真实重力(y = ½gt²),每次接触 = 冲击 + 一个小反弹,无挤压,无事物从零缩放,无滑动滚动,纸张带空气阻力(飘动、滑动,永不漂浮)。在 Blender 中,使用刚体/布料模拟或根据这些公式设置关键帧;使用 Cycles 加降噪器渲染,180° 快门运动模糊,f/2.8 风格的景深聚焦于引导对象。

4. 光照、发光和文字排版

  • 发光 = 使用 glow()(globalCompositeOperation 'lighter')的叠加光晕,范围约至 2.1 R(1.2 R 处强度减半,2 R 处消失)。在白色背景上,叠加光会消失;请在物体背面绘制一个大的饱和柔和光点。
  • 只有光才是透明的。高光位于左上角,光泽物体有微弱菲涅耳边缘光。
  • 文字排版:最多 2 个字体族;较重/紧缩的无衬线体或斜体衬线体用于主要词汇,干净的无衬线体用于辅助文字。大数字字间距要紧密。iOS/系统 UI 从不打字;它整体滑入或滚入。
  • 打字效果:typing() 提供每个字母的抖动(平均值的 0.55-1.45 倍,空格后更长),每个字母在 2 帧内从其遮罩升起;光标在最后一个字母后实心显示 0.35 秒,然后柔和闪烁(caret())。新字母可以用强调色出现,并在约 6 个字符后冷却为白色。
  • 数字里程表:数字在硬遮罩下的轮子上滚动,每帧 ≤ 0.5 个数字,个位数字最后落地。

5. 构图规则

  • 除非另有说明,否则为 1080×1920 垂直构图;保持文本/图标距离边缘 ≥ 75 像素(或 0.11 宽度);Instagram UI 区域:顶部约 250 像素,底部约 420 像素,右侧约 120 像素。
  • 主要元素在画面中要大;边缘裁剪是好的。2-3 层深度,带视差和散焦。
  • 将组相对于画面居中,并且各元素之间也相互居中。
  • 禁用列表(默认的 AI 俗套):表情符号、通用粒子、脉冲环、虚线、轮廓图标、发明标志、无处不在的通用“科技”发光、绘制的人物/面孔。仅允许规格要求的内容。
  • 循环:当要求时,最后一帧必须等于第 0 帧(使用 motion-reverse-engineer 的 analyze 验证 → 首帧/尾帧相似度 > 0.95)。

6. 工作流程

  1. 获取或编写带时序的规格说明 (motion-story-director)。
  2. 将 assets/scene-template.mjs 复制到 scene.mjs 并在此基础上构建:常量(W, H, FPS, D, 调色板),grid(bpm),摄像机 smoothPath,每个场景一个函数,一个按时间调度并处理过渡重叠的 draw(ctx,t)。
  3. 在关键时刻使用 still()(使用模板运行 node scene.mjs --stills)→ 展示 → 批准。
  4. 草稿渲染:半分辨率,subframes: 1,preset: 'ultrafast' 以检查时序。
  5. 最终版:全分辨率,子帧 8(快速部分 16-32),crf 16-18,preset: 'veryfast'(仅在要求最佳质量时使用 'slow')。
  6. 使用 motion-sound-design 混合音频并复用。
  7. 校验点:在计划的时间戳提取帧,并与静态帧/参考帧进行比较。将 MP4 发送给用户。

渲染成本指南(1080×1920,Node,单核):简单 2D 每子帧约 0.05-0.15 秒。15 秒 × 30 fps × 8 子帧 ≈ 3600 子帧 ≈ 3-9 分钟。在渲染时间超过 15 分钟前警告用户;使用 from/to 帧范围选项分段渲染,并在需要时使用 ffmpeg 拼接。

7. 最小场景模板

assets/scene-template.mjs:包含一个背景、一个使用 E.camera 缓动的摄像机推进、一个在第 1 拍弹出并使用 E.drop 缓动移动且带有发光效果的图标。运行 node scene.mjs --stills 写入校验帧,运行 node scene.mjs 会渲染出 out.mp4,在快速移动期间使用 16 个子帧,其他部分使用 8 个。

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

motion-sound-design

Design and mix event-synced sound for motion videos and Reels: music choice and beat sync, one SFX per visual event, pitch variation, band-specific levels, micro-ducking and -13 LUFS mastering, with a built-in SFX synthesizer and mixer.

motion-story-director

Turn an idea into a frame-exact, beat-locked motion video spec (hero object, object-handoff transitions, camera language, ban list) and lint any motion prompt for timing, count and density errors.

reels-edit-director

Turn a Reel, TikTok or YouTube Shorts idea, script, voiceover or footage description into a precise, timestamped edit plan and a copy-paste editor brief covering typography, colour-screen breaks, music, sound effects, motion and pacing. Also diagnoses drafts that feel boring, chaotic or lose viewers. Use this whenever someone wants to edit, cut, plan, improve or brief a short vertical video, asks how to make a Reel more engaging, needs subtitles or on-screen text timed, or says things like "my video feels flat", "write a brief for my editor" or "how should I edit this", even if they never say "edit plan".

reels-music-picker

Pick background music for an Instagram Reel, TikTok or YouTube Short by mood rather than genre, then tell the editor exactly where the track's changes land, how loud it sits under the voice, which version to use and whether a business account may use it. Includes beat and bar maths, a loudness checker and licensing guidance. Use this whenever someone asks what song or sound to use for a short video, wants trending audio, needs music that fits a voiceover, asks how to sync cuts to the beat, how loud music should be under talking, or whether they are allowed to use a track on a business account.

相关技能