Communitygithub.com

motion-render

渲染、交付和重新品牌化動態圖形片段 — 預設集、輸出版本、交付(驗證+凍結+複製最終檔),以及對已交付專案套用品牌變更。

motion-render 是什麼?

motion-render 是一個專為動態圖形 (Motion Graphics) 工作流設計的 AI 代理技能,支援渲染、交付與品牌重新套用。它提供從單一片段到整個專案的渲染指令,並支援多種輸出預設(如 overlay、delivery、webm-alpha)以滿足不同平台需求。交付流程會先驗證所有檔案的正確性(如 Alpha 通道、幀大小、FPS),再凍結專案並將最終檔案複製到日期目錄,確保後續編輯不會影響已交付的成果。品牌重新套用功能可預覽變更並選擇性套用,凍結的專案會自動鎖定品牌,未凍結的專案則在下次渲染時遵循新品牌。此外,還包含 diff 指令來查看專案差異,以及 doctor 指令協助診斷環境問題。此技能主要支援 Node.js 環境(透過 pnpm 執行),適用於需要批次處理動態圖形渲染與交付的開發者或工作室。

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

在你喜歡的 AI 中提問

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

說明文件

渲染與交付

請先執行 pnpm mg check <客戶>/<專案>;僅在報告沒有問題時才進行渲染。

渲染

pnpm mg render <客戶>/<專案>            全部片段
pnpm mg render <客戶>/<專案> lt-ceo     一個片段
pnpm mg render <客戶>/<專案> --force    即使未變更也重新渲染

輸出:renders/<片段>_v<序號>.<副檔名>。每個改變像素的渲染會獲得下一個版本號;舊版本會保留。renders/manifest.json 記錄影響像素的所有內容的雜湊值(屬性、解析後的代幣、字型/標誌/素材內容、預設集、工具包版本、客戶端範本程式碼)。未變更的片段會跳過。

預設集

預設集檔案用途
overlay(預設)ProRes 4444 .mov 含 Alpha 通道在 Resolve/Premiere/FCP 中覆蓋在素材上的下三分之一與標題
deliveryH.264 .mp4,透明區域為黑色審閱連結、全幀圖形
webm-alphaVP9 .webm 含 Alpha 通道網頁播放器;大多數編輯器忽略 WebM Alpha

可依片段設定("preset")、依專案設定(project.json)或依執行指令設定(--preset)。

交付

當使用者交付出專案(或表示圖形已是最終版本)時:

pnpm mg deliver <客戶>/<專案> [片段…]

它會渲染已變更的內容,驗證每個檔案(overlay/webm-alpha 的 Alpha 通道、幀大小、FPS),凍結專案,並將最終檔案複製到 deliver/<YYYY-MM-DD>/<片段>.<副檔名>。如果驗證失敗,則不會凍結或複製任何內容;請修復報告的問題並重新執行。告知使用者 deliver/ 資料夾路徑。

凍結意味著:後續的內部、客戶或變體編輯不會改變此專案的渲染結果。

套用品牌變更

在使用者變更客戶或變體代幣(新的顏色、字型、標誌)後:

  1. 預覽:pnpm mg rebrand <客戶>(或 <客戶>/<專案> 用於單一專案)。它不會做任何修改,並按專案列出當前品牌會更改的內容。設定為 "extends": "none" 的專案會跳過。
  2. 向使用者顯示清單,詢問要更新哪些:全部、部分專案,或都不更新(僅新作品)。
  3. 套用使用者選擇的項目:pnpm mg rebrand <客戶> --apply 或按專案執行 pnpm mg rebrand <客戶>/<專案> --apply。凍結的專案會重新鎖定到當前品牌;所有列出的專案會渲染成新版本。舊版本保留在 renders/ 中。
  4. 對新渲染執行 motion-qa。對於使用者再次交付的專案,執行 pnpm mg deliver 以重新整理 deliver/。

不執行重新品牌化也是有效的答案:凍結的專案保持其交付的外觀,只有未凍結的專案在下次渲染時跟隨品牌。

其他品牌指令:

  • pnpm mg diff <客戶>/<專案>:查看單一專案與其鎖定(凍結)或上次渲染(未凍結)之間的差異。
  • 對一個自上次渲染後品牌已變更的未凍結專案進行渲染,會列印包含變更的警告。
  • 在凍結專案上僅編輯專案代幣:編輯 tokens.json,然後執行 pnpm mg rebrand <客戶>/<專案> --apply。

失敗情況

  • 命名屬性、代幣、字型或文字寬度的錯誤來自驗證;請修正 JSON,而非範本。pnpm mg check 會一次列出所有問題。
  • 瀏覽器啟動、缺少函式庫、編碼器或路徑錯誤:請執行 pnpm mg doctor。

Individual skills in this repo

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

相關技能