用途：为 Figma REST API（外部工具调用）与 Plugin API（编辑器内插件）提供生产级代码模式。Figma 没有官方 Node.js SDK，需直接请求 https://api.figma.com，本技能给出类型安全、错误处理与可复用抽象。
主要能力：1) 类型化 REST 客户端 FigmaClient，封装 getFile、getFileNodes、getImages、getComments、postComment、getLocalVariables 等方法，统一注入 X-Figma-Token 头；2) 自定义错误类层次，区分 429 限流（含 Retry-After）、403 鉴权失败、404 未找到与通用 API 错误；3) 类型定义，覆盖 FigmaNode、FigmaFileResponse、FigmaNodesResponse、FigmaImagesResponse、ImageOptions 等；4) 节点树遍历器 walkNodes，用访问者模式查找 TEXT、COMPONENT 等节点；5) 单例客户端与 withRetry 重试包装，对限流和瞬时错误自动退避重试。
使用方式：需设置 FIGMA_PAT 环境变量，使用 TypeScript 5+ 项目，并理解 Figma 节点类型。按步骤先建客户端，再定义错误类与类型，随后实现遍历与单例重试。示例调用：new FigmaClient(process.env.FIGMA_PAT!)，再 await figma.getFile(fileKey)。
适用场景：构建可复用 Figma 客户端封装、提取设计令牌、遍历节点树、导出图片、读取与发布评论、读取本地变量。
限制：资料未提供具体收费、价格、平台支持范围与效果数据；图片导出中 SVG 始终按 1x 导出，scale 有效范围 0.01 到 4；渲染失败时 images 中对应值为 null。更多类型定义与重试单例见 references/type-definitions.md 与 references/singleton-with-retry.md。