Communitygithub.com

mograf 动作准则精简版

mograf 动作准则的免费子集。在编写或编辑任何动画代码(HyperFrames、GSAP、CSS、Remotion、Three.js、Lottie)或任何动态图形之前,请先加载它。它涵盖了命名缓动令牌、视频持续时间带、编排规则以及一个“禁止清单”,能消除最常见的模板化/AI 生成的低质量动作。

mograf 动作准则精简版 是什么?

Motion Craft Lite 是一套遵循 mograf 动作准则精简版的动作设计规则,旨在帮助开发者和 AI 代理创建看起来经过精心设计而非模板化的动态图形。它完全独立于具体平台,适用于 GSAP、CSS、Remotion、Three.js、Lottie 以及 HyperFrames 等几乎所有动画库。其核心内容包含一套严格且命名的缓动曲线令牌(如 `mg.enter`、`mg.settle` 等)、基于视频节奏的持续时间指南、以“单次引导”和“触摸链”为原则的编排规则,以及一份详尽的“禁止清单”,列出了常见的设计错误,例如默认的淡入效果、`scale(0)` 入场以及单调的字体。该准则强制要求在一个作品中至少使用三种不同的缓动风格,并强调运动必须承载叙事意图。最后还提供了进行最终质量自查的 checklist,以及针对分辨率、安全区和帧率的视频基础规范。

兼容平台~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Parrass/mograf-public/tree/HEAD/plugins/mograf/skills/motion-craft-lite

在你喜欢的 AI 中提问

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

文档

motion-craft-lite

这些是让动作看起来经过设计而非模板化的内部规则。如果某个上游技能或库默认值与缓动、时序或编排规则相冲突,请遵循本文件。

0. 唯一测试

在编写任何 tween 之前,先问自己:这个动作意味着什么? 如果答案是“它让东西出现”,请停止。动作应当承载想法(挤压、倾倒、破碎、堆叠、组装、穿透),或者引导视线到下一个重要的事物。

1. 缓动令牌

在每段合成中注册一次,并按角色使用它们:

gsap.registerPlugin(CustomEase);
CustomEase.create("mg.enter",  ".20,.75,.34,.94"); // 入场:急剧进入,干净着陆
CustomEase.create("mg.settle", ".00,.65,.51,.99"); // 着陆、锁定、计数:快速输出,长时间稳定
CustomEase.create("mg.travel", "1,.49,0,.55");     // 长距离 A→B 移动(S 曲线,中点陡峭)
CustomEase.create("mg.depart", ".33,0,.12,1");     // 相机/元素从静止状态离开
CustomEase.create("mg.exit",   "1,.02,.54,.42");   // 退出:加速远离
CustomEase.create("mg.cut",    ".15,.85,.95,.05"); // 被剪切打断的移动,从不稳定
CustomEase.create("mg.ui",     ".23,1,.32,1");     // 视频中的 UI 微动作
CustomEase.create("mg.inout",  ".77,0,.175,1");    // 屏幕上的变形和重新构图

相同的曲线作为 CSS cubic-bezier(...) 在 CSS 和 WAAPI 中同样有效。在 Remotion 中,使用 Easing.bezier(...)。

两个陷阱:

  • mg.settle 起始于垂直切线:如果旋转或相机移动从静止(点击后、暂停后)开始,它会在单帧内产生抖动。此时请使用 mg.depart。
  • mg.travel 是 S 形,中点切线近乎垂直,而非近乎线性:它在两端几乎不动,而在中间跳跃(在 0.75 秒的相机移动中,28% 的行程会落在单帧内)。仅在长距离移动(≥ ~1.2 秒)中使用它;对于短相机移动,使用 mg.inout 或烘焙弹簧,当从静止离开时使用 mg.depart。

这是完整的允许列表:mg.* 令牌加上以下内置缓动(如果需要,还可以使用阻尼比在 0.80–0.85 之间的烘焙弹簧)。其他任何缓动(power2.out、sine.*、power4.in 等)都不在调色板内:

  • power3.out:主力。
  • expo.out:剪切后的入场。
  • power3.in:进入剪切时的退出。
  • power4.out:强硬的相机/英雄着陆。
  • power2.inOut:相机重新定位。
  • none:仅用于循环、跑马灯、机械运动和恒定速度的路径移动。

