Communitygithub.com

MengTo/Skills

對前端頁面效能進行設定檔分析、稽核和最佳化,特別著重於動畫處理、記憶體洩漏風險、長時間連線緩慢問題、CSS 動畫、canvas/WebGL requestAnimationFrame 迴圈、跑馬燈、骨架螢幕、GSAP/Three/Matter 效果、計時器、監聽器和觀察器。當使用者要求讓動畫更高效能、暫停離螢幕動畫、檢查記憶體洩漏、對長時間使用後變慢的頁面進行設定檔分析、修復卡頓捲動、降低 CPU/GPU 使用率,或是在使用 Codex Browser 的 React/Vite/Next/前端頁面上重複「僅在可視區域內播放」的最佳化時使用。

Skills 是什麼?

此技能旨在幫助開發者和 AI 代理(如 Codex Browser)診斷並最佳化前端頁面的動畫與渲染效能。它提供了一個結構化的 7 步驟工作流程:從檢查儲存庫上下文、使用瀏覽器擷取基準資料(包括 CSS 動畫、Canvas/WebGL 和 JavaScript 迴圈),到精確修補控制動畫的最小擁有者(例如透過 IntersectionObserver 暫停離螢幕動畫),再到驗證行為和提交變更。核心原則是「先測量,再編輯」,目標不是移除動畫,而是確保離螢幕工作停止、可見動畫正確恢復,以及路由卸載時釋放長期佔用的資源。支援的平台包括 React、Vite、Next.js 等前端框架,並特別強調使用 Codex Browser 而非 Chrome 來進行更可靠的效能測量。此外,技能還包含了記憶體洩漏防護的詳細指引,如清除計時器、取消 RAF、中斷觀察器、處理 GSAP/Three.js 資源等,以及良好的修復模式和應避免的常見陷阱。

相容平台~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/MengTo/Skills/tree/HEAD/agent-skills/codex/optimize-web-animations

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

最佳化網頁動畫

核心規則

在編輯之前先測量真實頁面。目標不是移除動畫,而是讓離螢幕的工作停止,可見的動畫正確恢復,並且路由/卸載清理能釋放長期存在的資源。

盡可能使用 Codex Browser,尤其是對於 localhost 頁面。除非使用者明確要求,否則不要使用 Chrome。

工作流程

  1. 檢查儲存庫上下文。

    • 讀取 AGENTS.md 或本地說明。
    • 提早執行 git status --short。
    • 尋找頁面元件、動畫鉤子、CSS keyframes、requestAnimationFrame、setInterval、setTimeout、canvas/WebGL/物理引擎元件、媒體元素、GSAP 時間軸/補間、以及現有的可見性工具函式。
    • 搜尋 useEffect 清理中是否有事件監聽器、觀察器、RAF 迴圈、間隔、計時器、外部腳本、媒體串流、WebGL 紋理/材質/幾何/渲染器,以及在卸載後才完成執行的非同步工作。
    • 如果工作目錄是髒的,從一開始就規劃狹隘的暫存。
  2. 在瀏覽器中擷取基準資料。

    • 開啟使用者指定的確切路由。
    • 在頁面頂部、中間、頁尾/底部內容處進行設定檔分析,並在版面可能不同時對一個行動視埠進行分析。
    • 透過計算出的 animationName、animationPlayState 和可見性來計算 CSS 動畫數量。包含 ::before 和 ::after。
    • 分別檢查 canvas/WebGL 元素;CSS 設定檔分析無法證明 RAF 迴圈已停止。
    • 記錄哪些動畫名稱在離螢幕時仍在執行,以及負責的 DOM 擁有者。
    • 對於記憶體/洩漏相關請求,也要記錄元素/canvas/影像/iframe 的數量、可用的公開 JS 堆積指標、10-30 秒後的閒置取樣,以及一個簡短的路由循環取樣。如果堆積 API 回傳 null 或瀏覽器沙箱阻止了 monkey-patching,請說明情況並依賴穩定的可觀察計數加上原始碼稽核。
    • 保持壓力測試在有限範圍內。瀏覽器分頁在設定檔分析期間崩潰是負載過重的證據,但除非能透過最小化測試重現,否則不要過度歸因其成因。
    • 請參閱 references/browser-profiling.md 以獲得可重複使用的 Codex Browser 評估器。
  3. 修補控制動畫的最小擁有者。

    • 如果應用程式已有現成的頁面顯現/可見性鉤子,優先使用。
    • 否則,新增一個 IntersectionObserver,在章節和動畫子元素上切換一個穩定的類別,例如 is-offscreen。
    • 使用目標規則暫停 CSS 動畫:
