SuperAPI AI 工具集

figma-create-new-file

设计与创作

查看项目

更新于 10-16 07:28

技能介绍

用途:这是 Figma 的 create_new_file 工具的前置技能,必须在每次调用 create_new_file 之前加载,不能直接调用该工具。它封装了 planKey 解析决策树、编辑器类型约定以及创建后交接给 use_figma 的流程。

主要能力:通过 create_new_file MCP 工具在用户草稿文件夹中创建新的空白 Figma 文件,通常在需要全新文件配合 use_figma 时使用。

使用方式:技能接受可选参数 /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 创建 FigJam 文件;/figma-create-new-file slides Q3 Review 创建演示文稿。

工作流:第一步解析 planKey——若用户已提供则直接使用;否则调用 whoami 工具,其返回的 plans 数组含 key、name、seat、tier,单一 plan 自动取其 key,多个 plan 则询问用户选择团队或组织。第二步调用 create_new_file,需传 planKey、fileName、editorType 三个必填参数。第三步使用返回结果:file_key 用于后续如 use_figma 的调用,file_url 可直接在 Figma 中打开文件。

限制与注意:文件创建在所选 plan 的草稿文件夹中;支持的编辑器类型仅 design、figjam、slides;若下一步是 use_figma,需先加载 figma-use 技能。Slides 文件初始为空网格,figma.getSlideGrid() 返回 [],页面唯一子节点是空的 SLIDE_GRID,首次调用 figma.createSlide() 才会隐式创建第 0 行并插入幻灯片,后续脚本若假设已有幻灯片需先做空值防护或先调用 createSlide()。