规则:

  • 每个作品至少使用 3 种缓动角色。同一场景中同时运行的两个 tween,除非它们作为一个锁定组一起移动,否则不得共享同一缓动:一个 tween 影响多个目标,或者一个带 defaults 的子时间线,都算作一个缓动使用者。
    tl.fromTo([".card", ".card-label"], { y: 60 }, { y: 0, duration: 0.7, ease: "mg.settle" }, T); // 一个组
    const lockup = gsap.timeline({ defaults: { ease: "mg.enter", duration: 0.6 } });           // 一个组
    lockup.fromTo(".logo", { scale: 0.94 }, { scale: 1 }, 0).fromTo(".wordmark", { xPercent: -8 }, { xPercent: 0 }, 0.08);
    tl.add(lockup, T + 0.3);
    tl.fromTo(".kicker", { yPercent: 105 }, { yPercent: 0, duration: 0.5, ease: "mg.depart" }, T + 0.3); // 并发 → 自己的缓动
    
  • 统计缓动使用者,而非 tween 数量。一个锁定组计为一次。一个由 setter 驱动的代理(对 {t} 或相机对象的一个 tween,其 setter 重绘场景)计为一个使用者,缓动在其 tween 上;在其 paint 函数内部评估的缓动不单独计算,因此许多同时的接触点可以从一个驱动器中运行。并发的驱动器仍然需要不同的缓动。
  • 在润色时交换缓动可能会产生新的冲突。每次交换后,重新检查哪些 tween 在时间上重叠以及它们使用了什么。
  • 交错分布的缓动(stagger: { each, ease })是时序偏移,而非 tween 缓动;它们不计数。
  • 英雄空间移动永远不使用 linear、power1、CSS ease 或 ease-in-out。
  • 过冲是可选的:每个作品最多一次,最多 6%,且仅用于变换。back.out、elastic 和 bounce 被排除,除非需求要求一种有趣的风格。

2. 持续时间(视频,非 UI)

事物持续时间
微动(刻度、图标状态)0.15–0.3 s
元素入场0.4–0.8 s
英雄到达0.8–1.5 s,然后保持
退出约比其入场快 30%(0.25–0.5 s)
相机移动1.0–2.5 s,每场景一次,比物体更缓和
硬切 / 节拍命中0 s(tl.set);给命中添加缓动会破坏它
阅读保持≥ 0.5 s + 0.3 s × 单词数
最终标志 / CTA 保持≥ 0.8 s,完全静止,可作为缩略图
  • 节奏。
    • 故事板中最慢的节拍至少是最快的 3 倍(节拍指故事板的一行,而非其内部的子 tween)。
    • 在所有 tween 中,最长 ÷ 最短应至少为 4。
    • 在开始构建前命名节奏,例如 fast-fast-SLOW-cut-hold。
  • 距离和质量。 距离越长或质量越大,持续时间越长。
  • 开场。 第一次移动在 0.1–0.3 秒内开始,英雄在 0.5 秒内可见。
  • 社交媒体。 第 0 帧已经构图完成并可读。永远不要从黑色中淡入。

3. 编排

  1. 一次一个引导。 在每一时刻,眼睛有且只有一个事物需要跟随。
  2. 引导/跟随偏移。 支撑物滞后于引导物 2–8 帧(紧凑)或 4–14 帧(表现性),且幅度更小。
  3. 接触链。 下一个元素在前一个元素到达或接触它时开始,而不是基于任意计时器。
  4. 不透明度是次要的。 它在移动开始后开始,在稳定前结束。不透明度本身从来不是入场。
  5. 交错。 每项 50–120 毫秒,使用缓动或从有意义原点(中心、焦点、阅读顺序)开始。整个交错持续时间不超过 0.6 秒。
  6. 在后半段揭示。 不要将场景的主要内容放在前半段。最后 50% 仍应添加信息。
  7. 构建 → 稳定 → 保持。 每个移动都以保持结束。没有停顿的动作就是噪音。
  8. 退出比入场更简单、更快。 在序列内部,过渡本身就是退出。
  9. 方向有意义。 向前/下一个向左或向上;向后/关闭向右或向下。保持一致性。