main > section.is-offscreen .expensive-animation,
.expensive-animation.is-offscreen {
  animation-play-state: paused !important;
}
  • 對於重複的卡片或佔位符,觀察卡片外殼和動畫子代,而不是整個文件。
  • 對於跑馬燈/股票行情軌道,在其章節離螢幕時暫停軌道。
  • 對於骨架載入器和偽元素微光,在需要時包含 ::before 和 ::after 暫停選擇器。
  • 對於 canvas/WebGL/物理引擎迴圈,直接閘控 RAF 迴圈:
    • 當 canvas/容器進入可視區域時啟動。
    • 當離螢幕時取消 requestAnimationFrame。
    • 重新進入時恢復。
    • 在清理時中斷觀察器並取消幀。
    • 在需要協助瀏覽器驗證時,新增一個非視覺的除錯標記,例如 data-animation-active。
  • 如果元件已經這麼做,請尊重 prefers-reduced-motion,並避免為捲動/動畫狀態引入 React 渲染迴圈。
  • 針對記憶體洩漏防護:
    • 清除由該 useEffect 建立的每個 timeout/interval。
    • 在卸載前和重新啟動迴圈前取消 RAF。
    • 中斷 IntersectionObserver、ResizeObserver、MutationObserver 和自訂訂閱。
    • 使用相同的處理器參考移除全域/視窗/文件監聽器。
    • 釋放 Three/WebGL 的紋理、材質、幾何、渲染器,並移除渲染器 DOM 節點。
    • 銷毀 DOM 節點和可變物件(如著色器 uniform)的 GSAP 補間/時間軸。
    • 停止媒體串流並暫停已分離的影片/音訊來源。
    • 使用 isDisposed 標誌保護非同步載入器,並在載入於卸載後完成時釋放已載入的資源。
    • 在 React 的清理函式中,如果在 useEffect 回傳清理函式之前,linter 警告 ref 可能改變,請在 effect 內部捕獲 ref.current 的值。
    • 在可見性暫停後限制物理引擎或模擬的幀增量,以便延遲的幀不會執行過大的更新。
  1. 驗證行為,而不僅僅是建置。

    • 重新載入路由並重新執行相同的頂部/中間/頁尾/行動設定檔分析。
    • 目標結果:受測頁面章節的 offscreenRunningCount: 0。
    • 確認可見的動畫在捲動進入可視區域時仍然執行或恢復。
    • 確認 RAF/canvas 迴圈在離螢幕時報告為非活躍,在可視區域內時為活躍,或者從原始碼/執行時期狀態證明其已取消。
    • 對於記憶體洩漏稽核,比較前後的路由循環和閒置取樣。DOM/canvas/影像計數在重複導航後應回到相同的基準線,允許少量預期的非同步內容變更。
    • 執行一次正常的頁面互動,例如搜尋/篩選/導航,以便觀察器不會破壞動態內容。
    • 檢查新分頁的主控台警告/錯誤。
  2. 執行本地檢查。

    • 使用儲存庫的正常閘道。對於 React/Vite 應用程式,這通常是:
git diff --check
npm run lint
npm run build
  • 將已知的非致命警告與失敗分開說明。
  1. 根據儲存庫/使用者指示的要求,進行狹隘的提交。
    • 如果存在不相關的髒變更,請使用隔離的索引:
rm -f /tmp/<task>-index
GIT_INDEX_FILE=/tmp/<task>-index git read-tree HEAD
# 僅將預期的區塊套用到暫存索引。
GIT_INDEX_FILE=/tmp/<task>-index git diff --cached --check
GIT_INDEX_FILE=/tmp/<task>-index git commit -m "暫停離螢幕 <page> 動畫"
git restore --staged <files> 2>/dev/null || true
  • 除非每個區塊都屬於該任務,否則永遠不要從髒的工作目錄中暫存廣泛的檔案。
  1. 附帶證據進行報告。
    • 以發現結果為開頭:哪些仍然在執行,哪些看起來有洩漏風險,以及哪些無法測量。
    • 分別說明原始碼稽核的風險和即時瀏覽器測量結果。
    • 包含確切的取樣路由、離螢幕動畫計數、DOM/canvas 計數穩定性、路由循環結果和本地檢查。
    • 清楚地說明限制,特別是無法使用的堆積計數器或被阻斷的瀏覽器檢測工具。

