Communitygithub.com

itswenxin/動態回顧

在使用者確認 After Effects 作品為最終版本後立即執行。回顧作品背後的所有橋接操作,提煉可重複使用的配方、陷阱與規則,並將其收錄至案例庫和 skill/SKILL.md,最後發佈至倉庫。

動態回顧 是什麼?

Motion Retrospective(動態回顧)是一個專為 After Effects 工作流程設計的 AI 代理技能,能在使用者確認最終渲染或匯出後,自動回顧整個專案建構過程。它收集所有成功的橋接操作及失敗記錄,並從中提煉出具備可重複性的技術配方、常見陷阱與規則,同時將這些知識結構化地存入案例庫及 skill/SKILL.md 文件。該技能支援 Claude Code 等代理平台,透過標準化的步驟(收集、截圖證據、時間線審查、配方拆分、規則提升與發佈)將完成的專案轉化為可被後續工作階段直接復用的知識,從而持續提升代理的生產力與專案質量。

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

在你喜歡的 AI 中提問

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

說明文件

Motion Retrospective(動態回顧)

每一個完成的作品都應該讓代理變得比之前更好。當渲染被確認時,趁著證據仍在運行時(處理過的指令在 7 天後會被清理),回顧整個建構過程,並將其轉化為下一個工作階段可以重複使用的知識。

觸發時機

請在同一回合,當使用者確認最終渲染/匯出時啟動此技能,例如: "渲染好了 / 导出了 / 就这版 / ship it / looks good, exporting"。橋接也會在每次渲染指令的結果中加入 bridgeHealth.retrospective 作為提醒。 請不要等待被再次詢問。

步驟

  1. 收集。 記錄工作階段開始的時間,然後執行:

    python3 tools/retrospective.py --slug <作品名稱> --since <工作階段開始時間或例如 6h> [--match "<主要合成名稱>"]
    

    這會在 cases/_inbox/<日期>-<slug>/ 下寫入 TIMELINE.md、FAILURES.md、scripts/(每個成功的變動腳本,已去重)以及 stats.json。

  2. 截取證據。 從最終渲染中擷取 4-6 幀畫面(使用 captureFrame 或 tools/run_capture.sh),並用 tools/sheet.py 建立聯絡表。 儲存到 evidence/。切勿提交影片、.aep 檔案或客戶素材與字型。

  3. 審查時間線。 對於每一輪指令,記錄:

    • 使用者要求的內容(從對話中擷取)、變更了什麼、以及是哪個腳本執行;
    • 機制,而不僅僅是外觀(骨架結構、表達式、關鍵值、圖層順序);
    • 使其運作的數值(持續時間、緩動影響、偏移量、尺寸);
    • FAILURES.md 中的每一個失敗:其原因及修復方法。
  4. 拆分為配方。 一個作品通常包含多個可重複使用的技術。為每個技術建立自己的資料夾 cases/<分類>/<技術>/(分類:text-animation、shape-animation、ui-animation、transitions、effects),其中包含 RECIPE.md、一個清理後的可重複使用 .jsx、PROMPT_TEMPLATE.md 以及證據。在 cases/projects/<作品>/RECIPE.md 中維護一個專案索引,用於連結這些配方,例如 sync-dubbing-studio。將專案特定的圖層名稱與可轉移的方法分開。

  5. 提升規則。 將任何超出當前作品範圍的內容複製到 skill/SKILL.md: 新的陷阱(坑位速查)、新的使用者反饋翻譯(反饋翻譯表)以及配方索引。 在 LEARNING_MAP.md 中標記或新增項目。當案例計數或專案表格發生變化時,更新 README.md / README.zh-CN.md。

  6. 發佈。

    tools/publish_case.sh cases/<分類>/<技術> "學到的內容" --push
    

    該腳本會清除 /Users/<name>/ 路徑、拒絕影片/音訊/.aep 檔案、執行 tools/health_check.py、提交並推送。僅在倉庫擁有者已選擇加入(MOTION_AGENT_AUTO_PUBLISH=1,或他們曾要求這樣做)時自動推送;否則僅提交並詢問。

  7. 向使用者回報簡短的幾行內容:新增了多少配方、提升了哪些規則,以及提交連結。

品質標準

  • 一個配方應指出機制並提供可重現的數值。
  • 每個陷阱都應說明什麼出了問題、原因以及修復方法。
  • 公用倉庫中不得包含客戶資產、私有路徑或未發佈的素材。
  • 如果該作品沒有教會任何新東西,請說明這一點,並僅將證據添加到現有案例中。

Individual skills in this repo

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

相關技能