Communitygithub.com

Asymmetric-al/core

反向查找術語表:將模糊的網頁動畫效果描述轉換為精確術語(例如「彈出視窗打開時的彈跳效果」→ Pop in;「iOS 橡膠帶狀滾動」→ Rubber-banding)。當使用者詢問「那個效果叫什麼…」或描述動畫效果卻不知其名時使用,旨在為效果命名,而非設計或實作。

core 是什麼?

這是一個專為開發者、設計師及 AI 代理工具設計的術語查找技能,能將使用者對網頁動畫或運動效果的模糊描述,精確對應到標準術語。其主要功能是逆向查詢術語(reverse-lookup glossary):當使用者描述「那個彈出視窗開啟時會彈跳的東西」時,技能會回傳「Pop in」;當描述「iOS 那種拉過頭會反彈的滾動」時,則回傳「Rubber-banding」。技能的核心知識庫來自於 Emil Kowalski 的動畫哲學,並以結構化分類(如進場/出場、序列與時序、滾動、反饋與互動、彈簧動畫等)組織。使用流程是:首先閱讀使用者的意圖而非關鍵字,接著引用標準術語定義,區分相近術語(如 Clip-path 與 Mask),並在無完全匹配時提供最接近的近似描述。此技能支援 Claude Code、Cursor 等 AI 代理平台,適合在設計討論或實作需要精確動畫詞彙時使用,但不作為實作或審查標準。

相容平台✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Asymmetric-al/core/tree/HEAD/.agents/skills/animation-vocabulary

在你喜歡的 AI 中提問

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

說明文件

動畫詞彙

此倉庫 (Asymmetric-al/core)

此倉庫擁有的覆蓋層保持上游詞彙表精簡且與 Core 的規範前端指引相容。在上游刷新後請先進行協調,再執行 bun run skills:sync。

觸發條件

  • 使用者描述了一個運動效果,但不知道其名稱。
  • 設計或實作討論中需要精確的動畫詞彙。
  • 請勿將此技能用作實作或審查標準。
  • 對於具體要求為某個運動效果命名的請求,應直接回答。上游的初始回應僅適用於沒有具體問題或任務的單純呼叫。

工作流程

  1. 使用上游詞彙表來命名及區分效果。
  2. 保持回答簡潔,不要將命名請求轉變為 UI 工作。
  3. 如果後續需要實作或審查,請載入 docs/ai/rules/frontend.md 和 docs/ai/skills/anim/SKILL.md;這些倉庫合約為準。

檢查清單

  • 回應開頭應使用最精確的詞彙表術語。
  • 在區分相近選項時,不發明新詞彙。
  • 任何實作建議應延遲至 Core 的前端及運動規則中處理。

初始回應

當此技能首次被呼叫且沒有具體問題時,僅回覆:

我已準備好為您描述的任何運動效果命名,我的知識來自於 Emil Kowalski 的動畫哲學。

將對運動或效果的模糊描述轉換為精確術語,讓使用者知道該如何提問。

快速入門

使用者會大致描述某個效果。您需回傳匹配的術語,格式如下:

**Stagger** — 依序動畫多個項目,每個之間有微小延遲,形成層疊效果。

如果有多個術語可能符合,請先列出最匹配的術語,然後提供 1–2 個替代選項,並用一句話說明它們的不同之處。

指示

  1. 閱讀意圖,而非關鍵字。 使用者描述的是他們「看到」或「感覺到」的東西(「彈性」、「滑出」、「自己畫出來」),而非技術名稱。將感覺映射到下方的詞彙表。
  2. 逐字引用詞彙表。 其描述具有權威性 — 請照原樣使用,不要改寫。
  3. 區分相近術語。 當兩個術語競爭時(Clip-path 與 Mask、Pop in 與 Bounce、Shared element transition 與 Layout animation),對比它們,讓使用者可以選擇。
  4. 當沒有完全匹配時, 說出最接近的術語,並明確表示這只是近似,或者用詞彙表中的詞彙來描述該效果(例如「那是 scale-in 進場的 stagger」)。
  5. 保持在詞彙表範圍內。 如果某個術語確實不在這裡,請直接說明,而不是發明一個 — 儘管您可以用這些詞彙來解釋概念。
  6. 保持簡潔。 命名問題只需要一個名稱,而不是一篇論文。先給出術語;只在被問到時再擴展。

