figma-create-new-file

figma-create-new-file 技能概述

figma-create-new-file 的作用

figma-create-new-file 技能会在用户的 drafts 中创建一个新的空白 Figma 文件，支持标准 design 文件或 FigJam board。它最适合你已经明确知道需要先开一个新画布，再继续执行其他 Figma 操作的场景，尤其是在 use_figma 之前或其他后续工作流步骤之前。

适合谁安装

如果你在 agent 流程里工作，并且需要模型稳定地打开正确类型的文件，而不是让用户手动去创建，那么就应该安装 figma-create-new-file。它非常适合设计落地、快速原型、workshop 搭建，以及任何把“创建文件”作为重复性第一步的 prompt。

为什么这个技能不只是一个通用 prompt

figma-create-new-file 的核心价值不只是“创建一个文件”，而是处理那些经常卡住自动化的小细节：选择 design 还是 figjam、合理默认文件名，以及在需要时解析必需的 planKey。当你希望顺畅、可预测地衔接到 Figma 工作流时，它比一次性的指令更安全。

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

安装并定位源文件

安装时，按目录中 figma/mcp-server-guide 的常规技能添加流程操作，然后先打开 skills/figma-create-new-file/SKILL.md。这个技能没有额外的辅助文件，所以你需要理解的行为都集中在这一份文档里。直接阅读技能本身很重要，因为 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，这条路径能让你从设计 brief 直接走到可用的 Figma 草稿，而不需要额外手工搭建。

figma-create-new-file 技能 FAQ

figma-create-new-file 只适用于 design 文件吗？

不是。figma-create-new-file skill 同时支持 design 和 figjam。界面设计工作用 design 文件；规划、workshop 和松散的图示草图则更适合 FigJam。

每次都必须提供文件名吗？

不必。没有提供名称时，技能会默认使用 Untitled。不过，在 prompt 里直接命名文件会让后续整理更清楚，尤其是在一次会话里可能创建多个草稿时。

这和直接让它创建一个新的 Figma 文件有什么区别？

有区别。普通 prompt 可以描述意图，但这个技能把操作细节都编码好了：命令语法、默认 editor 类型、命名默认值，以及 plan 查询行为。也正因为如此，当 agent 需要真正触发创建文件这一步时，它会更可靠。

什么情况下不该用它？

如果你已经有目标 Figma 文件，如果任务只是编辑现有 board，或者你无法提供解析 planKey 所需的访问上下文，就不要用它。在这些情况下，换一个 Figma 技能，或者直接走编辑流程，会更合适。

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

给 agent 明确的文件意图

要让 figma-create-new-file 的结果更好，最有效的方法就是在一句话里同时说清文件类型、用途和期望名称。更好的写法是：“创建一个名为 Sprint retro 的 FigJam 文件，用于团队 retrospective。”较弱的写法是：“创建一个 Figma 文件。”前者能减少歧义，也能避免技能默认成不够合适的文件类型。

保持工作流上下文可用

如果你的环境里已经有 planKey，就直接传递它，不要强行触发查找。这样可以减少一个依赖，降低流程卡住的概率。如果没有，就要确保外围 prompt 或会话允许 whoami 成功执行。

从第一个空白文件开始迭代

这个技能只负责创建文件，并不负责解决设计问题。文件创建完成后，再用同样的命名和范围继续执行下一步 Figma 操作。如果第一次生成的结果不是你想要的，先调整 editor 类型、文件名或访问上下文，再重试；不要把更多说明堆到创建这一步上。