figma-create-new-file

create_new_file — 创建新的 Figma 文件

强制要求：在每次调用 create_new_file 工具之前必须先加载本 Skill。 本 Skill 封装了计划解析决策树（plan-resolution decision tree）、编辑器类型规范（editor-type contract）以及创建完成向 use_figma 转交控制权的完整逻辑。

使用 create_new_file MCP 工具在用户的草稿文件夹（drafts folder）中新建一个空白 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 字段。
   • 包含多个计划：询问用户想在哪个团队（Team）或组织（Organization）中创建文件，然后使用对应计划的 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 中直接打开该文件的 URL 链接

在后续工具调用（如 use_figma）中使用返回的 file_key。

注意事项

• 文件将创建在对应计划下用户的**草稿文件夹（drafts folder）**中。
• 支持的编辑器类型为 "design"、"figjam" 和 "slides"。
• 如果下一步需要调用 use_figma，请在调用前先加载 figma-use Skill。

特殊编辑器说明

Slides — 新创建的文件包含一个空网格

通过此工具生成的 slides 演示文稿文件初始状态为 0 行 0 幻灯片 — figma.getSlideGrid() 会返回 []，而不是默认包含一张初始幻灯片。页面下唯一的子节点是 SLIDE_GRID 节点本身，在创建内容之前它一直为空。首次调用 figma.createSlide() 会隐式创建第 0 行并将新幻灯片插入其中。

如果你后续的 use_figma 脚本假定至少存在一张幻灯片（例如需要从中读取主题 Token），请务必先对空网格情况做好防护逻辑，或者先调用 createSlide()。详见 figma-use-slides → slide-grid。