figma-sync

figma-sync 是一款专注于设计开发一体化的双向同步工具，旨在打通 Figma 设计稿与前端代码之间的壁垒。该技能通过调用 Figma REST API，实现了从设计稿读取、设计令牌提取到 React Native Expo 或 Web React + Tailwind 代码生成的完整工作流，同时支持将本地修改差异写回 Figma，形成设计与开发的闭环协作。

核心用法围绕四个主要命令展开：figma_pull 用于读取 Figma 文件并生成代码资产，支持按节点 ID 精确提取特定组件；figma_push 允许将本地设计模型的修改推回 Figma，默认采用 dry-run 模式预览变更，仅在显式添加 --execute 参数后执行实际写入；figma_diff 对比本地模型与远程 Figma 文件状态，生成最小化补丁方案；figma_preview 则提供变更预览能力，帮助团队在实施前评估影响范围。所有操作均通过环境变量配置的 FIGMA_TOKEN 进行身份验证，确保访问权限可控。

显著优点包括：真正的双向同步能力，不仅支持设计到代码的单向转换，还能将开发过程中的设计调整反馈回设计源文件；多平台代码生成支持，同时覆盖移动端（React Native + Expo + TypeScript）和 Web 端（React + Tailwind CSS）；内置安全机制，写操作默认 dry-run 避免误操作；智能缓存策略，通过 ETag 和指数退避算法优化 API 调用，有效应对 Figma 约 30 次/分钟的速率限制。

潜在局限性需关注：作为 T3 级社区来源项目，虽经安全审计但仍缺乏大型企业背书；写回 Figma 功能依赖配套插件支持，并非所有环境都能完整使用双向同步；需要妥善管理 Personal Access Token，存在密钥泄露风险；API 调用受限于 Figma 平台速率，大规模设计系统同步可能效率受限。

适合目标群体主要包括：前端开发者，特别是使用 React 技术栈需要快速将设计稿转化为可维护代码的工程师；UI/UX 设计师，希望建立设计令牌（Design Tokens）体系并确保设计与实现一致性的设计系统维护者；以及需要频繁同步设计变更与代码实现的敏捷开发团队。

使用风险方面，除常规的 API 限流外，主要需关注 FIGMA_TOKEN 的安全存储，建议通过环境变量或密钥管理系统配置，避免硬编码。本地 .figma-cache/ 目录会持续缓存 API 响应，需定期清理防止磁盘空间无限增长。网络请求仅发送至 Figma 官方 API（api.figma.com），但仍需确保使用环境允许访问外部设计平台服务。