figma-create-new-file

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

create_new_file — Create a New Figma File

create_new_file — 创建新的Figma文件

Use the

create_new_file

MCP tool to create a new blank Figma file in the user's drafts folder. This is typically used before

use_figma

when you need a fresh file to work with.

使用

create_new_file

MCP工具在用户的草稿文件夹中创建一个空白的Figma文件。通常在需要全新文件进行操作时，会在调用

use_figma

之前使用该工具。

Skill Arguments

技能参数

This skill accepts optional arguments:

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

editorType:
```
design
```
(default) or
```
figjam
```
fileName: Name for the new file (defaults to "Untitled")

Examples:

```
/figma-create-new-file
```
— creates a design file named "Untitled"
```
/figma-create-new-file figjam My Whiteboard
```
— creates a FigJam file named "My Whiteboard"
```
/figma-create-new-file design My New Design
```
— creates a design file named "My New Design"

Parse the arguments from the skill invocation. If editorType is not provided, default to

"design"

. If fileName is not provided, default to

"Untitled"

该技能接受可选参数：

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

editorType：
```
design
```
（默认值）或
```
figjam
```
fileName：新文件的名称（默认为“Untitled”）

示例：

```
/figma-create-new-file
```
— 创建一个名为“Untitled”的设计文件
```
/figma-create-new-file figjam My Whiteboard
```
— 创建一个名为“My Whiteboard”的FigJam文件
```
/figma-create-new-file design My New Design
```
— 创建一个名为“My New Design”的设计文件

从技能调用中解析参数。如果未提供editorType，默认使用

"design"

。如果未提供fileName，默认使用

"Untitled"

。

Workflow

工作流程

Step 1: Resolve the planKey

步骤1：解析planKey

The

create_new_file

tool requires a

planKey

parameter. Follow this decision tree:

User already provided a planKey (e.g. from a previous
```
whoami
```
call or in their prompt) → use it directly, skip to Step 2.
No planKey available → call the
```
whoami
```
tool. The response contains a
```
plans
```
array. Each plan has a
```
key
```
,
```
name
```
,
```
seat
```
, and
```
tier
```
.
- Single plan: use its
```
key
```
  field automatically.
- Multiple plans: ask the user which team or organization they want to create the file in, then use the corresponding plan's
```
key
```
  .

create_new_file

工具需要

planKey

参数。请遵循以下决策流程：

用户已提供planKey（例如来自之前的
```
whoami
```
调用或在提示中）→ 直接使用该密钥，跳至步骤2。
无可用planKey → 调用
```
whoami
```
工具。返回结果包含一个
```
plans
```
数组，每个计划包含
```
key
```
、
```
name
```
、
```
seat
```
和
```
tier
```
字段。
- 单个计划：自动使用其
```
key
```
  字段。
- 多个计划：询问用户想要在哪个团队或组织中创建文件，然后使用对应计划的
```
key
```
  。

Step 2: Call create_new_file

步骤2：调用create_new_file

Call the

create_new_file

tool with:

Parameter	Required	Description
`planKey`	Yes	The plan key from Step 1
`fileName`	Yes	Name for the new file
`editorType`	Yes	`"design"` or `"figjam"`

Example:

json

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

使用以下参数调用

create_new_file

工具：

参数	是否必填	说明
`planKey`	是	步骤1中获取的计划密钥
`fileName`	是	新文件的名称
`editorType`	是	`"design"` 或 `"figjam"`

示例：

json

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

Step 3: Use the result

步骤3：使用返回结果

The tool returns:

```
file_key
```
— the key of the newly created file
```
file_url
```
— a direct URL to open the file in Figma

Use the

file_key

for subsequent tool calls like

use_figma

工具返回以下内容：

```
file_key
```
— 新创建文件的密钥
```
file_url
```
— 打开该Figma文件的直接链接

后续调用

use_figma

等工具时，可使用

file_key

。

Important Notes

重要说明

The file is created in the user's drafts folder for the selected plan.
Only
```
"design"
```
and
```
"figjam"
```
editor types are supported.
If
```
use_figma
```
is your next step, load the
```
figma-use
```
skill before calling it.

文件会创建在所选计划对应的用户草稿文件夹中。
仅支持
```
"design"
```
和
```
"figjam"
```
两种编辑器类型。
如果下一步要调用
```
use_figma
```
，请先加载
```
figma-use
```
技能再进行调用。