Communitygithub.com

Parrass/mograf-public

mograf 動作規範的免費子集。在撰寫或編輯任何動畫程式碼(HyperFrames、GSAP、CSS、Remotion、Three.js、Lottie)或動態圖形前載入,涵蓋命名的緩動代碼、影片持續時間區間、編排規則與「禁止清單」,移除最常見的範本/AI 生成的呆板動態。

mograf-public 是什麼?

這項技能定義了一套名為「motion-craft-lite」的嚴格動畫設計規範,旨在產生具有設計感而非樣板化的動態效果。它為 GSAP、CSS、WAAPI 和 Remotion 等平台預先註冊了七個命名的緩動函數(如 `mg.enter`、`mg.settle`),並規定了使用規則,例如一個片段必須使用至少三種不同的緩動角色,且同時執行的補間需來自不同的「使用者群組」。技能還提供了詳細的持續時間表,區分微互動、元素進場、英雄元素到場、相機移動等類型的建議時長,並要求最慢與最快的故事板節奏需有至少三倍的差異。核心的編排原則包含「一次一個引導」、「接觸鏈」(下個元素在前一個抵達時開始動作)、「透明度從屬」(在移動開始後才變化)以及「建構→穩定→保持」的固定結構。最後,技能明確列出「絕對禁止」的做法,例如預設的淡入效果(`opacity 0→1, y 20→0, power2.out`)、`scale(0)` 進場、統一的時間間隔、靜態元素的呼吸動畫、場景的「幻燈片切換」以及過於花俏的裝飾風格,提供一套避免常見 AI 動畫缺點的行為準則。

相容平台~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Parrass/mograf-public/tree/HEAD/plugins/mograf/skills/motion-craft-lite

在你喜歡的 AI 中提問

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

說明文件

motion-craft-lite

這些是為打造有設計感而非模板化動態所設的家規。如果上游技能或程式庫預設值在緩動、時間設定或編排上與此衝突,請遵循本檔案。

0. 單一測試

在撰寫任何補間之前,先問自己這個動作代表什麼意義? 如果答案是「讓東西出現」,請停下來。動作應該承載想法(擠壓、傾倒、斷裂、堆疊、組合、穿透),或引導視線到下一個重要的事物。

1. 緩動代碼

每個合成註冊一次,並按角色使用它們:

gsap.registerPlugin(CustomEase);
CustomEase.create("mg.enter",  ".20,.75,.34,.94"); // 進場:銳利進場,平穩落地
CustomEase.create("mg.settle", ".00,.65,.51,.99"); // 落地、鎖定、計數:快速開頭,長時間穩定
CustomEase.create("mg.travel", "1,.49,0,.55");     // 長距離 A→B 移動(S 曲線,陡峭中點)
CustomEase.create("mg.depart", ".33,0,.12,1");     // 相機/元素從靜止狀態離開
CustomEase.create("mg.exit",   "1,.02,.54,.42");   // 退出:加速離開
CustomEase.create("mg.cut",    ".15,.85,.95,.05"); // 被切斷打斷的移動,從不穩定
CustomEase.create("mg.ui",     ".23,1,.32,1");     // 影片中的 UI 微移動
CustomEase.create("mg.inout",  ".77,0,.175,1");    // 螢幕上的變形與重新構圖

相同的曲線可作為 CSS cubic-bezier(...) 在 CSS 和 WAAPI 中使用。在 Remotion 中,使用 Easing.bezier(...)。

兩個陷阱:

  • mg.settle 以垂直切線開始:在從靜止狀態(點擊後、暫停後)開始的旋轉或相機移動上,它會在一個影格內產生突兀感。請改用 mg.depart。
  • mg.travel 是S 形,且中點切線近乎垂直,而非近乎線性:它在兩端幾乎不動,在中間跳躍(在 0.75 秒的相機移動中,28% 的行程落在一個影格內)。僅用於長距離移動(約 ≥ 1.2 秒);短距離相機移動請使用 mg.inout 或烘焙彈簧,從靜止離開時使用 mg.depart。

這是完整的許可清單:mg.* 代碼加上下列內建緩動(以及一個阻尼係數 0.80–0.85 的烘焙彈簧,如果需要)。其他任何緩動(power2.out、sine.*、power4.in 等)都不在調色盤中:

  • power3.out:主力工具。
  • expo.out:切換鏡頭時的進場。
  • power3.in:切換鏡頭時的退出。
  • power4.out:硬切相機 / 主角落地。
  • power2.inOut:相機重新定位。
  • none:僅用於迴圈、跑馬燈、機械式移動和等速路徑移動。

