以 skill 自身的术语
一个顾问型 skill,以资深动效顾问的身份审查代码库中的动画与运动相关代码,返回一份优先级排序的审计结果,以及供其他 Agent 执行的独立实施方案。它将高能力模型用于判断——阅读动效表现、决定哪些值得修复、撰写规范——而将执行工作交给任何 Agent,包括更廉价的模型。
审计依据 AUDIT.md 中的八大类别运行,方案格式来自 PLAN-TEMPLATE.md。它对源代码是只读的:唯一会写入的文件位于 plans/ 目录下,命名为 NNN-short-slug.md,并标注当前提交。它不会审查单个 diff,也不会实现修复。
它产出什么
- 一份经过审核的发现事项表,按影响力排序,每一行标注为 HIGH(破坏体验,例如 UI 缓动错误、键盘或高频操作上的动画、掉帧、scale(0))、MEDIUM 或 LOW。
- 另有一份单独的简短清单,列出两到四个被错过的机会——那些本该有动画却没有的地方,视为增补而非纠正。
- 在 plans/ 目录下,为每个选定的发现事项建立一个方案文件,采用单调递增编号和简短 slug 命名,以尊重已有的方案。
- 一份 plans/README.md,记录推荐的执行顺序、方案之间的依赖关系,以及状态列。
工作方式
- 01先勘察动效表现
在做出任何判断之前,先梳理技术栈、动效库、动效所在位置、现有的缓动与时长 token、产品的个性,以及哪些动画元素被频繁触发、哪些很少被触发。
- 02依据八大类别进行审查
发现的问题按用途与频率、缓动与时长、物理性与来源、可中断性、性能、可访问性、一致性与 token、以及错失的机会归类——包含精确数值的目录见 AUDIT.md。
- 03分派只读子 Agent
超出小型仓库规模后,审查会被并行化,每个类别或每个应用区域分配一个子 Agent。
- 04上报前先核实
亲自重新阅读每条发现所引用的代码,剔除任何属于故意设计、归因错误、重复或豁免的情况——比如模态框上居中的 transform-origin,或营销页面上刻意放慢的时长。
- 05呈现一张按杠杆排序的表格并停止
发现的问题汇总到单一表格中,包含严重程度、类别、位置、发现内容与修复摘要,按收益相对成本排序。
- 06为能力最弱的执行者编写计划
每条被选中的发现都会形成一份计划,其中包含精确的文件路径、当前代码摘录以及精确的目标值,编写方式让一个没有上下文、没有判断力的模型也能照做而不需猜测。