Figma

核心用法

Figma Design Skill 通过 ClawLink 平台与 Figma REST API 建立 OAuth 安全连接，为开发者与设计师提供从设计到代码的无缝桥梁。核心能力覆盖四大维度：

设计文件解析：通过 figma_get_file_json 获取完整设计文件结构，配合 figma_discover_figma_resources 从任意 Figma URL 提取 file_key、node_id 等关键标识，快速定位设计资源。

资产导出与渲染：支持 PNG、SVG、JPG、PDF 多格式下载（figma_download_figma_images），可针对特定节点按需渲染，满足开发切图需求。

设计令牌工程化：figma_extract_design_tokens 自动提取颜色、文字、效果、间距等设计系统变量，并通过 figma_design_tokens_to_tailwind 一键生成 Tailwind CSS 配置，显著降低设计系统落地成本。

协作与自动化：内置评论管理（增删改查及表情反应）与 Webhook 能力，支持文件变更实时通知，便于对接 CI/CD 流程。

显著优点

• 零配置接入：通过 ClawLink 托管 OAuth 流程，无需手动申请 Figma API Token
• 深度设计工程化：设计令牌到代码的自动转换，解决设计系统同步痛点
• 双向协作支持：评论管理功能打通设计与产品、开发团队的沟通闭环
• 灵活 Webhook：支持文件、项目、团队三级事件订阅，适配自动化工作流

局限与注意事项

• 文件类型限制：仅支持 Design 文件，FigJam 白板和 Slides 返回 400 错误
• 权限依赖：团队级 Webhook 需管理员权限，设计令牌提取依赖 Styles/Variables 规范编码
• 资源时效性：生成的图片下载 URL 14 天后过期，需及时落盘
• 生态绑定：完全依赖 ClawLink 作为中间层，若 ClawLink 服务不可用则能力中断

适合人群

• 前端开发者：需从设计稿提取样式、导出切图、生成 Tailwind 配置
• 设计系统维护者：管理设计令牌、维护组件库、同步设计规范至代码
• 产研团队：需要自动化设计评审流程、文件变更通知与协作评论管理

常规风险

• OAuth 授权范围：ClawLink 持有用户 Figma 账户的访问令牌，存在第三方托管信任风险
• 数据出境：设计文件内容经 ClawLink 服务器代理传输，敏感设计需评估合规性
• 写操作确认：删除评论、Webhook 等破坏性操作需用户显式确认，避免误操作
• 服务连续性：ClawLink 为独立商业服务，需关注其服务等级协议与长期可用性

核心用法

Figma Design Skill 是一套基于 ClawLink 代理服务的文档型集成方案，让用户无需自行配置 API 密钥即可在 OpenClaw 环境中操作 Figma 设计资源。核心能力覆盖六大模块：

1. 文件与资源发现：从 Figma URL 提取 file_key、node ID、团队/项目 ID；获取文件元数据、完整 JSON 结构、特定节点内容、已发布样式与组件。

2. 评论与互动管理：读取文件全部评论及表情反应；支持添加评论、回复、删除（仅限原作者）、添加/删除表情反应。所有写入操作需用户显式确认。

3. 资产导出：下载 PNG、SVG、JPG、PDF 格式的节点图像；渲染指定节点为图片；获取图像填充的临时下载 URL（有效期 14 天）。

4. 设计令牌提取：从 Figma 文件提取颜色、文字、效果、栅格等设计令牌，并直接转换为 Tailwind CSS 配置文件。

5. Webhook 配置：为文件、项目或团队级事件创建、更新、删除 Webhook，查询最近 7 天的 Webhook 请求历史。团队级 Webhook 需管理员权限。

6. 团队与项目管理：列举团队内的项目、项目中的文件，以及团队库中已发布的组件、样式和组件集。

显著优点

• 零配置接入：通过 ClawLink OAuth 托管认证流程，用户无需生成或保管 Figma Personal Access Token。
• 纯文档架构：Skill 本身仅含 Markdown 文档，无可执行代码，消除本地代码执行风险。
• 明确权限边界：所有写入操作强制要求用户确认，符合最小权限原则；高影响操作（删除评论、Webhook）有额外标记。
• Tailwind 原生支持：设计令牌可直接转换为 Tailwind 配置，加速设计到代码的交付流程。
• 企业级安全认证：通过 CLS-Certify S 级认证（90/100 分），满足 GDPR、CCPA 合规要求。

潜在缺点与局限性

• 来源可信度 T3：维护者为个人开发者（hith3sh），无知名组织背书，需关注其长期维护能力与更新动态。
• 代理服务依赖：核心功能依赖 ClawLink 代理，若该服务不可用或遭遇安全事件，将直接影响 Skill 功能及潜在的凭证安全。
• 文件类型限制：仅支持 Figma Design 文件（figma.com/design/...），FigJam 画板与 Slides 文件会返回 400 错误。
• Webhook ID 限制：团队、项目、文件 ID 无法通过 API 直接发现，必须从 Figma URL 手动提取或使用专用工具解析。
• 评论层级限制：评论回复无法嵌套，仅能附加到根评论。
• 令牌提取盲区：未编码为 Figma 样式或变量的设计元素会被静默忽略。

适合人群

• 前端开发者需要将 Figma 设计系统快速转换为 Tailwind CSS 配置
• 产品经理与设计师需要在对话界面中快速检索设计文件、导出资产、管理评论
• 团队管理员需要自动化监听 Figma 文件变更事件（通过 Webhook）
• 对 API 配置敏感、希望使用托管 OAuth 方案的安全意识较强的用户

常规风险

| 风险类别 | 描述 | 缓解措施 |

|---------|------|---------|

| 第三方代理风险 | ClawLink 作为 OAuth Token 托管方，若被攻破可能导致凭证泄露 | 确保使用 HTTPS，关注 ClawLink 安全公告 |

| 误操作写入 | 评论删除、Webhook 删除等操作不可逆 | 强制用户确认流程，操作前预览 |

| 临时 URL 过期 | 图像下载链接 14 天后失效 | 获取后立即下载，勿长期依赖 |

| 权限不足 | 团队级 Webhook 需管理员权限 | 操作前验证用户角色与权限范围 |