規則:

  • 一個片段至少使用 3 種緩動角色。同一個場景中同時運行的兩個補間不應共用緩動,除非它們作為一個鎖定群組一起移動:一個補間作用於多個目標,或使用 defaults 的子時間軸,計為一個緩動使用者。
    tl.fromTo([".card", ".card-label"], { y: 60 }, { y: 0, duration: 0.7, ease: "mg.settle" }, T); // 一個群組
    const lockup = gsap.timeline({ defaults: { ease: "mg.enter", duration: 0.6 } });           // 一個群組
    lockup.fromTo(".logo", { scale: 0.94 }, { scale: 1 }, 0).fromTo(".wordmark", { xPercent: -8 }, { xPercent: 0 }, 0.08);
    tl.add(lockup, T + 0.3);
    tl.fromTo(".kicker", { yPercent: 105 }, { yPercent: 0, duration: 0.5, ease: "mg.depart" }, T + 0.3); // 同時執行 → 自己的緩動
    
  • 計數緩動使用者,而非補間。一個鎖定群組計數一次。一個由設定器驅動的代理(在 {t} 或相機物件上的一個補間,其設定器重繪場景)計為一個使用者,其補間上的緩動用於該使用者;在其繪圖函數內計算的緩動不單獨計數,因此許多同時的接觸點可以由一個驅動器運行。同時執行的驅動器仍需要不同的緩動。
  • 在打磨過程中交換緩動可能會產生新的衝突。每次交換後,重新檢查哪些補間在時間上重疊以及它們使用了什麼。
  • 交錯分佈緩動(stagger: { each, ease })是時間偏移,而非補間緩動;它們不計數。
  • 主角空間移動從不使用 linear、power1、CSS ease 或 ease-in-out。
  • 超調是選擇性的:每個片段最多一個,最多 6%,僅用於變換。back.out、elastic 和 bounce 是禁止的,除非簡報要求一個俏皮的風格。

2. 持續時間(影片,非 UI)

項目持續時間
微互動(刻度、圖示狀態)0.15–0.3 秒
元素進場0.4–0.8 秒
主角到達0.8–1.5 秒,然後保持
退出約比進場快 30%(0.25–0.5 秒)
相機移動1.0–2.5 秒,每個場景一次,比物件更平緩
硬切 / 節拍點0 秒(tl.set);用緩動處理節拍點會破壞它
閱讀停留≥ 0.5 秒 + 0.3 秒 × 字數
最終標誌 / CTA 停留≥ 0.8 秒,完全靜止,可作為縮圖
  • 節奏。
    • 最慢的故事板節拍至少是最快的 3 倍(節拍是指故事板的一行,而非內部的子補間)。
    • 在所有補間中,最長 ÷ 最短的比值應至少為 4。
    • 在構建前先命名節奏,例如 fast-fast-SLOW-cut-hold。
  • 距離和質量。 距離越長或質量越大,持續時間越長。
  • 開場。 第一個移動從 0.1–0.3 秒開始,主角在 0.5 秒前可見。
  • 社群媒體。 第 0 影格已構圖完成且可讀。永遠不要從黑色淡入。

3. 編排

  1. 一次一個引導。 在任何時刻,視線只有一個要跟隨的目標。
  2. 引導 / 跟隨偏移。 支撐元素落後主導元素 2–8 影格(緊湊)或 4–14 影格(表現性),且振幅較小。
  3. 接觸鏈。 下一個元素在前一個元素到達或接觸它時開始,而非基於任意計時器。
  4. 透明度是從屬的。 它在移動開始後才開始,並在穩定前結束。透明度單獨從不作為進場方式。
  5. 交錯。 每個項目 50–120 毫秒,使用緩動或從有意義的原點(中心、焦點、閱讀順序)開始。整個交錯持續時間為 0.6 秒或更短。
  6. 在後半段揭示。 不要將所有資訊放在場景前段。最後 50% 仍應添加資訊。
  7. 建構 → 穩定 → 保持。 每個移動都以停留狀態結束。無休止的移動是噪音。
  8. 退出比進場更簡單、更快。 在序列內部,過渡本身即是退出。
  9. 方向具有意義。 前進/下一個向左或向上;返回/關閉向右或向下。保持一致。

