SuperAPI AI 工具集

figma-extractor

设计与创作

查看项目

更新于 10-15 16:51

技能介绍

用途:从 Figma 文件提取设计令牌、样式、组件元数据与画面结构,供下游开发或设计流程消费。触发场景包括出现 figma.com URL,或有人提及相关内容。

主要能力:

  • 提取设计变量与令牌,并按来源打标签(figma-variables 优先级最高,其次 figma-library,最后 figma-context),用于冲突消解。
  • 三级提取深度:Level 1(Quick)使用 whoami、get_metadata、get_variable_defs、get_design_context、get_screenshot 等只读 MCP 工具;Level 2(Deep)加入 use_figma 只读脚本,补充 collections/modes、codeSyntax、scopes、别名链、文本/效果/绘画样式;Level 3(Targeted)再加 search_design_system 与 get_context_for_code_connect,获取库资源与组件精确属性定义。
  • 组件清单与属性分类(state/size/style/content/text/swap)、样式映射、库资源、画面索引、提取摘要与质量信号(硬编码颜色、间距不一致、游离实例、孤儿变量、样式与变量不匹配)。

使用方式:先调用 whoami 验证 MCP 连接;从 URL 解析 fileKey 与 nodeId(node-id 中的短横线转冒号);用 get_metadata 映射文件结构并识别顶层 frame 为画面;按级别提取数据后合并输出。use_figma 调用须传 skillNames: "figma-extractor",脚本只读、不修改节点/变量/样式,且以 return 返回数据;use_figma 不可用则回退 Level 1。建议在 2-3 个复杂画面上运行以获取可靠的使用频次数据。

适用场景:设计交付、设计系统搭建、令牌校验与比较、画面目录编制。

限制:FigJam(/board/)与 Slides(/slides/)不支持;提取为增强而非必需,失败时流程可继续;无 URL 且 MCP 未连接则跳过;getLocalVariablesAsync 只返回本地变量,库变量需靠 Level 3 查询;提取仅为只读,不修改 Figma 文件;价格与收费信息暂未提供。