寻找动效机会
通过克制来发现高价值的动效。没有幸存机会的结果也是有效的;日常使用的产品 UI 通常受益于更少的动效。
触发条件
- 当被问及哪些部分应该动、动效如何改善原本静态的界面、或哪些提议的动效想法值得追求时使用。
- 请勿用于修复当前动画、审查动效差异或实施建议;将这些后续工作引导至现有的动效技能。
权限和边界
- 在评判表面之前,先阅读
docs/ai/rules/frontend.md,然后是docs/ai/skills/emil-design-engineering/SKILL.md和docs/ai/skills/anim/SKILL.md。 - Core 的令牌、Base UI 原语、共享工具、路由转换边界、触摸门控和减少动效基线覆盖通用示例。
- 使用
improve-animations审计或规划现有动效的修复,使用review-animations仅用于明确请求的动效差异审查。如果已批准的实现需要motion/react的详细信息,稍后使用motion。 - 此技能仅报告证据和配方。活动期间不得编辑源代码、编写计划文件、安装工具或更改依赖项。
候选检查
每个建议必须通过全部五项检查:
- 频率和输入: 拒绝在键盘触发、高频或信息密集的交互上使用装饰性动效。频繁的反馈可能使用现有的近乎不可察觉的 Core 工具;它不是新的机会。
- 目的: 指定一个目的:反馈、空间连续性、状态清晰度、防止突变、解释或罕见的愉悦。“看起来很酷”不合格。
- 用户价值: 动效必须使因果、层次、进度或状态更容易理解。它不得延迟对内容或操作的访问。
- 现有所有权: 拒绝已经由
Button、Base UI 叠加层、共享悬停/按压工具或RouteMainViewTransitionBoundary提供的动效。切勿在其之上叠加第二个入场或悬停语法。 - Core 可行性: 配方必须使用现有的运动令牌/预设,避免使用布局驱动属性,保持可被中断(在状态可反转的情况下),保留减少动效行为,并将悬停动效限制为精细指针。
工作流程
- 侦察。 定义路由/组件范围、产品特性、输入方法、频率、当前动效拥有者以及性能/可访问性约束。在可用时检查运行中的 UI;否则说明仅凭代码证据的限制。
- 扫描接缝。 寻找突然的偶发状态变化、不清晰的空间关系、缺失的进度/反馈、罕见的空白/成功/入门时刻以及手势转换。同时检查最可能过度动画化的位置,以便报告包含有意义的拒绝。
- 筛选候选。 重新阅读每个引用的位置,应用所有五项检查。拒绝重复项、推测性想法以及已经有意设计的内容。
- 指定幸存者。 报告最多五个机会,按影响排序。指明要复用的现有 Core 令牌、预设、工具或原语。不要发明具体的持续时间、缓动函数、缩放或并行动画系统。
- 报告约束。 包含两到五个被拒绝的候选者以及拒绝它们的具体检查项。如果没有幸存者,说明界面应保持原样。
高价值接缝
- 偶尔出现、消失或突然切换的内容或状态。
- 一个面板或对象,其来源/目的地不明确,且尚未被 Base UI 原语或共享路由过渡层拥有。
- 进度或完成反馈,其中动效可以阐明因果。
- 罕见的一次运行、空白、成功或庆祝时刻,值得带来愉悦。
- 需要连续性、可中断性或动量的手势驱动表面。
通常拒绝命令面板、键盘快捷键、密集表格、实时图表、常规列表导航、页面加载编排、全面滚动揭示以及用户正在阅读的数据上的装饰性移动。共享按钮已有按压反馈;共享叠加层和路由已有自己的动效语法。
必需的报告
动效机会
| # | 位置 | 当前接缝 | 目的 | 频率 | Core 兼容配方 |
|---|
每行需要精确的 file:line 证据和一个现有的 Core 机制。标记任何需要现场感受检查的内容,而不是假装代码能证明品味。
被拒绝的候选者
| 位置 | 考虑的候选者 | 拒绝项 | 为何静态更好 |
|---|
裁决
说明表面实际需要多少动效,如果存在的话,最高影响力的幸存者是什么,以及是否需要后续的 improve-animations plan <description>。
检查清单
- 检查的范围、频率、输入和当前动效拥有者清晰明确。
- 每个幸存者都通过了目的、价值、所有权和可行性检查。
- 建议复用了 Core 令牌/原语,没有重复动效。
- 考虑了性能、触摸、键盘、减少动效和可中断性。
- 报告中最多有五个机会,并包含明确的被拒绝候选者。
- 发现引用了确切的文件/行,并区分代码证据和感受检查。
- 检查期间未更改源代码、计划、依赖项或运行时文件。
来源
请参阅 references/upstream.md 以了解审阅的上游来源、MIT 许可证、Core 适配以及刷新工作流程。