4. 永远不要这样做

  • 默认的淡入效果。 任何东西上的 opacity 0→1, y 20–40→0, power2.out。文本使用蒙版、分割、深度、剪切或灯光掠过。线条蒙版上升(在 overflow-hidden 行内 yPercent → 0),并在接近时也进行模糊处理,起始 yPercent ≥ 130;在 105 时,模糊光晕会在线条移动前泄漏到蒙版中。在构建时使用 gsap.set 隐藏蒙版线条,而不是 tl.set(…, 0)(后者可能欺骗对比度审计,使其采样到未隐藏的线条)。
  • scale(0) 入场。 例外:圆点、粒子和蒙版圆圈。否则从 0.9–0.97 开始。
  • 统一时序。 相同的持续时间,或统一的 0.1 秒交错。
  • 空闲呼吸。 空闲元素上的缩放或不透明度来回脉冲。相反,使用静止、一个有动机的环境背景,或一个有最终姿态的相机漂移。
  • 场景“滑动”。 淡出,然后淡入。
  • 深色背景上的纯 #000 或线性渐变。 H.264 会对它们产生色带。使用径向渐变和少量颗粒。
  • 廉价装饰。 表情符号、库存图标、漂移的渐变斑点、堆叠的玻璃态、霓虹灯布满一切、彩虹调色板。使用 2–3 种色调加中性色,强调色占画面 10% 或更少。
  • 单一字体作为设计。 Inter、Roboto、Poppins、Playfair、EB Garamond、Bodoni Moda、Syne、Fraunces。选择一个富有表现力的 OFL 显示字体,并设置紧凑的字距(−0.02 到 −0.05 em,行高 ~1.05),并具有粗细对比(300 vs 900)。
  • 打字机 + 闪烁光标作为主要创意, 除非作品本身是关于打字或代码的。
  • 只是停止或淡出的结尾。 设计最后一帧并保持它。

提交前的自我检查:

  1. 你能用 15 个词表达这个创意吗?
  2. 随机抽取一帧能否当作海报使用?
  3. 是否至少有 3 种缓动角色,并按角色使用?
  4. 是否有一个剧烈的速度对比(非常慢,然后非常快)?
  5. 每个过渡是否有动机?

5. 视频基础

  • 1080p 下的字体大小。 标题 64–120 px(在信息流中 90 px 或更大)。正文 32 px 或更大。
  • 层级。 英雄元素占据宽度的 60–80%。缩放对比至少为 5:1。留出 30–50% 的负空间(居中的标志或结束卡帧可能达到 75%),并锚定到网格或边缘。
  • 安全区域。
    • 16:9:将文本保持在 90% 标题安全区域内。
    • 9:16:顶部 14%、底部 20% 或右侧 12% 内无文本。
    • 1:1 和 4:5:6% 边距。
  • 帧率。
    • 30 fps 是社交媒体的默认设置;UI 演示和快速打字使用 60 fps。
    • 永远不要在一个作品中混合帧率。
    • 全帧横向平移(无模糊)需要 5–7 秒,否则会出现抖动。
  • 确定性(HyperFrames / 任何帧渲染器)。
    • 一个暂停的时间线。使用带绝对值的 fromTo。
    • 仅对变换、不透明度、滤镜和剪裁路径进行 tween。无 CSS 过渡。
    • 无 Math.random 或 Date.now;使用种子化的 PRNG。
    • 从本地 @font-face 文件加载字体,并仅在 document.fonts.ready 之后分割文本。
    • 对同一属性堆叠的 fromTo tween,需要在每个 vars 对象中字面写入 immediateRender: false(linter 会查找字面键,而不是添加它的辅助函数)。
    • 计算出的变换、canvas 和 three.js 渲染来自时间线时间,通过 setter 驱动的代理,而不是 onUpdate(回调在 seek 时被抑制)。

这是 mograf 准则(MIT 许可证)的免费子集。付费库位于 mograf.si,增加了导演管线、专业技能(字体、过渡、深度、声音)和后期处理堆栈。每个作品都附带其提示、技能、源代码和副本。如需质量把关,请将此技能与免费的 motion-review 配合使用。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相关技能