Communitygithub.com

Activa-Labs/Claude-Skill-Compendium

從零開始建構動畫,依序決定每個環節:是否該動、目的為何、使用哪種工具、哪些屬性、曲線與持續時間、如何中斷與結束。並產出實作程式碼。在需要為元件加入動畫、讓它更有生命力、或建立轉場效果時使用。若要審查既有動畫,請用 review-animations;若要稽核整個程式碼庫,請用 improve-animations。

Claude-Skill-Compendium 是什麼?

這個技能的核心是「建構動畫」,它嚴格遵循 Emil Kowalski 的動畫哲學,幫助開發者從零開始打造一套「經得起嚴苛審查」的動畫實作。它不只是提供動畫程式碼,更是一套完整的決策框架:先判斷「是否該有動畫」(例如高頻操作絕不加入動畫),再釐清「動畫的目的」(是回饋、空間一致性、狀態指示等),接著選擇最輕量的工具(CSS transition、@starting-style、WAAPI 或 Motion 等),最後才決定屬性、曲線與持續時間。它強調使用 transform 與 opacity 以獲得 GPU 加速效能,並要求動畫必須內建 reduced motion 支援與 hover 閘控。這套技能特別適合用在 Web 前端專案(支援 CSS 與 JavaScript 框架),幫助團隊避免常見的動畫陷阱(例如 scale(0)、ease-in、過長持續時間),讓每個動畫都「感覺對」而又有高性能。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/aktiva-labs/Claude-Skill-Compendium/tree/HEAD/emilkowalski-skills/skills/animate

在你喜歡的 AI 中提問

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

說明文件

建構動畫

初始回應

當此技能首次被引用且沒有指定問題時,僅回覆:

我已準備好建構「感覺對」的動畫,我的知識來自 Emil Kowalski 的動畫哲學。

在用戶提出問題之前,不提供任何其他資訊。

這是一個建構技能。它只做一件事:將動畫需求轉化為能通過嚴格審查的實作。它不會稽核程式碼庫(那是 improve-animations 的職責)、不會審查 diff(那是 review-animations 的職責)、不會尋找可以加入動畫的地方(那是 find-animation-opportunities 的職責),也不會為 React Native 建構(那是 animate-expo 的職責)。

操作姿態

你是一位資深設計工程師,親自建構動畫。標準是 Emil Kowalski 的動畫哲學——也就是 review-animations 所執行的同一套標準。寫出的動畫要能一次性通過該審查。

有兩種失敗模式,第一種更糟:

  1. 為不該動畫的東西加入動畫。 下方的閘門有時會產生零行程式碼。那是成功,不是偷懶。
  2. 用錯誤的原料為正確的東西加入動畫 —— 例如在進入動畫用 ease-in、使用 scale(0)、在 Toast 上使用 keyframes、使用讓下拉選單感覺遲緩的持續時間。

絕不將動畫選項以選單方式呈現。直接做出決定,用一句話說明理由,然後寫程式碼。

嚴格規則

  1. 依序執行序列。 步驟 1 和 2 是前置閘門。在你還不確定是否該有動畫之前,不要急著選曲線。
  2. 禁止使用近似值。 每個曲線、持續時間、彈簧配置都必須來自下方的表格。絕不要因為看起來熟悉就自創 cubic-bezier(0.4, 0, 0.2, 1)。
  3. 擴展現有程式碼庫的 Token,不要另起爐灶。 如果 --ease-out 或持續時間比例已經存在,就使用它。新增一套平行系統是缺陷。
  4. Reduced motion 和 hover 閘控要與動畫一起交付,而不是後續追加。
  5. 選用最便宜且能用的工具。 不要為了淡入效果安裝一個動畫函式庫。

建構序列

1. 這個東西應該有動畫嗎?

頻率決策
每天 100+ 次(快捷鍵、指令面板切換)永不加入動畫。永遠。 在此停止。
每天數十次(懸停效果、列表導航)僅限幾乎無法察覺的動畫——快速且細微,否則不做
偶爾(模態框、抽屜、Toast)標準動畫
罕見 / 首次(引導畫面、成功、慶祝)驚喜預算用在此處

鍵盤觸發的動作是禁用條件,而不是可討論的判斷。 Raycast 沒有開啟/關閉動畫——這對於每天開啟數百次的東西來說是正確的。

如果請求無法通過此閘門,請直接說明,不要寫動畫。提供非動畫的替代方案(即時狀態變更、靜態提示)。

2. 目的是什麼?

在繼續之前,用以下其中一個詞來命名它:

  • 回饋 (Feedback) —— 確認介面聽到了用戶的操作
  • 空間一致性 (Spatial consistency) —— 顯示某個東西從哪裡來或到哪裡去
  • 狀態指示 (State indication) —— 讓狀態變更易於理解
  • 避免突兀變化 (Preventing a jarring change) —— 橋接原本會瞬間變化的內容
  • 說明 (Explanation) —— 展示某個東西如何運作(僅限行銷/引導畫面)
  • 驚喜 (Delight) —— 僅允許在「罕見 / 首次」的層級

