SuperAPI AI 工具集

understand-figma

设计与创作

查看项目

更新于 10-15 21:37

技能介绍

用途:通过 Figma REST API 分析指定 Figma 文件,生成交互式设计知识图谱,并在已有仪表盘中展示页面、屏幕、组件、组件集、实例等设计结构。

主要能力:分阶段执行——预检解析参数、扫描抓取并解析 Figma 数据、用 LLM 对节点分批分析、合并生成 knowledge-graph.json 与 meta.json,最后清理中间文件并启动仪表盘。支持通过 --language 指定语言,支持增量判断(UP_TO_DATE 时跳过重建)。

使用方式:需设置 FIGMA_TOKEN 环境变量(在 figma.com/settings 创建个人访问令牌),并满足 Node ≥ 22、pnpm ≥ 10。核心命令包括:FIGMA_TOKEN="$FIGMA_TOKEN" node <SKILL_DIR>/figma-scan.mjs "$PROJECT_ROOT" "<url-or-key>" 与 node <SKILL_DIR>/figma-merge.mjs "$PROJECT_ROOT"。若 packages/core/dist/figma/index.js 缺失,需先构建:cd "$PLUGIN_ROOT" && (pnpm install --frozen-lockfile 2>/dev/null || pnpm install) && pnpm --filter @understand-anything/core build。

适用场景:需要理解或梳理 Figma 设计文件结构、生成设计知识图谱并可视化浏览时。

限制:令牌仅从环境读取,仅通过 X-Figma-Token 请求头发送,不得写入图谱、meta.json、日志或中间文件;该技能会向 api.figma.com 发起外部调用,并非完全离线。缺少令牌时应停止并提示用户先设置。其余细节暂未提供。