良好的修復模式

  • 章節層級的 is-offscreen 加上元素層級的 is-offscreen,用於較長的章節,其中折疊下方子動畫仍可能執行。
  • 每個路由的共用可見性選擇器常數,例如 COURSES_PAGE_ANIMATION_VISIBILITY_SELECTOR。
  • IntersectionObserver 閾值約為 0.01 以進行動畫閘控。
  • 對於 WebGL/canvas 效果,直接控管 RAF 迴圈;CSS animation-play-state 無法暫停 JavaScript 渲染迴圈。
  • 針對在暫停或延遲幀後恢復的物理引擎迴圈的幀增量上限。
  • 為 GSAP/WebGL 效果使用的 React ref 所捕獲的清理節點。
  • 用於可能在卸載後才解析的影像/影片/紋理/資料載入器的 isDisposed 保護。
  • 簡短的閒置和路由循環探測,以捕捉累積的 DOM 節點、canvas、iframe 或未釋放的媒體。

應避免的事項

  • 為了通過設定檔分析而移除所有動畫。
  • 因為祖先選擇器太過寬泛而暫停可見的主要動畫。
  • 假設 animation-play-state 涵蓋了偽元素或 JavaScript RAF 迴圈。
  • 在長頁面上只相信單一頁頂測量值。
  • 將無法使用的堆積計數器視為沒有記憶體洩漏的證據。
  • 在瀏覽器中執行無限制的壓力迴圈;使用有限循環並記錄崩潰,但不要過度歸因因果關係。
  • 僅使用螢幕截圖作為效能證明。
  • 讓不相關的本地區塊混入提交中。

Individual skills in this repo

This repo contains 9 individual skills — each has its own dedicated page.

MengTo/Skills

Create polished 60 fps 4:3 4K browser screen-recording style videos from Codex in-app browser captures, with browser-only crop, natural macOS cursor styling, deliberate click choreography, zoom-follow framing, ffprobe/thumbnail verification, and optional native recording compatibility checks. Use when the user asks to record or re-record browser actions, show cursor clicks and zooms, make Dribbble/UI inspiration or product demo recordings, or asks whether Codex, Playwright, or an MCP can produce a natural browser demo video.

MengTo/Skills

Generate ElevenLabs text-to-speech audio from scripts or inline text using local voice profiles. Use when the user asks for ElevenLabs, text-to-speech, TTS, narration, voiceover, speech audio, or voice generation; load voice names, voice ids, emails, owners, and account-specific defaults only from local config outside the skill.

MengTo/Skills

Turn a reference video into a super detailed recreation or inspiration prompt. Use when the user provides, mentions, uploads, links, or points to a video and asks to analyze the design, UI, animations, transitions, scroll interactions, typography, colors, assets, WebGL/Three.js, storytelling, section-by-section behavior, or to create a prompt/article that recreates the page, app, interaction, or motion system.

MengTo/Skills

Create an on-scroll animation trigger using IntersectionObserver with Tailwind-friendly animation classes and keyframes. Use when asked for scroll-reveal, animate-on-scroll, or sequencing element animations when they enter the viewport.

MengTo/Skills

Use when designing or implementing product-grade web motion like Stripe, Linear, Apple, and Vercel. Covers motion principles, easing/duration defaults, choreography patterns, scroll/hover interactions, performance, accessibility (reduced motion), and implementation guidance.

MengTo/Skills

Create premium cinematic web motion systems with GSAP, ScrollTrigger, and Lenis. Use for luxury editorial websites, creative studio portfolios, Awwwards-style interactions, smooth scroll reveals, staggered text, parallax, pinned sections, magnetic hover states, custom cursors, and mouse-reactive layered movement.

MengTo/Skills

Create cinematic scroll-driven landing pages with Lenis smooth scrolling, GSAP ScrollTrigger, scroll-linked progression, staggered text reveals, sticky card stacks, parallax backgrounds, scroll-scrubbed transitions, footer reveals, and immersive preloaders. Use when analyzing or building premium editorial scroll experiences, sticky project stacks, kinetic typography, or section-by-section storytelling.

MengTo/Skills

Use when designing or rewriting a high-converting SaaS pricing page (structure, plan design, copywriting, SEO/AEO, FAQs, layout patterns, experiments). Includes checklists, templates, and common pitfalls.

MengTo/Skills

Use when creating or refining WebGL-heavy landing pages and you need to steer toward a specific visual outcome (premium, technical, playful, cinematic) while balancing conversion clarity, performance, and implementation complexity.

相關技能