构建动画
本仓库 (Asymmetric-al/core)
在 Core 的设计工程和操作运动契约之后,使用此技能实现 Web 动效。在上游刷新后,在运行 bun run skills:sync 之前协调此覆盖层。
触发条件
- 构建或重写 Web 动画、过渡或微交互。
- 不要用于 Expo/React Native (
animate-expo)、代码库审计 (improve-animations) 或严格的纯动效审查 (review-animations)。
工作流程
- 首先加载
docs/ai/skills/emil-design-engineering/SKILL.md和docs/ai/skills/anim/SKILL.md。 - 重用现有的 Core 运动令牌和 Base UI 原语。不要复刻持续时间、缓动或引入 Radix API。
- 在
packages/ui/styles/globals.css中的全局基线中保持减少动效。 - 如果任务需要 toast、抽屉、菜单或下拉菜单,重用
@asym/ui/ Base UI。除非用户明确询问使用哪个库,否则不要调用pick-ui-library。
检查清单
- 动画有目的,并尽可能使用 transform/opacity。
- Core 令牌、Base UI 和
anim优先于说明性上游值。 - 共享工具函数和
@asym/lib/motion-presets优先于新的时间常量。
一个构建技能。它只做一件事:将对动效的请求转化为能够通过严格审查的实现。它不审计代码库(那是 improve-animations),不审查差异(那是 review-animations),不寻找可以动画的地方(那是 find-animation-opportunities),也不为 React Native 构建(那是 animate-expo)。
操作姿态
你是一位正在自己构建动画的高级设计工程师。标准是 Emil Kowalski 的动画哲学——与 review-animations 执行的标准相同。编写代码使其能够一次性通过审查。
两种失败模式,第一种更糟:
- 对不应该动画的东西进行动画。 下面的门控有时会产生零行代码。这是成功,不是逃避。
- 用错误的成分动画正确的东西——在进入时使用
ease-in,scale(0),在 toast 上使用关键帧,使下拉菜单感觉迟钝的持续时间。
永远不要将动效选项作为菜单呈现。做出决定,用一行说明推理,然后编写代码。
硬性规则
- 按顺序运行序列。 第 1 步和第 2 步是所有一切的门控。在你知道是否应该动画之前,不要考虑曲线。
- 没有近似值。 每个曲线、持续时间和弹簧配置来自下面的表格。永远不要因为看起来很熟悉而发明
cubic-bezier(0.4, 0, 0.2, 1)。 - 扩展代码库的令牌,不要复刻它们。 如果
--ease-out-soft或持续时间令牌已存在于packages/ui/styles/globals.css中,请使用它。添加并行系统是一种缺陷。 - 减少动效和悬停门控与动画一起发布,而不是作为后续。
- 最便宜的有效工具。 不要为淡入效果安装动效库。
构建序列
1. 这个应该动画吗?
| 频率 | 决策 |
|---|---|
| 每天 100+ 次(键盘快捷键,命令面板切换) | 永远不要动画。在此停止。 |
| 每天数十次(悬停效果,列表导航) | 仅近乎不可察觉——快速而微妙,或者没有 |
| 偶尔(模态框,抽屉,提示框) | 标准动画 |
| 罕见/首次(引导,成功,庆祝) | 愉悦预算在此处 |
键盘发起的操作是取消资格,而不是判断。 Raycast 没有打开/关闭动画——这对于每天打开数百次的东西是正确的。
如果请求未通过此门控,请直说并不要编写动画。提供无动效替代方案(即时状态更改,静态提示)。
2. 目的是什么?
在继续之前,用以下词语之一命名它:
- 反馈 — 确认界面听到了用户的指令
- 空间一致性 — 显示某物来自何处或去往何处
- 状态指示 — 使状态变化可辨认
- 防止突兀变化 — 桥接否则会瞬间移动的内容
- 解释 — 演示某物如何工作(仅限营销/引导)
- 愉悦 — 仅允许在罕见/首次层级
无法命名?就不要构建。