Figma 批量图层与交付自动化

当 Figma 文件变大，手动操作就开始变得重复而脆弱：逐个翻图层、复制组件信息、导出切图、把颜色和字号抄进代码，来回刷新评论页确认修改。这个技能把这些动作交给 Agent 按固定流程执行，底层走的是 Composio 的 Figma 工具集，通过 Rube MCP 调起。

核心能力

• 读取文件与组件：从 figma.com/design/ 链接解析出 file_key，用 FIGMA_GET_FILE_JSON 拿简化后的文件数据（体积可降 70% 以上），再按需抓取指定节点、已发布组件和组件集。ids 是逗号分隔的字符串而不是数组，depth 控制遍历深度。
• 导出与渲染：先定位节点，再用 FIGMA_RENDER_IMAGES_OF_FILE_NODES 渲染成 png、svg、jpg 或 pdf，scale 取值 0.01-4.0；随后可选下载，或取图片填充的 URL。
• 设计令牌提取：一次性拿到颜色、排版、间距等本地样式与变量，可选转换为 Tailwind 配置，直接对接前端变量体系。
• 评论与版本：读取或新增评论（可用 as_md 输出 Markdown）、查 reaction、翻版本历史。
• 团队浏览：列出项目、文件以及团队已发布的样式。

上手步骤

1. 在客户端配置中加入 Rube MCP 端点 https://rube.app/mcp，不需要额外 API key。
2. 确认 RUBE_SEARCH_TOOLS 有响应，先调它拿到当前的工具 schema。
3. 调用 RUBE_MANAGE_CONNECTIONS 并指定 toolkit: figma，按返回的授权链接完成 Figma 登录。
4. 确认连接状态是 ACTIVE 之后再跑工作流。

注意点与边界

• 只支持 Design 文件；FigJam（/board/）和 Slides（/slides/）会返回 400。
• URL 里的节点 ID 是短横线格式（1-541），调 API 前要换成冒号格式（1:541）。
• ids 或 depth 范围太宽会触发 413 过大载荷，把范围收窄或降低深度即可。
• 渲染结果以 node_id 到 URL 的映射返回，个别 ID 可能是 null；URL 约 30 天后失效；单图上限 32MP，超出会自动缩放。
• 转 Tailwind 时必须把完整的 tokens 对象传下去，不要提前删字段。
• 团队端只返回已发布的样式和组件，team_id 无法程序化获取，只能从 URL 提取。
• 这个技能覆盖的是读取—转换—交付类工作流，不能替代环境相关的验证和人工复核；缺少必要参数时应该先停下来确认。