Communitygithub.com

divyanshu-iitian/agent-website-design-skills

为 React 和 Web 界面设计、实现、审核或修复有目的性的动效,包括 GSAP 时间线、滚动编排、微交互以及可选的 Three.js 场景,并包含清理、响应式行为、减少动效支持和浏览器验证。

agent-website-design-skills 是什么?

该技能专注于在 React 和 Web 界面中应用有目的性的动效,核心原则是通过动效解释层级、因果关系、状态变化和空间关系,而非简单的视觉装饰。它支持使用 CSS、React 动画库、GSAP 和 Three.js 等多种技术栈,并能根据需求选择最轻量的实现方式。技能文档要求开发者遵循严格的工作流程,包括识别任务、定义动效层级、设置时长和缓动参数、以及进行性能和可访问性测试,特别强调清理机制、减少动效支持(reduced-motion)和响应式行为。该技能适用于 Claude Code 等 AI agent 平台,帮助开发者系统化地规划、实现和交付高质量的 Web 动效,最终交付物包括动效意图说明、编排逻辑、实现代码、性能合约和可访问性证明。

兼容平台~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/divyanshu-iitian/agent-website-design-skills/tree/HEAD/product-motion-design

在你喜欢的 AI 中提问

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

文档

产品动效设计

使用动效来解释层级、因果关系、状态和空间关系。不要仅仅为了让页面看起来昂贵而为页面添加动效。

工作流程

  1. 识别用户任务、核心动作、状态变化以及动效可以改善理解的时机。
  2. 定义动效层级:页面进入、区块展示、组件过渡、反馈和氛围动效。
  3. 选择最轻量的合适机制:简单状态使用 CSS,组件生命周期使用现有的 React 动画库,协调时间线或滚动使用 GSAP,仅在有真实 3D 需求时使用 Three.js。
  4. 在实现之前确定时长、缓动函数、距离、交错、中断和减少动效的规则。
  5. 将动画选择器限定在组件根范围内。插件只注册一次,在销毁时清理时间线、观察器、监听器、帧、几何体、材质、纹理和渲染器。
  6. 保持布局稳定。尽可能地对 transform 和 opacity 进行动画;避免持久的主线程工作和宽泛的 transition: all。
  7. 针对触屏、窄容器、低功耗设备和隐藏标签页调整密度和编排。
  8. 在移动端和桌面端宽度下验证真实像素、交互、调整大小行为以及非空画布输出。

动效规则

  • 交互反馈是立即的;装饰性动效让位于输入。
  • 滚动动画必须在不依赖 JavaScript 的情况下保留阅读顺序和可用内容。
  • 重复列表使用克制的交错和上限;它们不会在每一次微小滚动时重播。
  • 3D 场景限制像素比率、在隐藏时暂停、从实际容器调整大小,并提供静态的减少动效帧。
  • 主题变更必须更新 3D 材质和背景,同时确保焦点对象不会消失。
  • 不要对纯触屏体验或需要精确操作的控制项添加光标跟随效果。

交付契约

返回或实现:

  1. 动效意图 - 每个动画传达什么信息。
  2. 编排 - 触发条件、顺序、时间安排和中断行为。
  3. 实现 - 使用现有技术栈的限域代码。
  4. 性能合约 - 清理、设备适配和渲染预算。
  5. 可访问性 - 减少动效和无 JavaScript 行为。
  6. 证明 - 浏览器的观察结果或相关状态和视口下的截图。

参考资料

在交付 GSAP、滚动相关或 Three.js 工作之前,请阅读 references/motion-checklist.md。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相关技能