SuperAPI AI 工具集

design-motion-audit

设计与创作

查看项目

更新于 10-15 17:26

技能介绍

用途:审计指定目标(仓库、路由、屏幕、组件或3D场景)的动效质量与实现安全性,返回按严重程度排序的整改清单,包含确切文件、严重级别、原因与具体修复方案。该技能负责诊断,实施修复时转交对应技能(expo-motion、web-three-r3f、r3f-scene-polish 或 gsap)。令牌与动效系统相关工作通过 references/design-system-tokens.md 和 scripts/scaffold_motion_tokens.py 处理。

用法:可先运行静态分析器收集线索,需对真实代码逐条核实后再报告: python3 scripts/detect_motion_stack.py <project-root> --pretty python3 scripts/audit_motion_system.py <project-root> --pretty 随后阅读被标记文件,按下述维度判断,并按严重程度从高到低返回清单。

审计维度:设计令牌与一致性(硬编码时长/缓动/弹簧 vs 令牌值,按意图命名,参见 references/motion-vocabulary.md);R3F/three.js/WebGL(useFrame 中 setState、缺少 delta-time、每帧分配、资源释放、DPR、阴影、后处理预算);Reanimated/Expo/手势(JS 线程逐帧工作、弃用的 runOnJS/runOnUI、worklet 误用、可中断性、布局与变换);交互物理感(速度感知释放、取消安全性);性能风险(帧预算、绘制调用、纹理与资源重量、模糊,参见 references/performance-accessibility.md);减少动态效果覆盖(每个相机移动、视差、循环、弹跳都需有减少动态效果分支并保留功能反馈);可访问性与可读性(运动中的文本清晰度);缺失的标志性动效机会。

评分依据 references/quality-gates.md,输出结构参考 references/report-template.md。任何涉及可见动效表面的变更都需补充运行时证据(references/runtime-verification.md),因为静态发现不足以证明场景能渲染或维持帧预算;浏览器工具可用时由 design-motion 插件的 motion-runtime-verifier 子代理执行。深度实现修复需将每条发现交给对应技术栈的技能。