用途:对现有代码库做动效审计并产出优先级修复计划,而非逐次 diff 判定。默认只读,只创建或编辑 plans/NNN-short-slug.md 与 plans/README.md;若 plans/ 已被占用则写入 animation-plans/。被要求“直接修”时应拒绝并交付计划。
主要能力:先侦察技术栈、package.json 中实际使用的动效库(motion/framer-motion、React Spring、GSAP、WAAPI、纯 CSS)、组件库(Radix、Base UI、shadcn/ui)与动效 token 存放位置,并建立动画表面使用频率图;再按 audit.md 的八类审计,输出按杠杆率排序的发现表,每行含严重度(HIGH/MEDIUM/LOW)、类别、位置、发现与修复摘要;随后为选中项生成自包含计划,含精确路径、当前代码、目标 cubic-bezier 与时长、仓库内范例,并用 git rev-parse --short HEAD 标注提交,附可观察的“手感检查”。
使用方式:裸调用跑完整流程;quick/deep 调整深度;指定类别名(如 performance、accessibility、easing)限定侦察加该类;plan <description> 跳过审计直接写一个计划;reconcile 对照当前代码复核 plans/,标记 DONE、刷新行号、淘汰失效发现。
适用场景:需要理解代码库既有动效体系、决定哪些动效值得修、并把修复规格化交给任意执行者时。
限制:不修改源码;不给出 Block/Approve 判定(属 motion-review);不提议尚不存在的动效(属 motion-opportunities);发现表后须停下等待用户选择;每条发现须在 file:line 复核,模态框 transform-origin: center、reduced-motion 块内 transition: all 等属豁免;子代理按类别而非按文件拆分,quick 0–1 个、standard ≤4 个、deep ≤8 个。