Communitygithub.com

Motion 工作區

在任何包含 mg.json 的 motion graphics 工作區中,作為所有動態圖形工作的進入點——包含下三分之一、標題、動畫文字、品牌變更與渲染。請優先閱讀此技能,它會將任務路由到其他 motion-* 技能。

Motion 工作區 是什麼?

Motion 工作區技能定義了一個以 Remotion 與 mg CLI(即 `pnpm mg <command>`)為基礎、可重複使用的動態圖形渲染系統。它採用「設計即程式碼,但每個專案的具體值皆儲存於 JSON」的架構,因此任何文字、顏色或字型的修改只需編輯 JSON 檔案後執行 `pnpm mg render`,無需更動模板程式碼。此技能支援跨平台使用(Claude Code、Cursor、Codex 等),其 SKILL.md 完整說明了工作區目錄結構、權杖鏈(token chain)、內建模板(如下三分之一、標題卡、動態文字等)、以及八條核心規則(例如禁止在模板中寫死數值、以最低層級存放資料)。此外,技能提供明確的路由表,將新客戶、專案、樣式、渲染與品質檢查等任務導向對應的 `motion-*` 技能,並列出所有 mg CLI 指令(如 `check`、`render`、`still`、`studio`、`deliver` 與 `rebrand`),確保開發者能快速理解與操作整個工作流程。

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

在你喜歡的 AI 中提問

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

說明文件

Motion 工作區 是做什麼的?

此工作區透過 mg CLI(pnpm mg <command>)與 Remotion 渲染可重複使用的動態圖形。設計即為程式碼,每個專案的特定值存在 JSON 中。修改文字、顏色或字型只需編輯 JSON 並執行 pnpm mg render,無需更動程式碼。

目錄結構

mg.json                         工作區影片預設值 (fps, 尺寸)
brand/house.tokens.json         公司權杖:基本顏色、字型、動態曲線、持續時間、安全區域
brand/fonts/  brand/logos/      公司權杖參考的檔案
clients/<client>/
  client.json                   顯示名稱、可選影片覆寫
  brand/tokens.json             客戶覆寫(與公司權杖深度合併)
  brand/fonts/ brand/logos/
  brand/variants/<variant>/     命名替代外觀,可被多個專案重複使用:tokens.json, fonts/, logos/
  templates/<name>/index.tsx    僅供該客戶使用的模板,id 為 "<client>/<name>"
  projects/<project>/
    project.json                { title?, extends?: "client"|"none", brand?: "<variant>", video?, preset? }
    tokens.json                 僅供該專案使用的覆寫(可選)
    tokens.lock.json            存在時即凍結:渲染時忽略動態權杖鏈
    fonts/ logos/ assets/       專案檔案;props 以 "asset:<path>" 參考素材
    shots/<shot>.props.json     { template, props, durationSeconds?, preset?, video? }
    renders/                    輸出,被 git 忽略;manifest.json 追蹤版本

工具包程式碼(引擎、公司模板、本技能)位於 node_modules/motion-toolkit,由 package.json 固定版本。切勿在此處編輯;公司模板的變更應提交至工具包儲存庫。

公司模板

每個公司模板都有一個 look prop:minimal(簡潔、輕量字重、模糊上升、無面板)、bold(粗體大寫字型、實色色塊、彈簧彈出效果)、corporate(面板、強調欄、遮罩揭示)。預設值 "brand" 使用 look 權杖,因此客戶只需在 brand/tokens.json 設定一次風格(例如 "look": "minimal")。

Id用途
lower-third姓名與職稱帶條,可選標誌
title-card章節或段落標題,可選引文與副標題;覆疊或全畫面
callout從畫面中某點(x, y 為影格比例)到標籤的連線
end-card結尾卡片:標誌、標題、行動呼籲、網址、0–2 個 YouTube 結尾畫面欄位
kinetic-text逐字揭示的引文或陳述;*word* 表示強調
logo-sting簡短的標誌動畫揭示(開頭/結尾)
counter數字向上計數(value, prefix, suffix, decimals)搭配標籤
social-handle平台圖示加 @handle 顯示於角落(YouTube、Instagram、TikTok、X、LinkedIn…)
typewriter逐字打字的文字,渲染音訊中包含打字機或鍵盤音效
corner-branding任一角落的持續標誌浮水印,可選標籤如 LIVE

執行 pnpm mg new-shot … --template <id> 會以預設值建立每個 prop。每個 prop 的意義在 node_modules/motion-toolkit/templates/<id>/index.tsx 中的 .describe() 文字內說明。

權杖鏈

toolkit → house → client → variant(若 project.json 中有 "brand")→ project tokens.json → shot props。toolkit 層僅提供預設值(look、mono 字型、打字 sounds)。物件逐鍵合併,null 會刪除繼承的鍵,最特定層級的值優先。"extends": "none" 會跳過客戶與 variant。字型、標誌與音效檔案會在包含它們的最特定層級的 fonts/、logos/ 或 sounds/ 資料夾中尋找。

規則

  1. 每個可見值都來自 shot props 或權杖。模板中不得有寫死的顏色、字型、以 px 為單位的尺寸或時間設定。
  2. 專案存放資料,而非程式碼。新設計就是一個新模板;新工作就是一個包含 shot 檔案的專案。
  3. 將值放在擁有它的最低層級:單一 shot → shot props;單一專案 → 專案 tokens.json;客戶的數個專案 → variant;整個客戶 → 客戶權杖。
  4. 切勿手動編輯 tokens.lock.json。已交付的專案會被凍結;僅能透過 mg rebrand 修改(請見 motion-render)。
  5. 每次編輯 JSON 或模板後,請先執行 pnpm mg check 並修正回報的錯誤,再進行渲染。
  6. 每次視覺變更完成後,請先執行 motion-qa 程序,再回報完成。
  7. 在執行 mg rebrand --apply 以及編輯凍結專案使用的客戶或 variant 權杖之前,請詢問使用者。
  8. 如果渲染或 doctor 檢查失敗,請先執行 pnpm mg doctor,再修改程式碼。

路由

任務閱讀
新客戶、variant、標誌、字型、色票motion-brand
根據簡報建立新專案或 shots;修改現有 shots 的文字/顏色motion-project
新模板或修改模板動畫方式motion-template,然後 motion-style
動態感覺:動態曲線、時間、交錯、安全區域motion-style
渲染、預設集、版本、交付、套用品牌變更motion-render
交付前檢查輸出motion-qa

指令

pnpm mg templates                                  列出模板 ID
pnpm mg new-client|new-variant|new-project …
pnpm mg new-shot <client>/<project> <shot> --template <id>   建立含所有預設值的 shot 檔案
pnpm mg new-template <client> <name>               建立入門模板
pnpm mg check [<client> | <client>/<project>]     驗證一切但不渲染
pnpm mg render <client>/<project> [shot…]          略過未變更的 shot;--force, --preset
pnpm mg still <client>/<project> [shot…]           在棋盤格背景上檢視 PNG(預設為所有 shot)
pnpm mg studio <client>/<project>                  即時預覽;Studio 中的「儲存」會寫入 shot 檔案
pnpm mg deliver <client>/<project>                 渲染、驗證、凍結、將最終檔案複製到 deliver/<date>/
pnpm mg rebrand <client | client/project> [--apply]   對已交付的工作進行品牌變更
pnpm mg freeze|unfreeze|diff <client>/<project>
pnpm mg doctor                                     環境檢查、mg check、煙霧測試渲染

Individual skills in this repo

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

相關技能