SuperAPI AI 工具集

figma-canvas-editor

设计与创作

查看项目

更新于 10-16 02:25

技能介绍

Figma Canvas Editor 是一个面向 Figma 画布直接变更的技能,适用于需要对 Figma 文件进行实际写入操作的场景。它通过 MCP 调用与 Figma 交互,在明确限定的范围内创建和编辑原生 Figma 画布对象。

用途 该技能用于直接的 Figma 变更操作。只读性质的理解工作属于 figma-context-reader,令牌与库治理属于 figma-design-system-sync,本技能不承担这些职责。

主要能力(模式)

  • create:添加画框、分区、组件、对象或布局。
  • update:更改选中的节点、布局、样式、变量、文本或组件实例。
  • delete:仅在明确限定范围时移除效果、节点、变体或过时对象。
  • figjam:编辑 FigJam 对象、分区、连接线和形状。
  • slides:在 Slides 技能可用时编辑 Figma Slides 内容。

使用方式(工作流)

  1. 确认目标文件/页面/画框/节点以及精确的变更范围。
  2. 在进行大范围更改前,优先复制重要的画框。
  3. 在任何 use_figma 调用之前,先调用 figma:figma-use。对于 FigJam 或 Slides,还需调用已安装的相关 Figma 技能。
  4. 编辑前读取当前元数据。
  5. 尽可能使用原生 Figma 对象、自动布局、组件、变量和样式来应用更改。
  6. 编辑后回读元数据,并在可用时捕获截图/导出证据。
  7. 报告变更目标、证据、跳过的检查以及回滚路径。

变更边界

  • 未经明确批准,不得进行大范围破坏性更改。
  • 除非用户要求该结果,否则不得分离实例、扁平化矢量、栅格化可编辑文本或移除变量/样式。
  • 不得凭空编造节点 ID,或在没有 MCP 证据的情况下声称某个选中节点存在。
  • 在可见时,保持设计系统命名与现有文件一致。

输出形态 使用 assets/canvas-edit-report.md。

验证与评估

  • 验证每个变更报告都包含目标、范围、变更前证据、变更后证据和跳过的检查。
  • 将缺失的回读视为 Skipped 或 Blocked,而不是成功的变更证据。
  • 使用 evals/evals.json 对限定范围的创建和破坏性删除提示进行前向测试。

适用场景 当用户明确要求添加或更改 Figma 中的画框、分区、组件、对象、布局,或修改选中节点、布局、样式、变量、文本、组件实例,或删除效果、节点、变体、过时对象时,适合使用本技能。也适用于 FigJam 对象编辑,以及在 Slides 技能可用时的 Figma Slides 内容编辑。

限制 本技能不处理只读理解与设计系统令牌/库治理。不得在无明确批准下进行大范围破坏性更改,不得分离实例、扁平化矢量、栅格化可编辑文本或移除变量/样式(除非用户要求)。不得编造节点 ID 或在无 MCP 证据下声称节点存在。缺失回读只能标记为 Skipped 或 Blocked,不能作为成功变更的证据。