Communitygithub.com

運動匹配

將參考影片、GIF 或螢幕錄製中的動畫,測量並重建到使用者的設計中,或與之進行逐格比對。

運動匹配 是什麼?

此技能「運動匹配」旨在將「讓它像這樣移動」這句話轉化為精確的數值數據。它能分析任何動畫參考(影片、GIF、螢幕錄製),分解出每個剪輯點以及每個移動元素的開始時間、持續時間、緩動函數、超調量、位移、旋轉和形狀變化。支援多種目標平台,包括 CSS、Web Animations API、Framer Motion、GSAP、Remotion、SwiftUI 和 After Effects,並能進行逐格比對,直到時間誤差控制在 ±0.08 秒內。除了「比對模式」,還提供「導演模式」:從靜態圖像設計出全新動畫;「故事模式」:為短影片和解說片設計動畫;以及「編輯模式」:為影片素材添加字幕和動態圖形。其核心工作流程分為六個步驟:確認範圍、分解參考、精確測量、撰寫規格、構建動畫、以及反覆比對修正,最終產出詳細的比對報告。此技能無法用於紀錄片頻道,這類內容需使用「紀錄片動畫」技能。

相容平台✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/stazdev/motion-match/tree/HEAD/skills/motion-match

在你喜歡的 AI 中提問

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

說明文件

運動匹配:測量任何動畫,重建它,證明它移動方式相同

將「讓它像這樣移動」轉化為數字:每一個剪輯點,每個移動元素的開始、持續時間、緩動、超調、位移、旋轉和形狀變化。在用戶使用的任何工具中重建運動(CSS、Web Animations API、Framer Motion、GSAP、Remotion、SwiftUI、After Effects),然後逐格比對,直到時間匹配在 ±0.08 秒內。沒有參考運動,只有靜態圖像?使用導演模式(如下)處理 UI 進入動畫,故事模式處理短影片和解說片段:Claude 設計運動、構建它,然後用相同的腳本測量自己的渲染結果,因此「流暢」是經過檢查的,而不是聲稱的。要將影片片段剪輯成廣告(UGC、AI 生成、實拍)?使用編輯模式:對素材應用相同的測量、導演規則和審查。 方法改編自 NiazMorshed2007/reanimate 和 rossark0/rossark-motion-skill(皆為 MIT 授權);腳本是我們自己的。

<skill> 是此技能的文件夾。工作目錄位於當前文件夾的 ./motion-match/<name>/: ref/(參考分解)、ours/(我們的渲染分解)、compare-N/(每次比較的結果)、spec.md。

設置(首次使用)

需要在 PATH 上安裝 ffmpeg/ffprobe 以及一個包含 numpy 和 Pillow 的 Python 3。

  • 檢查:python3 -c "import numpy, PIL"。如果失敗,尋找一個包含它們的 Python(現有項目虛擬環境),否則詢問用戶一次,然後:python3 -m venv ~/.motion-match/venv && ~/.motion-match/venv/bin/pip install numpy pillow 並使用 ~/.motion-match/venv/bin/python 作為下面的 python。每個腳本都使用 -I 運行。
  • 導演和故事模式也需要渲染無頭頁面:pip install playwright && python -m playwright install chromium(詢問一次)。如果無法安裝,則改為螢幕錄製頁面,並說明時間可能不太精確。
  • 無需其他安裝;不會上傳任何內容到任何地方。

0. 範圍(在測量之前將其寫在 spec.md 頂部)

  • 目標: 用戶明確指定的文件 + 時間範圍(+ 裁切)(例如「前 3 秒」、「只需按鈕」)。
  • 忠實度: 運動忠實(預設):順序、時間(±0.08 秒)、緩動家族、超調、相對於元素大小的位移、交錯。用戶自己的藝術作品、顏色、字體和文字。僅在用戶要求且僅用於私人練習時才使用畫素忠實:他人的設計、標誌、角色和音樂屬於他們;永遠不要幫助發布它們的副本。
  • 目標: 運動將進入的工具或程式碼(如果不清楚,詢問一次:它決定輸出格式)。
  • 獲取參考: 用戶提供的檔案,或他們製作的螢幕錄製(網站和應用程式:錄製互動;技能基於影格運作,而非網站的程式碼)。僅在用戶要求特定影片時,才從 YouTube 或網站下載,放入其自己的文件夾;將其視為私人參考資料。

