Motion Retrospective(動態回顧)
每一個完成的作品都應該讓代理變得比之前更好。當渲染被確認時,趁著證據仍在運行時(處理過的指令在 7 天後會被清理),回顧整個建構過程,並將其轉化為下一個工作階段可以重複使用的知識。
觸發時機
請在同一回合,當使用者確認最終渲染/匯出時啟動此技能,例如:
"渲染好了 / 导出了 / 就这版 / ship it / looks good, exporting"。橋接也會在每次渲染指令的結果中加入 bridgeHealth.retrospective 作為提醒。
請不要等待被再次詢問。
步驟
-
收集。 記錄工作階段開始的時間,然後執行:
python3 tools/retrospective.py --slug <作品名稱> --since <工作階段開始時間或例如 6h> [--match "<主要合成名稱>"]這會在
cases/_inbox/<日期>-<slug>/下寫入TIMELINE.md、FAILURES.md、scripts/(每個成功的變動腳本,已去重)以及stats.json。 -
截取證據。 從最終渲染中擷取 4-6 幀畫面(使用
captureFrame或tools/run_capture.sh),並用tools/sheet.py建立聯絡表。 儲存到evidence/。切勿提交影片、.aep檔案或客戶素材與字型。 -
審查時間線。 對於每一輪指令,記錄:
- 使用者要求的內容(從對話中擷取)、變更了什麼、以及是哪個腳本執行;
- 機制,而不僅僅是外觀(骨架結構、表達式、關鍵值、圖層順序);
- 使其運作的數值(持續時間、緩動影響、偏移量、尺寸);
FAILURES.md中的每一個失敗:其原因及修復方法。
-
拆分為配方。 一個作品通常包含多個可重複使用的技術。為每個技術建立自己的資料夾
cases/<分類>/<技術>/(分類:text-animation、shape-animation、ui-animation、transitions、effects),其中包含RECIPE.md、一個清理後的可重複使用.jsx、PROMPT_TEMPLATE.md以及證據。在cases/projects/<作品>/RECIPE.md中維護一個專案索引,用於連結這些配方,例如sync-dubbing-studio。將專案特定的圖層名稱與可轉移的方法分開。 -
提升規則。 將任何超出當前作品範圍的內容複製到
skill/SKILL.md: 新的陷阱(坑位速查)、新的使用者反饋翻譯(反饋翻譯表)以及配方索引。 在LEARNING_MAP.md中標記或新增項目。當案例計數或專案表格發生變化時,更新README.md/README.zh-CN.md。 -
發佈。
tools/publish_case.sh cases/<分類>/<技術> "學到的內容" --push該腳本會清除
/Users/<name>/路徑、拒絕影片/音訊/.aep 檔案、執行tools/health_check.py、提交並推送。僅在倉庫擁有者已選擇加入(MOTION_AGENT_AUTO_PUBLISH=1,或他們曾要求這樣做)時自動推送;否則僅提交並詢問。 -
向使用者回報簡短的幾行內容:新增了多少配方、提升了哪些規則,以及提交連結。
品質標準
- 一個配方應指出機制並提供可重現的數值。
- 每個陷阱都應說明什麼出了問題、原因以及修復方法。
- 公用倉庫中不得包含客戶資產、私有路徑或未發佈的素材。
- 如果該作品沒有教會任何新東西,請說明這一點,並僅將證據添加到現有案例中。