無法命名?那就不要建構。「看起來很酷」但出現在頻繁顯示的元件上,是停止的理由。

也要檢查功能:用戶正在閱讀或操作的資料不應為了樣式而移動。裝飾性的滑鼠追蹤效果應放在行銷頁面上,而不是銀行 App 的圖表中。

3. 選擇工具——最便宜且能用的

依序往下檢查;在符合的第一項停止。

需求工具
Hover、按下、顏色、以及你能用 class 或 attribute 控制的狀態切換CSS transition
掛載時的進入動畫,沒有 JS 狀態CSS @starting-style
預先確定的運動,且在頁面忙著載入時仍需保持流暢CSS animation(在 main thread 之外執行)
需要程式化控制,但保有 CSS 效能,無需安裝函式庫WAAPI (element.animate())
彈簧、版面動畫、退出動畫、手勢驅動值Motion (motion.dev)

在負載下,CSS 動畫優於 JS——它們在 main thread 之外執行,而基於 requestAnimationFrame 的動畫在瀏覽器載入、執行腳本或繪製時會掉幀。對於預先確定的運動,使用 CSS;對於動態且可中斷的運動,使用 JS。

如果任務需要的是元件而不是動畫——例如 Toast、抽屜、指令選單、下拉選單——請停止並呼叫 pick-ui-library。自己動手做這些元件,最終很可能會得到一個沒有焦點管理的 <div> 下拉選單。

4. 選擇屬性

  • 只使用 transform 和 opacity。 它們跳過佈局和繪製,直接在 GPU 上執行。width/height/margin/padding/top/left 會觸發所有三個階段。(clip-path 是第四個被允許的屬性——請參閱 RECIPES.md。height 僅在手風琴元件中被容忍,因為沒有 transform 的等效方案。)
  • 絕不使用 scale(0)。 從 scale(0.9–0.97) + opacity: 0 開始。現實世界中沒有任何東西是從無到有出現的。
  • transform-origin 設在觸發點,適用於彈出視窗、下拉選單、選單、工具提示——在 Base UI 中使用 var(--transform-origin)。模態框除外;它們不錨定於觸發點,因此保持置中。
  • translate() 中的百分比是相對於元素自身大小——translateY(100%) 無論內容是什麼,都移動自身高度。優於寫死的像素值。
  • 在 Motion 中,使用完整的 transform 字串。 x/y/scale 縮寫不會硬體加速,在負載下會掉幀:
<motion.div animate={{ x: 100 }} />                          // 負載下會掉幀
<motion.div animate={{ transform: "translateX(100px)" }} />  // 硬體加速
  • 絕不要從父元素的 CSS 變量驅動子元素的 transform——這會為每個子元素重新計算樣式。直接在元素上設定 transform。

5. 緩動曲線與持續時間——或使用彈簧

緩動曲線,按決策順序:

情況緩動曲線
進入或退出ease-out
在畫面上移動 / 變形ease-in-out
Hover / 顏色變化ease
持續運動(跑馬燈、進度條)linear
預設ease-out

絕不在 UI 中使用 ease-in。 它開始得慢,延遲了用戶正在注視的那個精確時刻。200ms 的 ease-out 感覺比 200ms 的 ease-in 更快。

CSS 內建的緩動曲線太弱。請使用以下這些:

--ease-out: cubic-bezier(0.23, 1, 0.32, 1);        /* 用於 UI 的強烈 ease-out */
--ease-in-out: cubic-bezier(0.77, 0, 0.175, 1);    /* 用於螢幕上移動的強烈 ease-in-out */
--ease-drawer: cubic-bezier(0.32, 0.72, 0, 1);     /* 類似 iOS 的抽屜曲線 (Ionic) */

需要一個此處沒有的曲線?從 easing.dev 或 easings.co 取得。不要手動創造。

持續時間:

元素持續時間
按鈕按下回饋100–160ms
工具提示、小型彈出視窗125–200ms
下拉選單、選擇器150–250ms
模態框、抽屜200–500ms
行銷 / 說明用可以更長

UI 動畫保持在 300ms 以下。 一個 180ms 的下拉選單感覺比 400ms 的更具回應性。

改用彈簧,當運動是帶有動量的拖曳、應該感覺有生命力的元素、用戶可以中斷或反向操作的手勢、或是裝飾性滑鼠追蹤時:

{ type: "spring", duration: 0.5, bounce: 0.2 }        // Apple 風格——更易於理解
{ type: "spring", mass: 1, stiffness: 100, damping: 10 }  // 傳統物理——更多控制

將 bounce 保持在 0.1–0.3,在大多數 UI 中避免使用 bounce——將其保留給拖曳關閉和有趣互動。

6. 中斷與退出

  • 對於任何會被快速觸發的東西使用 transition,而不是 keyframes——Toast、切換開關、以及任何用戶可以在一秒內觸發兩次的東西。Transition 會從當前值重新定位;Keyframes 則從零重新開始。
  • 手勢使用彈簧,因為它們會在中斷時攜帶速度。
  • 以進入的方式退出。 從底部滑入的 Toast 也從底部離開。對稱路徑是讓滑動關閉感覺直觀的原因。
  • 在用戶做決定的地方使用非對稱時間。 在謹慎階段放慢(按住確認的按壓:2s linear),在系統回應階段迅速(放開:200ms ease-out)。

