figma-create-new-file

figma-create-new-file 技能概覽

figma-create-new-file 是做什麼的

figma-create-new-file 技能會在使用者的 drafts 中建立一個全新的空白 Figma 檔案，並支援一般 design 檔案或 FigJam 白板。當你已經知道在進行其他 Figma 動作前需要先有一個新的畫布時，它特別有用，尤其適合在 use_figma 或其他後續工作流程步驟之前先完成建立。

誰應該安裝它

如果你是在 agent 流程中工作，而模型需要穩定地開啟正確類型的檔案、而不是每次都叫使用者手動處理，就應該安裝 figma-create-new-file。它很適合設計落地、快速原型、工作坊準備，以及任何把建立檔案當作可重複第一步的 prompt。

為什麼這個技能不只是一般的提示詞

figma-create-new-file 技能的核心價值，不只是「建立一個檔案」，而是把那些常常卡住自動化的小操作細節處理好：選擇 design 還是 figjam、合理預設檔名，以及在需要時解決必填的 planKey。這讓它比一次性指令更安全，當你想要穩定交接到 Figma 工作流程時尤其如此。

如何使用 figma-create-new-file 技能

安裝並找到來源

安裝時，先依照目錄中 figma/mcp-server-guide 的一般技能新增流程操作，接著先開啟 skills/figma-create-new-file/SKILL.md。這個技能沒有額外的 helper 檔案，所以你需要理解的行為都在這一份文件裡。直接讀技能內容很重要，因為 figma-create-new-file install 的路徑雖然簡單，但正確呼叫仍然取決於參數規則。

在 prompt 中傳入正確輸入

figma-create-new-file usage 的格式是：

/figma-create-new-file [editorType] [fileName]

design 用來建立空白的 Figma design 檔，figjam 用來建立白板型檔案。若省略 editorType，預設會是 design。若省略名稱，預設會是 Untitled。好的 prompt 會直接寫清楚，例如：「建立一個名為 Q3 workshop notes 的 FigJam 檔，然後繼續進行規劃流程。」

俐落處理 plan 解決

這個技能在呼叫 create_new_file 之前，可能需要先取得 planKey。如果你已經從 whoami 或前一步驟拿到它，就應該把它帶進工作流程上下文，避免重複解析；如果沒有，預期技能會先檢查 whoami。這點很重要，因為 prompt 失敗通常不是卡在建立檔案動作本身，而是少了身分或 plan 上下文。

依正確順序閱讀工作流程

先看參數區段，再看 Workflow 區段，接著是 Step 1: Resolve the planKey 與 Step 2: Call create_new_file 的說明。這個順序能讓你看出實際執行路徑：先解析指令、確認存取上下文，再建立檔案。如果你是在用 figma-create-new-file for Design Implementation，這條路徑就是把設計簡報帶到可用的 Figma 草稿，且不需要額外手動設定。

figma-create-new-file 技能常見問題

figma-create-new-file 只適用於 design 檔嗎？

不是。figma-create-new-file skill 同時支援 design 與 figjam。介面設計工作用 design 檔，規劃、工作坊和較鬆散的圖解則用 FigJam。

每次都要提供檔名嗎？

不需要。當沒有提供名稱時，技能預設會使用 Untitled。不過，若在 prompt 直接命名，會讓後續整理更清楚，尤其是在同一個 session 可能建立多個草稿時。

這跟直接叫它建立一個新的 Figma 檔有什麼不同？

有差。一般 prompt 可以描述意圖，但這個技能把操作細節都編進去了：指令語法、預設 editor 類型、命名預設值，以及 plan 查找行為。當 agent 必須真的觸發建立檔案這一步時，它會更可靠。

什麼情況下不該使用它？

如果你已經有目標 Figma 檔案、任務只是編輯既有白板，或你無法提供解析 planKey 所需的存取上下文，就不應該使用它。在這些情況下，改用其他 Figma 技能，或直接進入編輯流程，通常更合適。

如何改進 figma-create-new-file 技能

把檔案意圖講得更精準

要讓 figma-create-new-file 的結果更好，最有效的方法就是在一句話裡同時說清楚檔案類型、用途和預期名稱。較好的寫法：Create a FigJam file named Sprint retro for a team retrospective. 較弱的寫法：Make a Figma file. 前者能降低歧義，也能避免技能退回到沒那麼實用的預設檔案類型。

保留工作流程上下文

如果你的環境裡已經有 planKey，就直接傳遞過去，不要硬逼它重新查找。這樣可以少一個依賴，也能降低流程卡住的機率。如果你沒有 planKey，就要確保周邊 prompt 或 session 允許 whoami 正常執行。

從第一個空白檔開始迭代

這個技能只負責建立檔案，不會替你解決設計問題。檔案建立完成後，請用同一份命名與範圍設定，接續下一個 Figma 動作。如果第一次輸出不是你要的結果，先調整 editor type、檔名或存取上下文，再重試；不要把更多指令硬疊在建立步驟上。