figma-create-new-file

figma-create-new-file 技能概览

figma-create-new-file 是做什么的

figma-create-new-file 会在用户的 drafts 中创建一个全新的空白 Figma Design 文件或 FigJam board，通常是后续更深入 Figma 操作的第一步。它适合需要一个干净起点、想把新任务和现有文件分开，或者希望在文件创建完成后再调用 use_figma 的场景。

适合谁安装

如果你经常在 Figma 里自动化 UI Design 初始化、原型启动或 workshop board 创建，就应该安装 figma-create-new-file 技能。它最适合需要一种稳定、低摩擦方式来新建文件的 agent 和工作流，不必每次都手动陪跑文件创建这一步。

使用前要先看什么

关键决策其实很简单：选 design 还是 figjam，再决定是否给文件命名。这个技能还会在没有 planKey 时通过 whoami 处理 plan 解析；如果你跳过前置上下文，这往往就是导致无法直接调用的主要原因。

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

安装并确认 Figma MCP 配置

请在 OpenAI skills 环境中使用这个技能，并确保 Figma MCP server 可用。仓库指向的是 https://mcp.figma.com/mcp，所以这不是一个单纯的 prompt 小技巧；它依赖 Figma 工具连接处于激活状态。如果技能不可用，最常见的失败原因通常是 MCP 访问缺失，而不是措辞不对。

传入正确的输入

使用格式是 /figma-create-new-file [editorType] [fileName]。editorType 默认是 design，fileName 默认是 Untitled，所以只需要填写会改变结果的部分即可。不错的例子有：

• /figma-create-new-file
• /figma-create-new-file figjam My Whiteboard
• /figma-create-new-file design Landing Page v2

对于 figma-create-new-file usage，最有用的输入是简短、明确的意图，再加上想要的文件类型和名称。如果你要的是协作用白板，就说 figjam；如果你要的是可继续工作的设计画布，就说 design。

先读这些文件

如果你想快速做出安装决策并稳定执行，先读 SKILL.md，再读 agents/openai.yaml 了解 prompt 和依赖上下文，最后看 LICENSE.TXT，把 beta/terms 的边界弄清楚。如果你想理解为什么这个技能会请求 plan 解析，建议先检查 SKILL.md 里的 whoami 和 create_new_file 工作流，再尝试改造成你自己的用法。

一个能少出错的实用工作流

按这个顺序用：先决定 editor type，再选一个有意义的名字，确认是否已经知道 planKey，然后再调用技能。比如你从“找个地方先草拟 onboarding flow”这种粗略任务开始，可以改写成：“Create a FigJam board named Onboarding Flow Workshop.” 如果你要准备设计任务，就用：“Create a design file named Checkout Redesign Draft.” 清晰命名能减少后续沟通混乱。

figma-create-new-file 技能常见问题

figma-create-new-file 只适合新文件吗？

是的。figma-create-new-file 技能就是专门用来创建一个全新的空白文件，不是用来编辑现有页面或自动生成布局的。如果你已经有目标文件，这个技能就不是合适的入口。

每次都需要提供 planKey 吗？

不需要。这个技能在需要时可以通过 whoami 解析 plan key。如果你手头已经有有效的 planKey，就从前文上下文中传过去；否则可以预期它会先完成这一步查找，再创建文件。

这个技能适合 UI Design 工作吗？

适合，尤其适合你需要先有一个干净的 design file，才能继续使用其他 Figma 操作的场景。对于 figma-create-new-file for UI Design 来说，核心价值就是提速：它把启动步骤移除掉，让你可以直接进入结构搭建、frames 排布，或者面向交付的工作。

什么情况下不该用这个技能？

如果你需要修改已有文件、一次创建多个文件，或者自动生成设计内容，就不要用 figma-create-new-file。如果你的环境无法连接到 Figma MCP server，或者你的工作流本身不支持 Figma drafts，这个技能也帮不上忙。

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

提供最小但有用的简报

最好的结果来自一句话同时说清 editor type 和文件用途。比如“Create a FigJam board for a product kickoff”就比“make a file”更好，因为它给了技能明确目标，也减少了命名歧义。对于 figma-create-new-file install 的决策来说，这正是它值得加入的主要原因：它能把模糊的起步动作，一步变成可用文件。

避免常见失败模式

最常见的问题是把文件类型留成隐含默认值，而实际你需要的是相反的类型。另一个问题是文件最终会共享给团队，却仍然用了 Untitled 这种过于泛泛的名字。如果你后面还要接着用 use_figma，一定要让文件名和文件类型与下一步动作匹配，避免之后再花时间重命名或重新打开。

下次用更好的上下文迭代

如果第一次输出不是你想要的，下次就补充 board 目的、受众和文件类型。示例升级如下：

• 弱：Create a file
• 更强：Create a design file named Mobile Nav Exploration for a redesign review
• 最强：Create a FigJam board named Q3 App Onboarding Workshop for cross-functional brainstorming

这类上下文能让 figma-create-new-file guide 始终贴近真实工作目标：快速打开正确类型的 Figma 工作区，并把后续修正降到最低。