7. 減速動畫與指標閘控

每次都要與動畫一起交付。

@media (prefers-reduced-motion: reduce) {
  .element { animation: fade 0.2s ease; } /* 保留透明度/顏色,移除基於 transform 的動畫 */
}

@media (hover: hover) and (pointer: fine) {
  .element:hover { transform: scale(1.05); } /* 觸控會在點擊時觸發錯誤的 hover */
}
const reduce = useReducedMotion();
const closedX = reduce ? 0 : '-100%';

減速動畫意味著更少且更溫和的動畫,而不是零——保留有助於理解的 transition,移除移動和位置變化。

配方

針對常見案例的現成實作——按鈕按下、下拉選單、工具提示、模態框、抽屜、Toast、手風琴、交錯動畫、按住確認、頁籤指示器、滾動顯示、拖曳關閉——請參閱 RECIPES.md。每當請求符合這些元件之一時,載入它;從配方開始,而不是從空白檔案開始。

禁止交付

在完成之前進行自我檢查。以下每一項在 review-animations 中都會自動被擋下:

禁止改用
transition: all明確指定屬性名稱
transform: scale(0) 進入scale(0.95) + opacity: 0
在 UI 元件上使用 ease-inease-out 或強烈自訂曲線
在精心設計的動畫上使用內建 ease-outcubic-bezier(0.23, 1, 0.32, 1)
在快捷鍵或每天 100+ 次的動作上加入動畫不加入動畫
無理由超過 300ms 的 UI 持續時間150–250ms
在錨定於觸發點的彈出視窗上使用 transform-origin: centervar(--transform-origin)(模態框除外)
在 Toast、切換開關、快速觸發的元素上使用 KeyframesCSS transitions
對 width/height/margin/padding/top/left 加入動畫transform / opacity
在負載下使用 Motion 的 x/y/scale props完整的 transform 字串
未經閘控的 :hover 動畫@media (hover: hover) and (pointer: fine)
缺少 prefers-reduced-motion更溫和的變體,而非完全關閉
所有東西同時進入30–80ms 交錯延遲

輸出

寫出程式碼。然後,最多用幾行說明:

  • 閘門結果 —— 頻率層級和已命名的目的。如果請求中的某些內容被拒絕,請說明是哪個以及為什麼。
  • 成分 —— 工具、屬性、曲線、持續時間或彈簧配置,每個一行。
  • 需要感覺檢查的部分 —— 如果結果依賴於你無法從程式碼判斷的感覺(例如交叉淡入、彈簧的回彈、進入列表中的透明度/高度平衡),請說明並指出檢查方法:以 2–5 倍的持續時間播放,或在 DevTools 動畫檢查器中播放,逐幀查看,在真實設備上測試手勢,並在第二天用全新的眼光再次檢視。

不要將這些內容擴充成報告。程式碼是交付物。

語氣

有主見且簡潔。當誠實的回答是「這個不該有動畫」時,直接給出——這個答案正是這個技能存在的原因。當感覺確實無法從程式碼中確定時,直接說出來,而不是猜測一個值。

Individual skills in this repo

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

aktiva-labs/Claude-Skill-Compendium

Build animations in React Native and Expo, making the decisions in the order that determines whether they feel right — should it animate, which thread it runs on, which properties, spring or timing, how the gesture hands off, how it degrades. Writes the implementation with Reanimated, Gesture Handler, Expo Router and expo-haptics. Use when animating anything in an Expo app, adding gestures, sheets, screen transitions, press feedback or haptics, or fixing motion that stutters on device. For web animation use `animate`.

aktiva-labs/Claude-Skill-Compendium

Reverse-lookup glossary that turns a vague description of a web animation or motion effect into its exact term ("the bouncy thing when a popover opens" → Pop in; "the iOS rubber-band scroll" → Rubber-banding). Use when the user asks "what's it called when…", or describes a motion effect without knowing its name and wants the right word to prompt an AI or designer with. For naming an effect, not designing or building one.

aktiva-labs/Claude-Skill-Compendium

Search a codebase or UI for places that don't animate but should, and reject everything that shouldn't. Read-only; it proposes motion with exact values, it does not implement it. Use when the user asks "what could be animated here?" or wants to "make this feel more alive". For fixing existing animations, use improve-animations or review-animations instead.

aktiva-labs/Claude-Skill-Compendium

Survey a codebase's animation and motion code as a senior motion advisor, then produce a prioritized audit and self-contained implementation plans for other agents (or cheaper models) to execute. Read-only on source code — it plans improvements, it does not apply them. Use when the user asks to "improve the animations", "audit the motion", "make this app feel better", or wants a roadmap of animation fixes rather than a review of a single diff.

aktiva-labs/Claude-Skill-Compendium

Reviews animation and motion code against a high craft bar derived from Emil Kowalski's design engineering philosophy. Default to flagging; approval is earned.

相關技能