1. 分解它

python -I <skill>/scripts/ref_frames.py REF.mp4 --out motion-match/<name>/ref [--start S --end E --crop x:y:w:h] → 以原始 fps 的每個影格,sheets/timing_NN.png(每個影格:時間、緩動、跟隨動作)和 sheets/poses.png(每秒 2 張:發生了什麼)。閱讀每張 sheet。GIF 的處理方式相同。

2. 測量

  • 剪輯和段落: python -I <skill>/scripts/motion_compare.py motion-match/<name>/ref motion-match/<name>/ref --out motion-match/<name>/self --no-align 列出參考的剪輯點(場景變化)及其時間與動作。從未靜止的參考會在其剪輯點處分割。
  • 精確顏色: python -I <skill>/scripts/track_motion.py <ref>/frames --sample X,Y --at T(完整尺寸影格的像素座標,而非 contact sheet 的)。
  • 每個移動元素: track_motion.py <ref>/frames --name btn --colors HEX,HEX --tol 35 --region x,y,w,h [--save-masks] (或使用 --not-bg HEX 表示「所有不是背景的內容」)。在發光或忙碌的參考上,始終提供 --region 和元素特有的顏色;檢查列印的可見影格範圍是否合理。記錄每個影格的位置(cx cy)、尺寸(w h)、壓縮(aspect)、邊緣、淡入淡出/增長(presence)、顏色和旋轉(angle)。
  • 每個移動: python -I <skill>/scripts/fit_easing.py <ref>/track_btn.json --prop cy --from A --to B (每次移動一個視窗,從不跨越剪輯點)→ 開始、結束、持續時間(毫秒和影格數)、緩動家族、超調、穩定時間以及可直接複製貼上到 CSS、WAAPI、Framer Motion、GSAP 和 Remotion 的程式碼行。 誤差 ≤ 0.03 是良好的擬合;「無單一緩動可擬合」表示需要分割視窗,或者它是一個姿勢鏈(關鍵影格)。
  • 小幅度運動(2% 的擠壓、5 像素的浮動)在 sheets 上看不到,但在追蹤數據中會顯示:閱讀它們。
  • 小型淡入文字接近活動曲線的雜訊:改用 track_motion 測量。

哪些數字測量哪種運動

運動測量方式備註
移動、滑動、浮動cx, cy每個軸一次擬合
縮放、增長、擠壓w, h, aspect
淡入淡出presence(搭配 --colors)
旋轉、自旋angle(度數,順時針為正,連續超過 360)來自輪廓;圓形為 None:追蹤其上的標記作為獨立元素並擬合其 cx/cy。具有 n 折對稱性的形狀(正方形:4)每影格需要 < 180/n 度,因此快速自旋需要高 fps 來源。區域內其他相同顏色的形狀會干擾:縮小 --region
變形(形狀 → 形狀)--save-masks,然後使用 shape_compare.py見下文
3D 翻轉 / 卡片翻轉w(像 cos 一樣縮小)+ presence;在中點處顏色翻轉背面是其自己的元素
路徑運動(弧線、曲線)cx 和 cy 兩者,如果沿路徑轉彎則加上 angle擬合每個軸;路徑形狀在 sheets 上
剪輯 / 遮罩揭示、擦拭x1 或 y1(前緣)、w/h
線條繪製presence
文字分割(每個單詞/字母)追蹤第一個和最後一個單詞;交錯是它們的開始間隔 ÷(計數 − 1)
計數器、圖表條條形:h/y0;數字:sheets(目測)