4. 絕對禁止

  • 預設的淡入效果。 在任何元素上使用 opacity 0→1, y 20–40→0, power2.out。文字應使用遮罩、分割、深度、切換或輕微的掠過效果代替。一個行遮罩上升效果(在 overflow-hidden 行內將 yPercent → 0),若同時在接近時加入模糊,則 yPercent 起始值應 ≥ 130;在 105 時,模糊光暈會在行移動前洩入遮罩。在建構時使用 gsap.set 隱藏遮罩行,而不是 tl.set(…, 0)(這可能欺騙對比度審查,使其取樣到未隱藏的行)。
  • scale(0) 進場。 例外:圓點、粒子和遮罩圓形。否則從 0.9–0.97 開始。
  • 統一的時間設定。 相同的持續時間,或統一的 0.1 秒交錯。
  • 閒置呼吸動畫。 在閒置元素上進行縮放或透明度的來回脈衝。應使用靜止、一個有意義的環境背景,或一個有最終姿勢的相機漂移。
  • 場景「幻燈片切換」。 淡出,然後淡入。
  • 在深色背景上使用純 #000 或線性漸層。 H.264 會使其出現色塊。請使用放射性漸層和少量粒狀效果。
  • 廉價的裝飾。 表情符號、庫存圖示、漂移的漸層色塊、堆疊的玻璃擬態、所有東西都加霓虹效果、彩虹色板。應使用 2–3 種色調加上中性色,強調色佔畫面的 10% 或更少。
  • 使用單一風格字體作為設計主體。 Inter、Roboto、Poppins、Playfair、EB Garamond、Bodoni Moda、Syne、Fraunces。選擇一個具表現力的 OFL 顯示字體,並設定緊湊的字距(−0.02 到 −0.05 em,行高大約 1.05),帶有粗細對比(300 對比 900)。
  • 將打字機 + 閃爍游標作為主要概念, 除非該片段確實是在描述打字或程式碼。
  • 一個只是停止或淡出的結尾。 設計最後一個影格並保持住。

提交前的自我檢查:

  1. 你能用 15 個字以內說出這個想法嗎?
  2. 隨機一個影格是否適合當作海報?
  3. 是否至少有 3 種緩動角色,並按角色使用?
  4. 是否有一次強烈的速度對比(極慢,然後極快)?
  5. 每個過渡是否都有動機?

5. 影片基礎

  • 1080p 下的字體大小。 標題 64–120 px(在動態消息中 90 px 或更大)。內文 32 px 或更大。
  • 層級。 主角佔據寬度的 60–80%。比例對比至少為 5:1。保留 30–50% 的負空間(置中的標誌或結束卡畫面最高可以到 75%),並錨定在網格或邊緣上。
  • 安全區域。
    • 16:9:將文字保持在 90% 標題安全區域內。
    • 9:16:頂部 14%、底部 20% 和右側 12% 內不要有文字。
    • 1:1 和 4:5:6% 邊距。
  • 影格率。
    • 30 fps 是社群媒體的預設值;UI 示範和快速文字使用 60 fps。
    • 一個片段內絕不混用影格率。
    • 沒有模糊效果的滿版橫向平移需要 5–7 秒,否則會出現抖動。
  • 確定性(HyperFrames / 任何影格渲染器)。
    • 使用一個暫停的時間軸。使用帶有絕對值的 fromTo。
    • 僅使用補間變換、透明度、濾鏡和 clip-path。不使用 CSS 過渡。
    • 不使用 Math.random 或 Date.now;使用種子化 PRNG。
    • 從本機 @font-face 檔案載入字型,並僅在 document.fonts.ready 之後才分割文字。
    • 在同一個屬性上疊加的 fromTo 補間,必須在每個變數物件中明確寫入 immediateRender: false(檢查工具會尋找文字鍵,而非添加它的輔助函數)。
    • 計算後的變換、canvas 和 Three.js 渲染應來自時間軸時間,通過設定器驅動的代理,而非 onUpdate(回呼在搜尋時會被抑制)。

這是 mograf 規範(MIT 授權)的免費子集。付費函式庫位於 mograf.si,增加了導演管線、專業技能(字體、過渡、深度、聲音)和後製堆疊。每個成品都會附上其提示、技能、原始碼和副本。若需品質控管,請將此技能與免費的 motion-review 配對使用。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相關技能