用途:从代码库在 Figma 中构建或更新专业级设计系统资产,使设计资产与代码保持一致。可按请求规模执行:仅令牌集、单个组件、完整组件库,或针对性对账更新。
主要能力:创建或更新变量集合、模式、原始值、语义别名、作用域与代码语法;创建文本与效果样式;构建组件、变体、属性与绑定;生成文档页与 Code Connect 映射;对账代码与 Figma 差异并就地更新受影响资产。
使用方式:需同时加载 figma-use 技能,每次 use_figma 调用都要在 skillNames 中包含本技能名(若通过 MCP 资源加载需加 resource: 前缀)。先做范围与验收约定,再按路径执行:令牌/基础、单组件、完整库、对账更新。调用前先 get_libraries,再 search_design_system;变更严格串行,禁止并行 use_figma。
关键规则:用 return 返回数据,不包 IIFE、不调 closePlugin;每次返回所有创建/变更节点 ID;每次调用开头 await figma.setCurrentPageAsync(page) 且每脚本最多一次;颜色为 0–1;写文本前必须 await figma.loadFontAsync;变量必须设置作用域与代码语法(WEB 用 var() 包裹);语义层用 VARIABLE_ALIAS 指向原始值;图标用 INSTANCE_SWAP;不得猜测 Node ID。
状态管理:长流程需将状态账本写入 /tmp/design-system-state-{RUN_ID}.json,每轮开始重读;创建前按名称与账本 ID 做幂等检查;恢复时先只读扫描重建映射。
适用场景:需要将代码中的设计令牌与组件同步到 Figma 的团队。限制:需 figma-use 技能配合;未提供具体收费、平台与效果信息;资料未完整给出后续章节内容。