Communitygithub.com

divyanshu-iitian/agent-website-design-skills

針對 React 與網頁介面,設計、實作、審查或修復具有目的性的動態效果,包含 GSAP 時間軸、滾輪編排、微互動及選擇性 Three.js 場景,並確保清理、響應式行為、減少動作支援與瀏覽器驗證。

agent-website-design-skills 是什麼?

這項技能專注於為 React 與一般網頁介面注入具有目的性的動態設計,避免僅為了美觀而進行無意義的動畫。它提供了一套完整的工作流程,從識別使用者任務與動作層級,到選擇最輕量的實現機制(如 CSS、React 動畫庫、GSAP 或 Three.js),並強調在實作前就定義好時間、曲線、間距與中斷規則。技能的核心在於建立一套「運動規則」,確保互動回饋即時、滾輪動畫不影響閱讀順序、3D 場景在隱藏時暫停並適應低電量裝置,同時支援減少動作的無障礙需求。最終交付成果需包含動機說明、編排細節、實作程式碼、效能合約與無障礙驗證,並可參考專屬的檢查清單來確保品質。此技能適用於 Claude Code、Cursor 等 AI 代理工具,能協助開發者在設計、實作或審查階段有效管理網頁動態。

相容平台~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 用於協調的時間軸或滾輪、Three.js 僅用於真正的 3D 需求。
  4. 在實作前建立持續時間、緩動曲線、距離、交錯、中斷與減少動作的規則。
  5. 將動畫選擇器限定在元件根層級。插件僅註冊一次,並在拆卸時清理時間軸、觀察器、監聽器、影格、幾何體、材質、紋理與渲染器。
  6. 保持佈局穩定。盡可能對 transform 與 opacity 進行動畫;避免永久的主執行緒工作與廣泛的 transition: all。
  7. 針對觸控、窄容器、低功率裝置與隱藏分頁,調整密度與編排。
  8. 在行動裝置與桌面寬度下驗證實際像素、互動、縮放行為以及非空白的 Canvas 輸出。

運動規則

  • 互動回饋應立即;裝飾性動態需讓位於輸入操作。
  • 滾輪動畫必須保留閱讀順序,且在不使用 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.

相關技能