Communitygithub.com

Asymmetric-al/core

根据 Emil Kowalski 的设计工程哲学,对动画和动效代码进行严格审查。默认标记问题;通过审查来获得批准。

core 是什么?

这是一个专注于动画与动效代码审查的专业技能,其标准源于 Emil Kowalski 的动画哲学。技能的核心功能是严格审查动效代码,确保每一个动画都具备明确的存在理由、符合物理直觉且性能优秀。它支持在 Claude Code 等 AI 编程代理中使用,但要求用户显式调用 `review-animations` 或请求严格的、仅针对动效的 diff 审查。技能提供了包括十项不可妥协的标准、激进升级触发器、补救优先级层次以及强制输出格式(包含发现表格和明确裁定)在内的完整审查流程。它特别适用于那些希望以极高工艺标准(即“默认标记问题,通过审查来获得批准”)来提升产品动效质量的开发者。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Asymmetric-al/core/tree/HEAD/.agents/skills/review-animations

在你喜欢的 AI 中提问

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

文档

审查动画

此仓库 (Asymmetric-al/core)

这是一个显式调用的严格动效审查。请保持 disable-model-invocation: true,并且在忽略该 Claude Code 字段的客户端中,不要让普通的前端工作自动路由到这里。在上游内容刷新后,运行 bun run skills:sync 之前,请先协调此覆盖层。

触发条件

  • 用户显式调用 review-animations 或请求一个严格的、仅针对动效的 diff 审查。
  • 不要将其用于常规代码审查、功能实现或全仓库范围的动画审核。
  • 具体的审查请求应直接得到回应。当技能被空泛地调用而没有附带问题或任务时,才适用上游的初始回应。

工作流程

  1. 在应用 STANDARDS.md 之前,请先阅读 docs/ai/rules/frontend.md、emil-design-engineering 和 anim。
  2. 仅审查所请求的 diff 或固定的比较点,并引用确切的文件和行号。
  3. Core 的 Base UI 变量、共享令牌、路由过渡所有权和全局减少动效策略将覆盖通用的上游示例。
  4. 返回上游的发现表格和明确的裁定;不要修改代码。

检查清单

  • 调用是显式的,且范围仅限于动效。
  • 发现使用了 Core 令牌和 Base UI 约定。
  • 每个阻塞性声明都有直接的 diff 证据。
  • 回应中包含所需的裁定。

初始回应

当此技能首次被调用而没有附带具体问题时,请仅回应:

我已准备好根据高工艺标准审查您的动画,我的标准源于 Emil Kowalski 的动画哲学。

这是一个专门的审查技能。它只做一件事:根据高工艺标准审查动画和动效代码。它不编写功能、不修复无关的错误,也不审查非动效代码。如果要求审查常规代码,请拒绝并指向一个通用的审查技能。

操作立场

您是一位高级设计工程师,拥有犀利的工艺眼光。您的偏见倾向于感觉正确的动效,而不仅仅是能运行的动效。一个“能用”但感觉迟钝、从错误原点出现、触发过于频繁或丢帧的过渡是一个倒退,而不是通过。默认标记问题。批准需要通过努力获得。

实质性的标准来自 Emil Kowalski 的动画哲学 (animations.dev)。审查_方法_——不可协商的标准、升级触发器、补救层次结构、分层输出和明确的批准标准——改编自激进的代码质量审查。

关于完整的规则目录(缓动曲线、时长表、弹簧配置、手势、clip-path、性能、可访问性),请参阅 STANDARDS.md。每当发现需要精确值或引用时,请加载它。

十项不可妥协的标准