變形。 track_motion.py ... --name blob --save-masks 保存每個影格的輪廓(居中、縮放到等面積)。然後:

  • python -I <skill>/scripts/shape_compare.py <ref>/track_blob_masks.npz --from A --to B 將 morph 系列(0 = 初始形狀,1 = 最終形狀)添加到 track_blob.json 中。然後 fit_easing.py ... --prop morph 給出其開始、結束和持續時間。變形進度遵循面積,因此其時間是可靠的,但其緩動名稱不是要貼上的值:從規格中獲取緩動,或者從您可以追蹤的參數(w、aspect、angle)中獲取。
  • 我們的與參考的比對:shape_compare.py REF_masks.npz --vs OURS_masks.npz --from A --to B [--rotate] → 形狀路徑:參考的每個中間形狀是否也存在於我們的形狀中,無論其時間如何(通過:平均值 ≤ 10%,最差值 ≤ 整個變形過程的 25%)。然後 fit_easing.py REF_TRACK --prop morph --vs OUR_TRACK 檢查時間。--rotate 在變形同時旋轉時忽略轉動(使用 angle 檢查)。

3. 撰寫運動規格(spec.md;每一行都變成一個檢查點)

| # | 元素 | 屬性 | 從 → 到 | 開始秒 | 持續秒 (影格數) | 緩動 | 超調 | 交錯/備註 | 來源 |
| 1 | 卡片 | translateY | 40 → 0 px | 0.20 | 0.60 (18) | easeOutCubic / cubic-bezier(.33,1,.68,1) | 0% | +0.08 秒每張卡片 | 追蹤 + fit_easing |
| 2 | 圖標 | rotate | 0 → 180 deg | 0.40 | 0.30 (9) | easeOutCubic | 0% | — | 追蹤角度 + fit_easing |
| 3 | 色塊 | morph | 正方形 → 圓形 | 0.50 | 0.40 (12) | easeInOutCubic | — | 形狀路徑通過 | shape_compare |
| c | — | 剪輯 | — | 1.77, 2.33 | — | — | — | — | motion_compare 自檢 |

行中的「?」表示影格尚未讀取。也要註明沒有移動的內容。當工作量很大時,在構建之前向用戶顯示規格。

4. 構建

在用戶的工具中,使用他們的設計。從規格複製時間,從該工具的擬合器輸出複製緩動。當佈局不同時,相對於元素或影格映射距離。姿勢鏈:使用平滑、無超調的插值的關鍵影格;在參考有超調和穩定時使用彈簧。

  • 旋轉: 顯式設置 transform-origin(測量樞軸點:其 cx、cy 保持不變的點)。
  • 變形: SVG 路徑在兩端需要相同數量和類型的命令(或使用 flubber / GSAP MorphSVG);UI 佈局變形(按鈕 → 卡片、縮略圖 → 頁面)使用 FLIP 或共享元素過渡(Framer layoutId、View Transitions API);圓角半徑/尺寸變形是純 CSS。
  • 3D: 父元素設置 perspective 800–1200 px,backface-visibility: hidden,兩個面作為單獨的圖層。

5. 比較和修正(2-5 輪)

  1. 在相同視窗中以相同 fps 渲染或螢幕錄製我們的結果(以與參考相同的方式錄製網頁)。
  2. ref_frames.py OURS.mp4 --out motion-match/<name>/ours --like motion-match/<name>/ref/frames.json (相同的視窗、裁切、fps 和影格大小)。
  3. motion_compare.py motion-match/<name>/ref motion-match/<name>/ours --out motion-match/<name>/compare-N → 偏移、每個剪輯和移動的開始/結束/持續時間/峰值誤差、±0.08 秒內通過、activity.png(兩條曲線)和 sheets/compare_NN.png(參考 | 我們的 | 差異)。每輪都閱讀 sheets。
  4. 每個規格行:以相同方式追蹤我們的,然後 fit_easing.py REF_TRACK --prop P --from A --to B --vs OUR_TRACK → 每個移動的時間通過/失敗、位移和緩動家族匹配。變形行:也使用 shape_compare.py --vs。
  5. 根據證據修正最小的問題,重新渲染,重複。5 輪後,報告任何仍然失敗的項目及其數字和原因。永遠不要暗中放寬容差。
