用途:从现有代码库出发,在 Figma 里搭建或更新专业级设计系统,使设计系统与代码保持一致。该技能不提供插件 API 语法规则,那些由 figma-use 技能提供;本技能负责设计系统领域知识与工作流编排。每次 use_figma 调用都需同时加载 figma-use,并传入 skillNames: "figma-generate-library"(日志参数,不影响执行)。
主要能力:按固定阶段推进。阶段0 发现:分析代码库提取 token/组件/命名,检查 Figma 文件与已订阅库,锁定 v1 范围并解决代码与 Figma 的冲突。阶段1 基础:创建变量集合与模式,先建原始变量,再建别名到原始变量的语义变量,设置 scopes、code syntax,并创建效果样式与文本样式。阶段2 文件结构:创建 Cover、Getting Started、Foundations、Components、Utilities 等页面及基础文档页。阶段3 组件:按依赖顺序逐个创建,含自动布局、变量绑定、变体组合、组件属性与页面文档,并做结构验证与截图。阶段4 集成与质检:Code Connect 映射、可访问性审计、命名审计、未解析绑定审计与整页截图复核。
关键规则:任何阶段都不可一次性完成,阶段间必须设置用户检查点;变量必须先于组件存在;尽量绑定视觉属性到变量,但图标像素网格等固定几何可例外;每个变量需设置 scopes,语义变量需别名到原始变量而非复制原始值;WEB code syntax 需使用 var() 包裹,如 var(--color-bg-primary);组件变体矩阵超过 30 组合需拆分;图标用 INSTANCE_SWAP 而非每个图标建变体;状态管理可用 getSharedPluginData/setSharedPluginData 和状态账本文件 /tmp/dsb-state-{RUN_ID}.json 保证幂等与可恢复;use_figma 调用必须严格串行,不得并行。
限制:不改变代码内容;资料未提供具体收费、价格、平台支持范围与效果承诺,暂未提供。使用前需确认 Figma 访问环境与相关技能加载条件。