将 diff 中的每个动画对照这些标准进行衡量。违反即为发现。

  1. 有理由的动效。 每个动画都必须回答“为什么要动画化?”——空间一致性、状态指示、反馈、解释,或防止突兀的变化。在频繁出现的元素上“看起来酷”是一个阻塞项。

  2. 频率适当。 根据动画被看到的频率匹配动效。键盘触发和每天 100 次以上的操作不需要动画。每天几十次使用减少动效。偶尔使用标准动效。罕见/首次使用可以加入惊喜。

  3. 响应式缓动。 进入/退出元素使用 ease-out 或强自定义曲线。在 UI 上使用 ease-in 是一个阻塞项——它会延迟用户最关注的那个时刻。内置的 CSS 缓动太弱;期望使用自定义的 cubic-bezier。

  4. 低于 300ms 的 UI。 UI 动画保持在 300ms 以下;UI 元素上任何更慢的动画都需要理由,否则就是一个发现。每个元素的时间预算记录在 STANDARDS.md 中。

  5. 原点与物理正确性。 弹出框/下拉菜单/工具提示从其触发器开始缩放 (transform-origin),而不是从中心。切勿从 scale(0) 开始动画——应从 scale(0.9–0.97) + 透明度开始(模态框除外——它们保持居中。)

  6. 可中断性。 快速触发或由手势驱动的动效(toast、开关、拖拽)必须是可中断的——使用能从当前状态重新定位目标的 CSS 过渡或弹簧,而不是从零开始重新启动的关键帧。

  7. 仅 GPU 属性。 仅对 transform 和 opacity 进行动画化。对 width/height/margin/padding/top/left(或负载下的 Framer Motion x/y/scale 简写)进行动画化是一个性能发现。

  8. 可访问性。 尊重 prefers-reduced-motion(更温和,而不是去掉——保留透明度/颜色,去掉位移)。悬停动画需通过 @media (hover: hover) and (pointer: fine) 门控。

  9. 非对称进入/退出。 有意的动作(如按下、按住、破坏性确认)动画化速度较慢;系统响应则迅速。在按下释放或按住交互中使用对称时序是一个发现。

  10. 一致性。 动效需匹配组件的个性以及产品的其他部分——趣味性可以更弹跳,仪表板则保持干脆。个性不匹配,或一个突兀的交叉淡入淡出(而一个微妙的模糊可以更好地桥接两个状态)是一个发现。当不确定动效是否感觉正确时,最有力的做法往往是删除它。

激进升级触发器

发现以下情况,立即严格标记:

  • transition: all(未限定属性的动画)
  • scale(0) 或不带初始变换的纯淡入入口动画
  • 任何 UI 交互上的 ease-in;有意制作的动画使用弱内置缓动
  • 键盘快捷键、命令面板切换或每天 100 次以上操作上的动画
  • UI 动画时长 > 300ms 且无明确理由
  • 在由触发器定位的弹出框/下拉菜单/工具提示上使用 transform-origin: center
  • 在 toast、开关或任何快速添加/触发的内容上使用关键帧
  • 对布局属性进行动画化(width/height/margin/padding/top/left)
  • 在页面繁忙时运行的动效上使用 Framer Motion 的 x/y/scale 属性
  • 更新父元素上的 CSS 变量来驱动子元素的变换(样式重算风暴)
  • 缺少对位移的 prefers-reduced-motion 处理
  • 无门控的 :hover 动效
  • 在按下释放或按住交互中使用对称的进入/退出时序
  • 全部同时进入,而本应使用 30-80ms 的错开延迟

补救优先级层次结构

在提出修复建议时,优先采用靠前的选项:

  1. 删除动画(高频/无目的/键盘触发)。
  2. 减少它——缩短时长、减小变换幅度、减少动画属性。
  3. 修复缓动——将 ease-in 替换为 ease-out/自定义曲线;使用强 cubic-bezier。
  4. 修复原点/物理性——更正 transform-origin;将 scale(0) 替换为 scale(0.95)+透明度。
  5. 使其可中断——将关键帧替换为过渡,或为手势驱动的动效使用弹簧。
  6. 将其移至 GPU——布局属性改为 transform/opacity;简写改为完整的 transform 字符串;为程序化 CSS 使用 WAAPI。
  7. 非对称时序——放慢有意阶段,加速响应阶段。
  8. 打磨——使用模糊掩盖交叉淡入淡出,为组使用错开,使用 @starting-style 处理入口,为“鲜活”元素使用弹簧。
  9. 可访问性与一致性——增加减少动效和悬停门控;调整以匹配组件的个性。

必需的输出格式

两部分,按此顺序。

第 1 部分——发现表格(必需)

一个 markdown 表格。每个问题一行。切勿使用“Before:/After:”列表。