症狀常見原因修正
所有內容都偏移一個偏移量起始延遲或觸發延遲調整第一個延遲
我們的更短且前置緩動太強(expo 與 cubic)使用擬合後的貝塞爾曲線
參考有超調,我們的沒有彈簧/back 與普通緩動back.out / 一個根據測量的超調調整的彈簧
我們的移動過早停止缺少次要運動(漂移、推入)查看該視窗中的 sheets
我們這裡多了一個移動或剪輯某物在參考中靜止卻被動畫化了移除或延遲它
元素編號跳動追蹤捕捉到另一個元素縮小 --region,使用其特有的顏色
旋轉位移正確,但我們的 cx/cy 搖晃錯誤的 transform-origin將樞軸移動到測量的靜止點
變形時間通過,形狀路徑失敗路徑插值不同(點順序、起始點)重新排序路徑點/匹配命令;使用變形庫

6. 報告

忠實度;匹配了什麼以及用戶自己的是什麼;最後的比較表(剪輯和移動及其誤差、通過/失敗);每個元素的行;activity.png 和比較 sheets 的路徑;每個剩餘差異及其數字和原因;以及哪些檢查是測量的(腳本產生的)與目測的(查看 sheet)。

導演模式:輸入靜態圖像,為其設計運動

當用戶提供圖像(UI 截圖、模型、海報、產品照片)而沒有參考運動,或者要求 Claude 選擇運動時使用。工作目錄照常位於 ./motion-match/<name>/(ours/、spec.md、check-N/)。 對於影片片段而不是 UI 進入動畫,請在下方故事模式的步驟中遵循這些步驟。

  1. 讀取圖像。 列出每個元素(背景、導航、標題、正文、圖像、行動呼籲、卡片、圖標)及其像素框、角色和排名:一個焦點,然後是支援元素,最後是裝飾元素。注意閱讀順序、分組(一行卡片、一個列表)、氛圍(平靜/高端、中性/產品、有趣)以及任何暗示特殊運動的內容(切換圖標、圖表、標誌標記、曲線路徑、可翻轉卡片)。
  2. 根據氛圍選擇個性,除非用戶指定。當他們要求選項時,構建所有三種。
個性進入方式持續時間緩動位移交錯超調
平靜淡入 + 上升400–600 mseaseOutQuart / cubic-bezier(.25,1,.5,1)8–16 px60–80 ms無
中性淡入 + 上升,或縮放 .97→1250–400 mseaseOutCubic / cubic-bezier(.33,1,.68,1)12–24 px40–60 ms無
有趣上升 + 縮放 .9→1彈簧彈簧(剛度 300–400,阻尼 20–26)16–32 px50–70 ms3–8%
  1. 根據角色選擇特殊運動(詞彙;數值是起點,按個性縮放):
運動用於何時預設值
變形圖標切換(選單 ↔ 關閉、播放 ↔ 暫停)、按鈕展開為卡片或面板、形狀標誌300–500 ms easeInOutCubic;透過 FLIP/共享元素的佈局變形
旋轉切換/箭頭圖標、刷新、傾斜進入圖標 90–180° 在 200–300 ms easeOutCubic;進入 −6…−10° → 0 配合個性的緩動;載入器 360° 線性 0.8–1.2 秒循環
3D 翻轉/傾斜具有兩個面的卡片、定價切換、懸停深度翻轉 rotateY 180° 在 500–700 ms easeInOutCubic;懸停傾斜 ≤ 8°
路徑運動某物在行進(飛機、沿路線的點、遊標)easeInOutSine,沿路徑轉彎,0.8–1.6 秒
剪輯/遮罩揭示英雄圖像、大標題插入或圓形剪輯,500–800 ms easeOutQuart
文字分割僅主標題單詞間隔 40–60 ms,字母間隔 15–30 ms;整行 ≤ 1 秒
線條繪製圖標、簽名、圖表、底線stroke-dashoffset,600–1000 ms easeInOutCubic
計數器/圖表增長數字、條形、環形數字 800–1200 ms easeOutExpo;條形從基線開始,交錯 40–60 ms
視差/深度分層英雄、滾動場景圖層速度 0.2–0.6 的滾動;支援時使用滾動時間線
  1. 按以下規則編排:

[由於內容被截斷,此處無法提供完整翻譯,但會根據規則完成]

相關技能