用途
Figma Design 技能是一份基于官方 Figma Plugin API 文档的综合指南，用于指导 Figma 设计工作流与插件开发。当需要处理以下任务时可使用该技能：构建自定义插件、UI 扩展或自动化工具；创建和管理变量、样式、组件与库；构建可复用组件、变体与实例；实现带约束与间距的响应式框架；创建带反应与流程的交互原型；跨多个节点自动化重复设计任务；以多种格式导出资源；在节点上存储和读取插件/共享数据；管理版本历史、评论与团队工作流。
主要能力
节点层级与组件
Figma 文档结构是节点树，从 DocumentNode 根节点开始，包含 PageNode、FrameNode、TextNode、RectangleNode、ComponentNode、SectionNode、Group 等。关键节点类型包括 FRAME（支持自动布局的容器）、COMPONENT（可复用主元素）、INSTANCE（组件副本）、TEXT（可编辑文本层）、基础形状（RECTANGLE、ELLIPSE、POLYGON、STAR、LINE）、SECTION（组织容器）和 GROUP（非布局容器）。组件可多次实例化，组件属性包括 BOOLEAN（切换可见性或状态）、TEXT（自定义文本内容）、INSTANCE_SWAP（交换嵌套组件）和 VARIANT（组件变体）。
自动布局与约束
自动布局创建随内容变化而自适应的响应式框架。核心属性包括 layoutMode（HORIZONTAL、VERTICAL 或 NONE）、primaryAxisSizingMode 与 counterAxisSizingMode（FIXED 或 AUTO）、四边内边距、itemSpacing（子元素间距）、主轴与交叉轴对齐方式。子元素约束包括 minWidth、maxWidth、minHeight、maxHeight、layoutAlign（MIN、CENTER、MAX、STRETCH）和 layoutGrow（0 固定或 1 填充容器）。约束控制节点在父级变化时的缩放方式，类型有 MIN（固定到上/左边缘）、CENTER（居中）、MAX（固定到下/右边缘）、STRETCH（随父级缩放）和 SCALE（保持比例位置与大小）。
变量与设计令牌
变量用于创建动态设计系统（仅限 Figma Design）。可创建变量集合、颜色变量、为默认模式设置值、添加暗色模式、创建变量别名引用，并将变量绑定到节点。变量类型包括 COLOR、FLOAT、BOOLEAN 和 STRING。
样式
样式定义可复用的视觉属性，包括绘制样式（填充/描边）、文本样式（字号、字体、行高、字距）和效果样式（阴影、模糊），并可应用到节点。
原型
反应定义原型中的交互行为，可设置触发器（ON_CLICK、ON_HOVER、ON_PRESS、ON_DRAG、MOUSE_ENTER、MOUSE_LEAVE、MOUSE_UP、MOUSE_DOWN、AFTER_TIMEOUT）和导航类型（NAVIGATE、SWAP、OVERLAY、SCROLL_TO、CHANGE_TO）。还可配置覆盖层位置、背景与交互行为，以及框架滚动行为（overflowDirection、numberOfFixedChildren）。
插件开发
插件基本结构包含 manifest.json（插件配置）、code.ts（主逻辑）和可选的 ui.html。插件生命周期包括初始化、显示 UI、加载保存的偏好设置、向 UI 发送初始数据、处理 UI 消息和关闭时清理。UI 通信通过 figma.ui.postMessage 和 window.onmessage 双向进行。事件监听可监控选择变化、文档变化和页面变化。
数据存储
插件数据（私有）通过 setPluginData/getPluginData 存取；共享插件数据通过命名空间 setSharedPluginData/getSharedPluginData 存取；客户端存储通过 clientStorage 的 setAsync/getAsync/deleteAsync/keysAsync 持久化设置。
节点查找
findAllWithCriteria 是大型文档中最快的搜索方法，可按类型、插件数据、共享插件数据或组合条件查找。传统方法包括 findAll、findOne、getNodeByIdAsync 和递归树遍历。
导出与图片处理
可通过 exportAsync 导出 PNG、JPG、SVG，支持按比例、宽度或高度约束。可加载 URL 图片、从字节创建图片、从 SVG 字符串创建节点。
文本处理
创建文本前必须先加载字体。可设置内容、字体、字号、行高、字距、对齐、大小写和装饰，并可对文本范围应用富文本格式化。
调整大小与变换
支持 resize（应用约束）、resizeWithoutConstraints、rescale（按比例缩放），以及位置、相对变换、绝对变换和边界框操作。
协作功能
插件无法通过 API 创建评论，但可导航到带评论的框架、通过 REST API 读取评论元数据、触发通知。插件数据可用于跟踪自定义版本信息。
使用方式
该技能以代码示例形式提供具体用法，涵盖创建组件与实例、构建自动布局框架、设置约束、创建变量与样式、设置原型反应、编写插件清单与生命周期、UI 通信、事件监听、数据存储、节点查找、导出、文本处理和变换等操作。开发者可参照示例在 Figma 插件环境中实现相应功能。
适用场景
适用于 Figma 插件开发、设计系统管理、组件架构设计、响应式布局实现、交互原型制作、批量设计任务自动化、资源导出与集成、节点数据管理以及团队协作工作流。
限制
变量功能仅限 Figma Design。插件无法通过 API 创建评论。创建文本前必须加载字体。部分操作（如 setReactionsAsync、getNodeByIdAsync、createImageAsync、getSizeAsync）为异步方法。资料未提供该技能的收费、价格、平台支持范围或效果保证等信息。