Communitygithub.com

Motion Agent 最佳實踐

Motion Agent 路由與 AI 輔助 Adobe After Effects 製作的最佳實踐。當 Codex 或其他編碼代理需要規劃、建置、修改、品質檢查、渲染或記錄 Motion Agent 的動態設計工作時使用;在不確定適用哪個 Motion Agent 技能時,作為預設的進入點。

Motion Agent 最佳實踐 是什麼?

Motion Agent 最佳實踐技能是一個路由層,用於指導 AI 代理(如 Codex 或 Cursor)在 Adobe After Effects 中進行高效的動態設計製作。其核心原則在於將 Motion Agent 視為生產工作流程,而非簡單的「生成 JSX 並祈禱它運作」。該技能定義了根據使用者請求(如建立新動畫、促銷影片、UI 演示或渲染輸出)載入適當子技能的明確規則,並強調構建可編輯的 AE 結構、保留使用者修改以及進行基於證據的驗證。此技能支援多種平台,並透過提供技能路由表、製作合約、可編輯輸出規則、驗證規則和模式推廣指南,確保 AI 代理能持續產出高品質、可重複使用的動態設計成果。

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

在你喜歡的 AI 中提問

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

說明文件

Motion Agent 最佳實踐 是做什麼的?

將此作為 Motion Agent 工作的路由層。深層的 AE 執行合約仍位於儲存庫中的 skill/SKILL.md;在接觸 After Effects 之前,請務必閱讀它。

核心原則

不要將 Motion Agent 視為「生成 JSX 然後祈禱它成功」。應將其視為生產工作流程:

  1. 理解簡報、參考資料、產品和交付情境。
  2. 選擇正確的工作流程技能。
  3. 構建可編輯的 AE 結構,而非一次性拋棄的圖層。
  4. 使用擷取的影格、抽樣值和具體證據進行驗證。
  5. 將可重複使用的模式推廣到案例或技能中。

技能路由

使用者要求載入的技能
新的影片、鏡頭、動畫或合成motion-create
啟動影片、活動影片、產品公告、社交推廣motion-promo-video
UI 動畫、產品示範、儀表板流程、卡片/滑桿/螢幕動態motion-ui-demo
可重複使用的 AE 控制項、表達式、骨架、預設集、元件化動態motion-ae-rig
審查、打磨、比較、除錯、驗證、使其符合參考motion-qa
渲染、匯出、擷取預覽、封裝交付motion-render
尋找儲存庫文件、範例、案例食譜、AE 基礎知識motion-docs

如果一個任務涵蓋多個領域,請載入最小且有用的集合。例如,一個產品發布示範通常需要 motion-promo-video、motion-ui-demo、motion-ae-rig 和 motion-qa。

編輯 AE 之前

閱讀儲存庫原始的 skill/SKILL.md,然後執行其前置檢查清單。特別注意:

  • 使用 ae_scripts/tools/run_jsx.sh 執行 JSX。
  • 尊重 AE 的 ES3 ExtendScript 限制。
  • 查詢效果 matchName,而不是猜測顯示名稱。
  • 每次腳本批次處理只進行一個邏輯變更。
  • 保留使用者所做的變更和現有的控制器值。

製作合約

每個 Motion Agent 的結果都應留下:

  • 一個可編輯的 AE 專案結構
  • 用於反覆調整的命名控制項
  • 預覽證據
  • 簡短說明,解釋變更了什麼以及驗證了什麼
  • 如果模式可能重複,則提供可重複使用的腳本或案例筆記

可編輯輸出規則

  • 為圖層、預合成、控制項、標記和輸出檔案命名,使其易於人類理解。
  • 將面向使用者的控制項放在清晰的 AI_Controls 或任務特定的控制圖層中。
  • 保持表達式可讀且本地化;優先進行精確修改,而非全面重寫。
  • 避免隱藏的魔法:如果時間或佈局是生成的,請暴露重要的控制項。
  • 除非使用者明確想要僅最終輸出,否則不要將所有內容坍縮成烘焙好的關鍵影格。

驗證規則

在宣布「完成」之前,請收集證據:

  • 擷取代表性影格
  • 檢查已變更的圖層、表達式或控制器值
  • 當動態品質很重要時,抽樣時間/緩動
  • 檢查文字邊界、標誌可讀性和合成安全區域
  • 記錄任何未經驗證的假設

模式推廣

當一個工作流程重複發生時,不要讓它埋沒在對話中:

  1. 在 cases/<category>/<case>/ 下新增或更新一個案例。
  2. 儲存 RECIPE.md、可重複使用的 JSX 以及前後對比證據。
  3. 如果該規則具有廣泛的實用性,將其簡短版本推廣到 skill/SKILL.md 或這些代理技能之一。
  4. 根據儲存庫的工作流程進行同步和提交。

Individual skills in this repo

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

相關技能