用途:分析指定的 Figma 文件,生成交互式设计知识图谱并在现有仪表盘中呈现。
主要能力:
- 解析 Figma 文件 URL 或裸文件键,支持可选的 --language <lang> 语言参数。
- 通过捆绑的 figma-scan.mjs 脚本调用 Figma REST API 抓取并解析设计数据,生成 scan-manifest.json 并输出节点数量。
- 将设计节点按约 15 个一批分组(尽量按页面分组),调用 design-analyzer 子代理进行 LLM 增强分析,最多并发 5 批;单批失败仅记录警告并继续。
- 通过 figma-merge.mjs 合并扫描清单与分析批次结果,执行 mergeDesignGraph(校验并重新附加 kind:"design"),写出 knowledge-graph.json 与 meta.json。
- 清理中间文件(保留 scan-manifest.json),汇总项目名称、各节点类型数量、边类型、层数、导览步骤及图谱路径,并调用 /understand-dashboard 技能自动启动仪表盘。
使用方式:
- 准备 FIGMA_TOKEN 环境变量(在 https://www.figma.com/settings 创建个人访问令牌),以及 Node ≥ 22、pnpm ≥ 10。缺少令牌时应停止并提示用户设置。
- 预检阶段解析参数,确定 PROJECT_ROOT 与数据目录 UA_DIR(存在旧目录 .understand-anything 时沿用,否则使用 .ua),并确保 core 已构建;若 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_TOKEN="$FIGMA_TOKEN" node <SKILL_DIR>/figma-scan.mjs "$PROJECT_ROOT" "<url-or-key>"。若输出 UP_TO_DATE 则提示图谱已是最新并停止;设置 UNDERSTAND_FIGMA_FORCE=1 可强制全量重建。
- 进入分析与合并阶段,最后自动启动仪表盘。
安全与限制:
- 令牌仅从环境变量读取,仅通过 X-Figma-Token 请求头发送,禁止写入图谱、meta.json、日志或中间文件。
- 该技能会向 api.figma.com 发起外部网络请求,与 /understand 不同,并非完全离线,需向用户说明一次。
- 具体仪表盘界面细节、支持的 Figma 节点类型全集、错误处理细节及性能数据暂未提供。