Talk to Figma 设计读写器
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_3c6cb52e/read-and-modify-figma-designs-from-coding-agents-with-talk-to-figma-mcp。
技能介绍
问题:设计稿与代码之间的断层
Figma 是绝大多数团队的设计事实标准,但一旦进入实现阶段,设计稿和代码之间就会出现断层。设计师在画布上完成布局、间距和组件变体,工程师则需要回到 IDE 里凭肉眼和标注还原。人工对照不仅容易漏掉 1px 的对齐偏差,也难以在组件状态、自动布局和多端适配之间保持一致。更现实的问题是,编码代理(如 Cursor 或 Claude Code)虽然擅长生成代码,却无法直接感知 Figma 画布上的上下文——它们不知道当前选中的是哪个图层,也不知道某个节点背后的约束条件。
机制:通过 MCP 把 Figma 接入代理
这个技能解决的就是上述断层。它依赖 Talk to Figma 插件和本地 WebSocket 服务,把 Figma 暴露为一组 MCP 工具,让编码代理可以直接读取和修改设计数据。核心能力包括:
- 读取当前选择:通过
read_my_design获取当前选中节点的详细属性,不需要额外传参,适合让代理快速理解设计师当前关注的部分。 - 查询指定节点:
get_node_info针对单个节点返回完整信息,get_nodes_info支持通过节点 ID 数组批量获取多个节点的详情。 - 修改与批量操作:代理可以基于返回的结构创建新节点、添加标注,或对已有设计进行批量更新,而不必逐个手动点击。
边界与注意点
这条链路依赖几项前置条件:本地需要运行 Bun,客户端必须支持 MCP(如 Cursor),Figma 桌面端或 Web 端需要安装 Talk to Figma 插件,并且 WebSocket 服务器要保持在线。另一个需要留意的地方是批量编辑的风险:当代理一次性修改大量节点时,一旦结构或命名不匹配,后续节点可能无法正确解析。建议在执行批量操作前先用只读工具检查返回的节点信息,确认 ID 和层级关系后再做修改。此外,插件版本的更新可能影响工具参数,使用时应以上游文档为准。
使用场景
- 前端工程师在 Cursor 中接入 Figma,让代理读取当前选中图层并自动生成对应组件代码。
- 设计系统团队需要批量检查 Figma 组件的命名与属性,代理通过 `get_nodes_info` 一次性拉取多个节点详情。
- 设计师在 Figma 中调整完布局后,代理根据 `read_my_design` 返回的节点结构生成注释,供开发对照实现。
- 需要将 Figma 中的标注同步到代码仓库时,代理可读取特定节点信息并批量更新相关文件。
适合人员
- 前端工程师希望让 Cursor 直接读取 Figma 选区并生成组件代码,减少手动对照标注的时间。
- 设计系统维护者需要在 Figma 中批量检查组件属性与命名,并同步到开发流程。
- 全栈开发者希望让编码代理读取 Figma 节点并自动添加注释,辅助实现阶段复刻设计。
- 团队中负责设计到代码衔接的工程师,希望用代理批量读取节点信息并更新代码仓库。