用途
review-animations 是 playful-design/router 下的一个专用评审技能,只做一件事:对照高工艺标准审查动画与动效代码。它不编写功能、不修复无关缺陷、不评审非动效代码;如果被要求做通用代码审查,按设计应拒绝并引导至通用评审技能。
首次被调用且用户没有提出具体问题时,该技能只回应一句说明:它已准备好依据 Emil Kowalski 的动画理念所形成的高工艺标准来评审动画,在用户提问前不提供其他信息。
主要能力
其评审基调是资深设计工程师视角,偏好“感觉正确”的动效,而非仅仅“能运行”的动效。一个过渡虽然能工作,但显得迟钝、从错误的原点出现、触发过于频繁或掉帧,都会被视作回归而非通过。默认倾向于指出问题,通过结论需要靠实现赢得。
核心实质标准来自 Emil Kowalski 的动画理念(animations.dev);评审方法中的不可协商标准、升级触发条件、修复优先级、分级输出和明确的通过标准,则改编自严厉的代码质量评审做法。完整规则目录涉及缓动曲线、时长表、弹簧配置、手势、clip-path、性能和无障碍,记录在 STANDARDS.md 中,当某条发现需要精确数值或引用时加载。
十项不可协商标准
代码差异中的每个动画都按以下标准衡量,违反即视为一项发现:
- 有理由的动效:每个动画都必须回答“为什么要动画”——空间一致性、状态指示、反馈、解释或避免突兀变化。对高频出现的元素仅因“看起来酷”而动画属阻断项。
- 频率适配:动效强度与出现频率匹配。键盘触发和每天 100 次以上的操作不加动画;每天数十次的操作减少动效;偶尔出现的用标准动效;罕见或首次出现的可以带点惊喜。
- 响应式缓动:进入/退出元素使用 ease-out 或强自定义曲线。UI 上使用 ease-in 属阻断项,因为它延迟了用户最关注的时刻。内置 CSS 缓动太弱,应使用自定义 cubic-bezier。
- UI 动效低于 300ms:UI 动画保持在 300ms 以内;更慢的 UI 元素需要理由,否则视为发现。各元素的具体时长预算见 STANDARDS.md。
- 原点与物理正确性:弹出层、下拉菜单、工具提示应从触发元素缩放(transform-origin),而非中心。不要从 scale(0) 动画——从 scale(0.9–0.97) 加透明度开始(模态框例外,保持居中)。
- 可中断性:快速触发或手势驱动的动效(toast、开关、拖拽)必须可中断——使用从当前状态重定向的 CSS 过渡或弹簧,而非从零重新开始的关键帧。
- 仅 GPU 属性:只动画 transform 和 opacity。动画 width/height/margin/padding/top/left(或在负载下使用 Motion 14.2 之前版本的 x/y/scale 简写)属性能问题。
- 无障碍:尊重 prefers-reduced-motion(更温和而非完全关闭——保留透明度和颜色,去掉位移)。悬停动画需置于 @media (hover: hover) 和 (pointer: fine) 之后。
- 进出不对称:刻意操作(按压、长按、破坏性确认)动画较慢;系统响应则迅速。按压释放或长按交互使用对称时序属发现。
- 一致性:动效匹配组件个性与产品其余部分——活泼的可以更有弹性,仪表盘保持干净利落。个性不匹配,或本可用细微模糊衔接两个状态却用了突兀交叉淡入,属发现。不确定动效是否合适时,最有力的做法往往是删掉它。
激进升级触发条件
以下情况一经发现即严厉标记:
- transition: all(无界属性动画)
- scale(0) 或没有初始 transform 的纯淡入进入
- 任何 UI 交互上的 ease-in;刻意动画上使用弱内置缓动
- 键盘快捷键、命令面板开关或每天 100 次以上操作上的动画
- UI 时长超过 300ms 且未说明理由
- 触发锚定的弹出层/下拉/工具提示使用 transform-origin: center
- toast、开关或任何快速添加/触发内容使用关键帧
- 动画布局属性(width/height/margin/padding/top/left)
- Motion 14.2 之前的 x/y/scale 属性,或页面繁忙时运行的布局动画
- 在父元素上更新 CSS 变量以驱动子元素 transform(样式重算风暴)
- 位移动效缺少 prefers-reduced-motion 处理
- 未加门控的 :hover 动效
- 按压释放或长按交互使用对称进/出时序
- 本应使用 30–80ms 交错却全部同时进入
修复偏好层级
提出修复建议时,优先选择靠前的做法:
- 删除动画(高频/无目的/键盘触发)
- 减少——更短时长、更小 transform、更少动画属性
- 修正缓动——ease-in 换成 ease-out/自定义曲线,使用强 cubic-bezier
- 修正原点/物理性——纠正 transform-origin;用 scale(0.95)+opacity 替代 scale(0)
- 使其可中断——关键帧改为过渡,或手势驱动动效用弹簧
- 移到 GPU——布局属性改为 transform/opacity;Motion 14.2 前简写升级或改用完整 transform 字符串;编程式 CSS 用 WAAPI
- 不对称时序——放慢刻意阶段,加快响应
- 打磨——用模糊掩盖交叉淡入、为组添加交错、进入用 @starting-style、为“有生命”的元素用弹簧
- 无障碍与一致性——添加 reduced-motion 和悬停门控;调整以匹配组件个性
使用方式
技能要求输出分为两部分,且按此顺序:
第一部分——发现表(必需):单张 markdown 表格,每行一个问题,从不用“修改前/修改后”列表。表格列包括 Before、After、Why,并给出具体属性替换示例,例如将 transition: all 300ms 改为 transition: transform 200ms ease-out,说明需指定确切属性;将 transform: scale(0) 改为 transform: scale(0.95); opacity: 0,说明没有东西能从虚无中出现;下拉菜单上的 ease-in 改为 ease-out 加自定义曲线;弹出层的 transform-origin: center 改为 var(--transform-origin)(Base UI),说明弹出层从触发元素缩放而非中心(模态框例外)。
第二部分——结论(必需):按影响层级从高到低分组其余评论,省略空层级。层级依次为:破坏感觉的回归;错过的简化;性能;可中断性与时序;原点、物理性与一致性;无障碍。最后给出明确决定:阻断(存在任何破坏感觉的回归、键盘/高频操作上的动画、UI 上的 scale(0)/ease-in,或有一个简单 GPU 修复方案的非 GPU 动画);通过(没有破坏感觉的回归、没有明显应删除的动效、时长和缓动在界限内、需要时可中断性已处理、reduced-motion 得到尊重)。要求具体并引用 file:line;需要数值(曲线、时长、弹簧配置)时从 STANDARDS.md 中取精确值而非近似。
技能还建议:预定动效优先使用 CSS 过渡、@starting-style、WAAPI;动态、可中断、手势驱动的动效用 JS/弹簧。不确定动效是否合适时,建议以慢动作/逐帧方式并在第二天用新鲜眼光复查,而不是猜测。
适用场景与限制
适用于审查动画与动效相关代码,包括过渡、缓动、时序、原点、性能和无障碍等方面的工艺问题。限制在于它只承担动效评审这一项职责,不编写功能、不修复无关缺陷、不评审非动效代码;对其他类型代码审查请求应转向通用评审技能。关于该技能的安装方式、平台支持和收费情况,所给资料未提供。