用途:一次性读取整个 Figma 设计系统,输出统一的令牌、组件与样式清单,作为代码生成和库审计的入口。
主要能力:提取所有本地变量(按 collection 和 mode 分组);提取独立组件与组件集,含属性定义及每个变体的紧凑 visualSpec;提取 paint/text/effect 样式及其解析值。颜色以十六进制输出,间距/尺寸以 px 输出,变量尽量将别名解析为 {Color.Brand.Primary} 形式的令牌名。
使用方式:先加载官方 figma-use 技能(Figma Plugin API 参考)。脚本为纯 JS,使用顶层 await 与 return,无 IIFE、不调用 figma.closePlugin(),输入以 const 内联在脚本顶部,颜色为 0–1 范围,文本操作前先加载字体,使用 await figma.getNodeByIdAsync(...),错误为原子性(失败脚本不产生任何更改)。在 scripts/inventory.js 中调整常量控制响应大小:INCLUDE 可选 tokens、components、styles(默认三者全开);VERBOSITY 可选 full(含每变体视觉规格)、summary(组件元数据与属性,不含每变体规格)、inventory(仅名称/ID/计数,适合超大文件);COMPONENT_NAME_FILTER 用子串限制组件(如 Button)。通过 use_figma 运行,skillNames 为 design-system-inventory-figma。结果过大时降低 VERBOSITY 或收窄 INCLUDE/COMPONENT_NAME_FILTER 后重跑,不要对巨型完整转储分页。
适用场景:需要一次性获取令牌+组件+样式统一清单的代码生成、设计库审计;原生 MCP 的 get_design_context 仅针对单个选区,get_metadata 返回扁平结构,均无法提供该统一清单。
限制:该脚本只捕获每个组件/变体的根视觉规格及其直接子级(childSpecs),不会递归更深层级;单组件无限深度请用 deep-component-figma,单变体集转 CSS 状态机请用 analyze-component-set-figma,磁盘上的令牌文件请用 export-tokens-figma。visualSpec 的字段定义见 references/visual-spec.md。该技能通过 Plugin API 读取变量,适用于所有 Figma 计划,无需 Enterprise REST。其他收费、价格、平台或效果信息暂未提供。