範例

範例 1 — 基於感覺 使用者:「彈出視窗從點擊的按鈕中長出來,而不是從中間長出來,這個效果叫什麼?」 輸出:

**Origin-aware animation** — 元素從其觸發點動畫出來,例如彈出視窗從開啟它的按鈕中長出,而不是從 CSS 預設的自身中心長出。

範例 2 — 區分 使用者:「一張圖片變成另一張圖片的那個效果。」 輸出:

**Morph** — 一個形狀平滑地變成另一個形狀,例如動態島。

相近替代:
- **Crossfade** — 如果它們只是在同一位置互相淡入淡出。
- **Shared element transition** — 如果一個元素從一個位置移動並轉變到另一個位置。

範例 3 — 物理感覺 使用者:「那個 iOS 滾動效果,拉過頭時會抵抗並彈回來。」 輸出:

**Rubber-banding** — 拖動超過邊界時的抵抗和彈回效果(iOS 的過度滾動感覺)。

詞彙表

精選的快照,與專案的 /vocabulary 頁面保持同步;任何一方變更時,請使兩者保持一致。

進場與出場 — 元素如何出現和消失

  • Fade in / Fade out — 元素透過改變不透明度來出現或消失。
  • Slide in — 元素從螢幕外(左、右、上或下)滑入。
  • Scale in — 元素從較小尺寸增長到完整尺寸時出現,通常伴隨淡入效果。
  • Pop in — 元素出現時帶有輕微的過衝,像是彈跳到位。
  • Reveal — 內容逐漸被揭露,通常是透過動畫 clip-path 或 mask。
  • Enter / Exit — 元素被加入或從螢幕移除時播放的動畫。

序列與時序 — 協調多個元素或時刻

  • Keyframes — 動畫中定義的點(0%、50%、100%),瀏覽器會自動填充其間格。
  • Interpolation / Tween — 在起始值和結束值之間生成所有中間幀,使運動連續。
  • Stagger — 依序動畫多個項目,每個之間有微小延遲,形成層疊效果。
  • Orchestration — 刻意安排多個動畫的時機,使它們感覺像一個協調的運動。
  • Delay — 動畫開始前的等待時間。
  • Duration — 動畫持續的時間長度。
  • Fill mode — 元素在動畫開始前或結束後,是否保留其第一幀或最後一幀的樣式(例如 forwards)。
  • Stepped animation — 分為離散步驟的動畫,例如倒數計時器。

移動與變形 — 改變元素的位置、大小或角度

  • Translate — 沿 X 或 Y 軸移動元素。
  • Scale — 放大或縮小元素。
  • Rotate — 繞著一個點旋轉元素。
  • Skew — 沿 X 或 Y 軸傾斜元素,使其脫離矩形形狀。
  • 3D tilt / Flip — 在 3D 空間中旋轉(rotateX / rotateY)以增加深度感。
  • Perspective — 3D 效果的強度 — 數值越低,深度感越強,就像觀看者離得更近。
  • Transform origin — 縮放或旋轉的錨點。
  • Origin-aware animation — 元素從其觸發點動畫出來,例如彈出視窗從開啟它的按鈕中長出,而不是從 CSS 預設的自身中心長出。

狀態之間的轉換 — 連接一個狀態、視圖或元素與另一個

  • Crossfade — 一個元素淡出,同時另一個元素在同一位置淡入。
  • Continuity transition — 透過視覺上連接前後狀態來保持使用者方向的變更。例如,讓同一個矩形變大或變小。
  • Morph — 一個形狀平滑地變成另一個形狀,例如動態島。
  • Shared element transition — 一個元素從一個位置移動並轉變到另一個位置,例如縮圖展開為卡片。
  • Layout animation — 當元素的大小或位置改變時,它會動畫到新位置,而不是突然跳動。
  • Accordion / Collapse — 一個區域平滑地展開和收起其高度,以顯示或隱藏內容。
  • Direction-aware transition — 內容在向前導航時朝一個方向滑動,向後導航時朝相反方向滑動,使導航具有方向感。