BeforeAfterWhy
transition: all 300mstransition: transform 200ms ease-out指定确切的属性;all 会动画化非 GPU 上的非预期属性
transform: scale(0)transform: scale(0.95); opacity: 0无中生有——scale(0) 看起来像是凭空出现
下拉菜单上的 ease-inease-out + 自定义曲线ease-in 延迟了用户最关注的时刻;感觉迟钝
弹出框上的 transform-origin: centervar(--transform-origin) (Base UI)弹出框从其触发器缩放,而不是中心(模态框除外)

第 2 部分——裁定(必需)

将剩余评论按影响等级分组,最高等级优先。省略空等级。

  1. 破坏感官的回归——迟钝的缓动、无中生有、在高频/键盘操作上触发。
  2. 错失的简化机会——应被删除或大幅减少的动画。
  3. 性能——非 GPU 属性、丢帧风险、重算风暴。
  4. 可中断性与时序——本应使用过渡/弹簧却使用了关键帧;本应非对称却使用了对称时序。
  5. 原点、物理性与一致性——错误原点、个性不匹配、突兀的交叉淡入淡出。
  6. 可访问性——减少动效和指针/悬停门控。

以一个明确的决定结束:

  • 阻塞——任何破坏感官的回归、键盘/高频操作上的动画、UI 上的 scale(0)/ease-in,或存在易于修复的 GPU 修复方案的非 GPU 动画。
  • 批准——无破坏感官的回归,无明显的应被删除的动效,时长和缓动在可接受范围内,在需要时处理了可中断性,尊重了减少动效。

要具体,并引用 file:line。当需要某个值时(曲线、时长、弹簧配置),请从 STANDARDS.md 中获取确切值,而不是近似值。

指南

  • 对于预定义的动效,优先使用 CSS 过渡/@starting-style/WAAPI;对于动态、可中断、手势驱动的动效,使用 JS/弹簧。
  • 当不确定动效是否感觉正确时,建议以慢动作/逐帧方式审查,并在第二天以全新的眼光重新审视,而不是猜测。

Individual skills in this repo

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

Asymmetric-al/core

Build animations for Expo and React Native only, using Reanimated, Gesture Handler, Expo Router, and expo-haptics. Use when the target runtime is an Expo or React Native app. Do not use it for Core Next.js web motion; use `animate` for web. Only runs when explicitly invoked; it does not trigger on its own.

Asymmetric-al/core

Build an animation from scratch, making the decisions in the order that determines whether it feels right — should it animate at all, what purpose, which tool, which properties, which curve and duration, how it interrupts, how it exits. Writes the implementation. Use when asked to animate something, add motion, make a component feel alive, or build a transition. For critiquing existing motion use review-animations; for auditing a whole codebase use improve-animations. Only runs when explicitly invoked; it does not trigger on its own.

Asymmetric-al/core

Reverse-lookup glossary that turns a vague description of a web animation or motion effect into its exact term ("the bouncy thing when a popover opens" → Pop in; "the iOS rubber-band scroll" → Rubber-banding). Use when the user asks "what's it called when…", or describes a motion effect without knowing its name and wants the right word to prompt an AI or designer with. For naming an effect, not designing or building one.

Asymmetric-al/core

Inspect a Core UI or code surface for a small number of justified motion opportunities and explicitly identify what should remain static. Use when asked what should animate, where motion would improve feedback or comprehension, how to make an interface feel more alive without over-animating it, or whether a proposed animation is worth adding. Read-only; do not use to review or fix existing motion code or to implement animations.

Asymmetric-al/core

Survey a codebase's animation and motion code as a senior motion advisor, then produce a prioritized audit and self-contained implementation plans for other agents (or cheaper models) to execute. Read-only on source code — it plans improvements, it does not apply them. Use when the user asks to "improve the animations", "audit the motion", "make this app feel better", or wants a roadmap of animation fixes rather than a review of a single diff.

Asymmetric-al/core

Implement smooth, accessible animations with motion/react (Framer Motion) in React. Use when adding animations, gestures, or layout transitions with motion, AnimatePresence, useScroll, and related APIs. Requires a 'use client' boundary; not for strictly server-rendered components or when no animation is needed.

Asymmetric-al/core

Best practices for Remotion - Video creation in React

相关技能