Figma设计工具v2

集成Figma API，实现设计文件浏览、结构读取、图片导出、评论管理、版本查看及设计变量获取自动化操作。

Install

openclaw skills install @thcjp/figma-design-paid

功能说明: 本技能涵盖自动化配置和灵活的参数设置、时使用、化配置和灵活的参数设置等核心能力。

功能说明: 本技能涵盖化流程等核心能力。

Figma

上线流程

确认运行环境满足依赖说明中的要求
在AI Agent对话中调用本技能,提供必要的输入参数
检查输出结果,根据需要进行后续处理

详细的输入输出格式请参考下方章节说明。

场景示例

场景	输入	输出
文件操作	文件路径与操作参数	操作结果与文件元信息
图片生成	提示词与尺寸参数	图片文件与分辨率
令牌处理	令牌数据与编解码模式	编码结果与校验状态

不适用于：需要人工判断的复杂决策场景

输入定义

参数名	类型	必填	说明
content	string	否	处理的内容输入
mode	string	否	处理模式, 可选值: json/text/markdown
style	string	否	输出风格, 参考 `references/style.md`

响应格式

json

{
  "success": true,
  "data": {
    "result": "处理结果",
    "status": "success",
    "metadata": {
    "metadata": {
      "template_used": "reviewer",
      "word_count": 0,
      "style": "专业"
    }
  },
  "error": null
}

输出模板参考: assets/output.json

安装与配置

运行环境

Agent平台: 支持SKILL.md的任意AI Agent(Claude Code / Cursor / Codex / Gemini CLI等)
操作系统: Windows / macOS / Linux

依赖说明(补充)

依赖项	类型	是否必需	获取方式
LLM API	API	必需	由Agent内置LLM提供

API Key 配置

可用性分类

分类: MD+execute()
说明: 基于Markdown的AI Skill,

API Key配置方式:

bash

export API_KEY="${API_KEY:?请设置环境变量}"

配置后需重启会话或开启新终端生效。API Key应妥善保管,避免泄露到版本控制系统.

限制条件

file_key 从 Figma URL 获取：https://figma.com/design/{file_key}/...
node_id 格式为 "1:2"（冒号分隔），从 Figma URL 的 node-id 参数获取（URL 中用 - 分隔，需转为 :）
get_file 不带 depth 参数会返回完整文件树，大文件可能很慢，建议使用 depth: 1 或 depth: 2
导出图片返回的是临时 URL，有效期有限
account_id 参数通常省略，工具自动检测已链接的 Figma 账号
变量 API 可能需要 Figma Enterprise 计划才能完整使用

创新特色

===

效率提升量化分析

操作步骤	手动耗时	自动化耗时	时间节约	准确率提升
设计文件导出	30分钟	5分钟	25分钟	10%
设计版本对比	1小时	10分钟	50分钟	20%
组件搜索与替换	2小时	20分钟	1小时40分钟	15%
图片批量导出	4小时	1小时	3小时	30%
设计变量管理	2小时	30分钟	1小时30分钟	25%

===

差异化对比

对比维度	本技能	手动操作	Python脚本	专业软件
功能集成	完整集成Figma API，支持多种操作	单个功能需逐个实现	部分功能可自动化，但需编写脚本	功能全面，但操作复杂，学习成本高
易用性	界面友好，操作简单	操作繁琐，需要熟悉Figma操作	需要编写脚本，操作复杂	界面复杂，需要一定学习曲线
成本	无需额外软件，节省成本	需要购买专业软件	需要编写脚本，成本较高	成本高，但功能全面
个性化	可自定义操作流程	不可自定义	可自定义，但需要编程知识	可自定义，但操作复杂

===

核心痛点解决

痛点	描述	影响范围	解决方案	量化效果
设计文件管理困难	设计文件数量多，管理复杂	影响设计效率和质量	自动化设计文件管理流程	提高设计效率30%
版本控制困难	版本控制不当，容易丢失设计	影响设计质量和团队协作	自动化版本控制	提高设计质量20%
组件重复使用低效	组件重复使用率低，设计效率低	影响设计效率	自动化组件搜索与替换	提高设计效率15%

常见问题FAQ

===

Q1: Figma设计工具v2如何实现自动化设计文件管理？

A: Figma设计工具v2通过集成Figma API，实现自动化设计文件管理，包括文件导出、版本对比、组件搜索与替换等功能，提高设计效率。

Q2: Figma设计工具v2如何实现自动化版本控制？

A: Figma设计工具v2通过自动化版本对比和合并功能，实现自动化版本控制，确保设计版本的安全性和一致性。

Q3: Figma设计工具v2如何实现自动化组件搜索与替换？

A: Figma设计工具v2通过集成Figma API，实现自动化组件搜索与替换，提高设计效率。

Q4: Figma设计工具v2支持哪些操作系统？

A: Figma设计工具v2支持Windows、macOS和Linux操作系统。

Q5: Figma设计工具v2是否支持多语言？

A: Figma设计工具v2支持中文交互，无需复杂配置即开即用。

故障应对方案

===

错误现象	可能原因	诊断步骤	解决方案
无法连接Figma	网络连接问题	检查网络连接，重试连接	检查网络连接，确保网络畅通
无法读取设计文件	权限问题	确认Figma API权限设置正确	调整Figma API权限设置
无法导出图片	权限问题	确认Figma API权限设置正确	调整Figma API权限设置
执行超时	网络延迟或模型负载过高	请求重试；确认Agent平台LLM服务正常	请求重试；确认Agent平台LLM服务正常
输入内容格式不正确	用户输入不符合skill预期格式	检查输入是否符合skill使用说明中的格式要求，参考示例章节	检查输入是否符合skill使用说明中的格式要求，参考示例章节

安全指导原则

===

确保API Key安全，避免泄露到版本控制系统。
定期检查Figma API权限设置，防止权限滥用。
限制对Figma设计文件的访问权限，防止数据泄露。
对敏感操作进行日志记录，便于后续审计。
定期更新Figma设计工具v2，修复已知安全漏洞。

安全风险防范

风险项	等级	防护措施	验证方法
API密钥泄露	高	通过环境变量配置，禁止硬编码	定期检查代码和配置文件
命令执行风险	高	仅执行白名单命令，避免拼接用户输入	使用沙箱环境测试
网络通信安全	中	使用HTTPS协议，验证SSL证书	定期检查证书有效期
敏感数据暴露	高	输出结果中不包含密钥、令牌等敏感信息	日志脱敏审查
未授权访问	中	限制访问权限，实施认证机制	定期审计访问日志

功能介绍

自动化执行: Figma 集成。浏览团队项目与文件，读取设计结构、页面、节点，导出图片，管理评论，查看版本历史，检查组件/组件集/样式
文件处理: 支持多种文件格式的读取、解析和写入操作
API集成: 通过标准化接口调用外部服务并处理响应
命令执行: 在安全沙箱中执行系统命令并收集结果
信息检索: 快速搜索和过滤目标数据

Figma设计工具v2通用排查步骤

检查输入参数: 确认所有必填参数已提供且格式正确
查看日志输出: 定位具体错误行和异常类型
验证环境配置: 确认依赖库版本和运行环境满足要求
逐步调试: 缩小问题范围,隔离故障模块

前置条件

已安装所需运行环境(参考依赖说明)
已获取必要的API密钥或访问凭证(如适用)
输入数据已准备就绪