滾動 — 與滾動或在視圖之間導航相關的運動

  • Scroll reveal — 元素在進入視口時淡入或滑入到位。
  • Scroll-driven animation — 動畫的進度直接與滾動位置相關聯。
  • Parallax — 滾動時背景和前景以不同速度移動,產生深度感。
  • Page transition — 從一個頁面或路由導航到另一個頁面或路由時播放的動畫。
  • View transition — 瀏覽器在兩個狀態或頁面之間變形,連接共享元素。

反饋與互動 — 對使用者操作的響應

  • Hover effect — 游標移到元素上時的視覺變化。
  • Press / Tap feedback — 點擊元素時微小的縮小效果,使其感覺有物理感。
  • Hold to confirm — 一個進度效果,在使用者按住按鈕時填充。
  • Drag — 透過拖動來移動元素,通常釋放時具有慣性。
  • Drag to reorder — 拖動清單中的項目以重新排列,同時其他項目會移動以騰出空間。
  • Swipe to dismiss — 拖動元素使其離開螢幕以關閉它,例如抽屜或提示。
  • Rubber-banding — 拖動超過邊界時的抵抗和彈回效果(iOS 的過度滾動感覺)。
  • Shake / Wiggle — 快速左右抖動,表示錯誤或拒絕的輸入。
  • Ripple — 從點擊點擴散的圓圈,確認按壓動作。

緩動 — 動畫過程中速度如何變化

  • Easing — 動畫加速或減速的速率。
  • Ease-out — 開始快,結束慢。大多數 UI 和對使用者操作做出響應的動畫的預設值。
  • Ease-in — 開始慢,結束快。通常應避免;可能感覺遲緩。
  • Ease-in-out — 慢、快、慢。適合已經在螢幕上,從 A 點移動到 B 點的元素。
  • Linear — 恆定速度。避免用於 UI;保留給旋轉指示器或跑馬燈。
  • Cubic-bezier — 您自訂的緩動曲線,用於精確控制。
  • Asymmetric easing — 加速和減速率不同的曲線。感覺比對稱曲線更生動。

彈簧動畫 — 基於物理的運動,作為固定持續時間緩動的替代方案

  • Spring — 由物理(張力、質量、阻尼)驅動的運動,而非固定的持續時間。
  • Stiffness / Tension — 彈簧拉向其目標的力度。數值越高,感覺越乾脆。
  • Damping — 彈簧穩定下來的速度。數值越低,彈跳和震盪越多。
  • Mass — 動畫元素的「重量感」。質量越大,動作越慢、越遲緩。
  • Bounce — 彈簧過衝後穩定下來,增添趣味性。
  • Perceptual duration — 彈簧感覺上完成所需的時間,即使它在底下仍在微幅震盪。
  • Momentum — 帶有速度的運動,特別是在拖動或中斷之後。
  • Velocity — 元素移動的速度和方向。彈簧會將速度帶入下一個動畫(如果被中斷),因此被撥動的元素會保持其速度。
  • Interruptible animation — 可以在飛行中被平滑重定向的動畫,而不是必須先完成。

循環與環境運動 — 自行運行的動畫

  • Marquee — 文字或內容連續循環滾動。
  • Loop — 重複的動畫,可以是固定次數或無限次。
  • Alternate (yoyo) — 一種循環,每次迭代時先向前播放,然後反向播放,而不是跳回起點。
  • Orbit — 一個元素繞著另一個元素連續環繞。
  • Pulse — 溫和的重複縮放或不透明度變化,以吸引注意力。
  • Float — 溫和、連續的上下漂移,使靜態元素感覺有生命且輕盈。
  • Idle animation — 元素在靜止、等待互動時播放的微妙運動。

