AI Skills
figma-create-new-file

figma-create-new-file

熱門

**必要前置條件** — 在每次呼叫 `create_new_file` 工具**之前**，你**必須**先調用此 Skill。切勿在未載入此 Skill 的情況下直接呼叫 `create_new_file`。只要使用者想要建立新的空白 Figma 檔案（例如新的 Design、FigJam 或 Slides 檔案），或者你在呼叫 `use_figma` 前需要一個全新檔案時，即觸發此 Skill。使用方式 — /figma-create-new-file [editorType] [fileName]（例如：/figma-create-new-file figjam My Whiteboard、/figma-create-new-file slides Q3 Review）

1832星標
171分支
更新於 2026/7/30
獲取技能源代碼

相關技能

ui-to-vue24萬imagegen-frontend-mobile9.4萬bmad-ux5.3萬
SKILL.md
唯讀
名稱
figma-create-new-file
描述

**必要前置條件** — 在每次呼叫 `create_new_file` 工具**之前**，你**必須**先調用此 Skill。切勿在未載入此 Skill 的情況下直接呼叫 `create_new_file`。只要使用者想要建立新的空白 Figma 檔案（例如新的 Design、FigJam 或 Slides 檔案），或者你在呼叫 `use_figma` 前需要一個全新檔案時，即觸發此 Skill。使用方式 — /figma-create-new-file [editorType] [fileName]（例如：/figma-create-new-file figjam My Whiteboard、/figma-create-new-file slides Q3 Review）

create_new_file — 建立新的 Figma 檔案

必要條件：在每次呼叫 create_new_file 工具前，必須先載入此 Skill。 本 Skill 包含方案解析決策樹、編輯器類型規範，以及建立檔案後移交給 use_figma 的完整流程。

使用 create_new_file MCP 工具在使用者的草稿資料夾中建立全新的空白 Figma 檔案。當你在執行 use_figma 前需要一個全新檔案來進行操作時，通常會用到此功能。

Skill 參數

此 Skill 接受選填參數：/figma-create-new-file [editorType] [fileName]

  • editorType：design（預設）、figjam 或 slides
  • fileName：新檔案的名稱（預設為 "Untitled"）

範例：

  • /figma-create-new-file — 建立名為 "Untitled" 的 Design 檔案
  • /figma-create-new-file figjam My Whiteboard — 建立名為 "My Whiteboard" 的 FigJam 檔案
  • /figma-create-new-file design My New Design — 建立名為 "My New Design" 的 Design 檔案
  • /figma-create-new-file slides Q3 Review — 建立名為 "Q3 Review" 的 Slides 簡報檔案

解析 Skill 調用時傳入的參數。若未提供 editorType，預設為 "design"。若未提供 fileName，預設為 "Untitled"。

工作流程

步驟 1：解析 planKey

create_new_file 工具需要傳入 planKey 參數。請依循以下決策樹處理：

  1. 使用者已提供 planKey（例如來自先前呼叫 whoami 的結果或直接寫在 Prompt 中）→ 直接使用該 Key，並跳至步驟 2。

  2. 尚未取得 planKey → 呼叫 whoami 工具。工具回傳的結果中會包含 plans 陣列，每個方案皆含有 key、name、seat 及 tier 等欄位。

    • 只有單一方案：自動使用其 key 欄位。
    • 包含多個方案：詢問使用者想在哪個團隊或組織中建立檔案，再使用對應方案的 key。

步驟 2：呼叫 create_new_file

使用以下參數呼叫 create_new_file 工具：

參數 必填 說明
planKey 是 來自步驟 1 的方案 Key
fileName 是 新檔案的名稱
editorType 是 "design"、"figjam" 或 "slides"

範例：

{
  "planKey": "team:123456",
  "fileName": "My New Design",
  "editorType": "design"
}

步驟 3：使用回傳結果

工具會回傳：

  • file_key — 新建立檔案的 Key
  • file_url — 可在 Figma 中直接開啟該檔案的直連網址

請將 file_key 用於後續的工具呼叫（例如 use_figma）。

重要注意事項

  • 檔案會建立在所選方案中使用者的草稿資料夾 (drafts folder) 內。
  • 支援的編輯器類型包含 "design"、"figjam" 與 "slides"。
  • 若下一步需要呼叫 use_figma，請在呼叫前先載入 figma-use Skill。

編輯器專屬注意事項

Slides — 新建立的檔案包含空白網格

透過此工具建立的 slides 檔案初始狀態為 0 列且 0 張投影片 — figma.getSlideGrid() 會回傳 []，而非預設提供第一張投影片。頁面唯一的子節點僅有 SLIDE_GRID 節點本身，在建立內容前皆為空值。首次呼叫 figma.createSlide() 時，會自動建立 Row 0 並將新投影片插入其中。

若後續的 use_figma 指令碼假設至少存在一張投影片（例如需要從中讀取主題 Token），請務必針對空白情況做好防護處理，或先呼叫 createSlide()。完整細節請參閱 figma-use-slides → slide-grid。