所謂素材匯出流程（asset export pipeline），就是將設計檔案轉換為建置流程可用檔案的一連串步驟：匯出、調整尺寸、最佳化、重新命名、放置到定位。這完全屬於 coding agent 最擅長處理的重複性高、操作大量檔案的工作，但以往往往因為設計師必須拜託工程師執行而陷入停滯。一個釘選在 assets 資料夾並能在房間中對話的 agent，就能徹底省去這道繁瑣的溝通。
請求內容
「@assets 請從設計檔案匯出 1x、2x 和 3x 尺寸的圖示集，完成最佳化後放入 /public/icons。並發布一張預覽縮圖表。」
agent 的執行步驟
- 呼叫設計工具的 API 來取得最新的圖示組件。
- 匯出三種倍率的圖檔到暫存資料夾。
- 執行機器上已安裝的最佳化工具。
- 依照專案規範重新命名（規範寫在該資料夾的
README.md中）。 - 將檔案移入
/public/icons，取代既有的圖示集。 - 產生一張預覽縮圖表（contact sheet），並連同總數量發布到房間中。
設計師能在時間線上看到每一個步驟，並在最後收到預覽縮圖表。全程耗時：大約一分鐘。
哪些動作會暫停
步驟 1 需要讀取設計工具的 API token。這屬於憑證操作，因此第一次執行時會暫停並等待主人核准，畫面上會顯示卡片，註明是誰提出的請求以及 agent 想要讀取的內容。主人核准後即可繼續；token 永遠不會離開機器，設計師也絕不會看到它。請參閱 agent 執行前應一律詢問的四種操作。
如果 agent 還想要將新圖示 commit 並 push 到 main 分支，同樣也會暫停。大多數團隊的做法是允許它 commit 到分支並建立 pull request，這樣就不會觸發暫停。
如何設定
- 一個 agent，一個資料夾。 將
assets釘選到網站儲存庫的 design-assets 目錄；如果你希望 agent 遠離主要程式碼，也可以釘選到專屬的匯出資料夾。 - 寫下規範。 準備一份
README.md，寫明命名規則、尺寸、格式與目標路徑。agent 每次都會讀取它。 - 權限模式設為
acceptEdits。 寫入檔案是它的本職工作；執行命令時則依然會詢問。請參閱權限模式解析。 - 為設計師設定長期授權。 每位設計師只需核准一次，之後就能自由提出請求。
- 將 token 保留在機器上，放在該工具平常存放設定的位置。切勿將它貼進請求或 README 中。
各種情境變化
為什麼選擇房間而不是腳本
腳本只能處理匯出。而房間讓發現變更的人能直接觸發流程、觀看進度並取得結果，日常狀況下完全不需要終端機、工單或工程師介入；與此同時，非常規操作（憑證、刪除、push）依然會暫停等待主人把關。房間還會留下完整的紀錄，明確記載是誰在何時匯出了什麼。請參閱 coding agent 的能耐不只是寫程式碼。
常見問題
設計師需要設計工具的 API 存取權限嗎？ 不需要。token 存放在主人的機器上，agent 直接在該處使用。設計師提出請求，主人核准憑證讀取即可。
agent 可以建立 pull request 嗎？ 可以，只要 agent 的目錄位於儲存庫內，且在機器上具備 git 存取權限。在分支上建立 PR 不會暫停；但 push 到共用分支則會暫停。
如果設計師想修改命名規則怎麼辦？ 直接編輯該資料夾內的 README，或要求 agent 修改。它在每次處理請求時都會重新讀取最新規範。
匯出只要一分鐘。漫長的等待才是問題所在。立即為你的素材 agent 開設一個房間。
發布於