潤飾與效果 — 區分好與偉大的小細節

  • Blur — 用於柔化元素或遮蓋微小缺陷的模糊濾鏡。
  • Clip-path — 將元素裁剪成某個形狀,用於揭示、遮罩和對比滑塊。
  • Mask — 使用形狀或漸層隱藏或顯示元素的一部分 — 類似 clip-path,但具有柔和的、可淡化的邊緣。
  • Before / after slider — 可拖動的分隔線,在兩張重疊的圖片之間滑動以進行比較。
  • Line drawing — SVG 路徑自行繪製,就像有一支看不見的筆在描繪它。
  • Text morph — 文字在變化時逐字元動畫,吸引使用者對新值的注意。
  • Skeleton / Shimmer — 內容載入時顯示的佔位符,帶有移動的光澤。
  • Number ticker — 數字滾動或計數到某個值。
  • Tabular numbers — 固定寬度的數字,使數字在變化時不會左右移動。對於計數器、計時器和計數器至關重要。
  • Typewriter — 文字一次出現一個字元,就像在打字一樣。

效能 — 使運動流暢而非卡頓的要點

  • Frame rate (FPS) — 每秒繪製的幀數。60fps 是流暢運動的基準;在較新螢幕上為 120fps。
  • Jank — 當瀏覽器因無法跟上動畫而掉幀時出現的可見卡頓。
  • Dropped frame — 瀏覽器錯過繪製截止時間的幀,導致運動中出現微小中斷。
  • Compositing — 讓 GPU 在其獨立圖層上移動或淡入淡出元素,而無需重新計算佈局或繪製。
  • will-change — CSS 提示,表示某個元素即將進行動畫,以便瀏覽器提前將其提升到獨立圖層。
  • Layout thrashing — 對 width、height、top 或 left 等屬性進行動畫,迫使瀏覽器每幀重新計算佈局,導致卡頓。

應了解的原則 — 指導何時以及如何進行動畫的概念

  • Purposeful animation — 運動應服務於某個功能 — 引導、提供反饋、顯示關係 — 而不僅僅是裝飾。
  • Anticipation — 在移動前,向相反方向做一個小的蓄力動作,暗示即將發生的事情。
  • Follow-through — 元素的部分在主運動停止後繼續移動並稍微穩定下來,增加重量感。
  • Squash & stretch — 在移動時變形元素,以傳達重量、速度和彈性。
  • Perceived performance — 合適的動畫能讓介面感覺更快,即使實際上並沒有。
  • Frequency of use — 使用者看到某個動畫的頻率越高,動畫就應該越短、越微妙。
  • Spatial consistency — 動畫過程中,元素應保持其身份和位置,使用者在狀態之間永遠不會迷失方向。
  • Hardware acceleration — 對 transform 和 opacity 進行動畫,讓 GPU 保持運動流暢。
  • Reduced motion — 尊重使用者的 prefers-reduced-motion 設定,減少或移除運動。

Individual skills in this repo

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

Asymmetric-al/core

Build animations for Expo and React Native only, using Reanimated, Gesture Handler, Expo Router, and expo-haptics. Use when the target runtime is an Expo or React Native app. Do not use it for Core Next.js web motion; use `animate` for web. Only runs when explicitly invoked; it does not trigger on its own.

Asymmetric-al/core

Build an animation from scratch, making the decisions in the order that determines whether it feels right — should it animate at all, what purpose, which tool, which properties, which curve and duration, how it interrupts, how it exits. Writes the implementation. Use when asked to animate something, add motion, make a component feel alive, or build a transition. For critiquing existing motion use review-animations; for auditing a whole codebase use improve-animations. Only runs when explicitly invoked; it does not trigger on its own.

Asymmetric-al/core

Inspect a Core UI or code surface for a small number of justified motion opportunities and explicitly identify what should remain static. Use when asked what should animate, where motion would improve feedback or comprehension, how to make an interface feel more alive without over-animating it, or whether a proposed animation is worth adding. Read-only; do not use to review or fix existing motion code or to implement animations.

Asymmetric-al/core

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.

Asymmetric-al/core

Implement smooth, accessible animations with motion/react (Framer Motion) in React. Use when adding animations, gestures, or layout transitions with motion, AnimatePresence, useScroll, and related APIs. Requires a 'use client' boundary; not for strictly server-rendered components or when no animation is needed.

Asymmetric-al/core

Best practices for Remotion - Video creation in React

Asymmetric-al/core

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

相關技能