Figma 插件 API 操作助手
让智能代理按规则安全地读写 Figma 文件。
技能明确要求通过Figma MCP执行JavaScript，说明了返回数据、增量操作、节点ID、错误停止和变量范围等安全边界；但未说明用户确认、敏感数据处理、权限隔离、回滚机制或数据流范围，且依赖外部Figma服务，因此扣分。
SKILL.md对API限制、页面上下文、错误恢复和验证提出了详细规则；但common-patterns.md及多处参考示例仍使用与主文档冲突的async IIFE和closePlugin写法，且没有提交测试或可复现执行证据，静态评分受限。
触发条件、目标受众和主要不适用范围较清晰，覆盖读写、变量、组件和页面构建；但未声明中文使用支持，核心功能依赖海外Figma MCP服务，且对不可达网络或无Figma环境的替代路径说明不足。
文档按核心规则、页面规则、工作流、错误恢复和参考资料分层，维护者标记为mcp_server，并提供大量示例；但许可证、版本、变更记录、维护责任和更新路径不清晰，安装说明与故障排查仍不完整。
技能为use_figma调用提供了具体API约束、增量流程、验证方式和常见错误处理，理论上可直接辅助Figma操作；但静态材料未证明关键路径实际完成，示例冲突会导致返工，因此未接近满分。
证据主要是仓库内的SKILL.md、参考文档和配置文件，规则与API示例可审计；但没有覆盖关键路径的测试套件、CI执行结果或第三方复核，且存在互相矛盾的示例，故仅给有限分数。
- SKILL.md要求顶层await和return，但多个参考示例使用async IIFE与closePlugin；调用前应先统一采用哪套运行时约定。
- 核心功能依赖https://mcp.figma.com/mcp，未提供中国大陆网络不可达时的替代方案或离线能力。
- 文档未明确用户确认、数据流、权限范围和回滚方式；执行写操作前应由调用方自行建立这些控制。
- 未发现许可证、版本和变更记录，维护与兼容性状态需要额外核实。
它能做什么 & 适用场景
figma-use 是一个面向 Figma Plugin API 的 Agent Skill。它要求在每次调用 use_figma 之前先加载本技能，并通过 use_figma 在 Figma 文件上下文中执行 JavaScript。内容覆盖节点、变量、组件、自动布局、样式和页面切换等操作规则。它适合需要程序化创建、修改、删除或检查 Figma 内容的工作流，但依赖可用的 use_figma MCP。
它规定代理如何调用 use_figma，并要求始终传入 skillNames: "figma-use"。代理可据此在 Figma 文件上下文中执行 JavaScript，读取页面、节点、组件和变量，创建或修改节点、变量与组件，并返回 JSON 序列化的数据。每次创建或修改画布节点时，都必须返回受影响的节点 ID；复杂任务应拆分为多个调用，并在步骤后用元数据或截图验证结果。
- 设计师需要在 Figma 中批量创建或修改图层、组件和变体时。
- 设计系统维护者需要创建变量、设置变量作用域或绑定设计属性时。
- 前端或产品团队需要程序化调整自动布局、填充、文本或效果样式时。
- 自动化代理需要读取 Figma 页面结构并在后续调用中继续处理指定节点时。
优缺点一览
- 提供了较完整的 Figma Plugin API 操作约束和常见错误处理规则。
- 强调先检查、分步执行和验证，适合复杂的 Figma 自动化流程。
- 明确要求返回节点 ID，便于后续调用、校验和清理。
- 必须依赖 use_figma MCP，单独的技能文本不能直接操作 Figma。
- 资料没有提供测试结果、支持平台清单或独立许可证信息。
- 执行完整页面布局时还需要另一个 figma-generate-design 技能。
如何安装
README 说明，curated 技能可在 Codex 中运行 $skill-installer figma-use 安装；安装后重启 Codex。该资料未说明其他客户端的安装路径。
如何使用
先加载 figma-use，再提出需要操作 Figma 文件的请求，例如“在当前 Figma 文件中创建一个带自动布局的组件并返回所有新节点 ID”。涉及完整页面或多区块布局时，还需加载 figma-generate-design。任何 use_figma 调用都必须传入 skillNames: "figma-use"。