figma-create-new-file

在 Figma 中创建新文件

使用 create_new_file MCP 工具创建新的 Figma Design、FigJam 或 Slides 文件的步骤。

步骤 1：解析 planKey 和 editorType

使用用户为此任务提供或选择的 planKey。否则，调用 whoami 并检查返回的方案。

• 没有方案：告知用户无法继续创建文件。
• 只有一个方案：将其 key 用作 planKey。
• 有多个方案：显示可用方案，请用户选择一个，然后将该方案的 key 用作 planKey。

根据请求的文件类型，从工具公布的输入枚举中选择 editorType。如果不明确，请用户指定文件类型。

步骤 2：调用 create_new_file

调用 create_new_file 工具，并提供全部三个必需参数：

• fileName：必需。如果用户未提供，请选择一个简洁的名称。
• planKey：必需。使用步骤 1 中解析出的 planKey。
• editorType：必需。使用步骤 1 中选择的 editorType。
• projectId：可选。设置后可在指定项目中创建文件。

{
  "fileName": "Quarterly planning",
  "planKey": "team::1234567890",
  "editorType": "design"
}

• 后续调用 use_figma 等工具时，使用 create_new_file 工具响应中的 file_key。

步骤 3：（仅限 Slides）处理空网格

新的 Slides 文件不包含任何幻灯片：figma.getSlideGrid() 返回 []。在读取幻灯片中的主题令牌等属性之前，调用 figma.createSlide() 或处理空情况。首次调用 createSlide() 会自动创建第 0 行并插入幻灯片。