用途:把 Figma API 工作流接入 CI/CD,实现按计划同步设计令牌、在 PR 时导出资源,并校验设计系统一致性。
主要能力:定时(工作日 9 点 UTC)或手动触发令牌同步,检测到变更后自动创建 PR;当 figma-config.json 等配置变更时触发图标导出并提交资源;对 tokens.css 做校验,令牌数量过少或存在重名变量时使构建失败,防止错误部署。
使用方式:需启用 GitHub Actions 的仓库、以 GitHub secret 保存 FIGMA_PAT,并准备来自 figma-core-workflow-a 的设计令牌提取脚本。工作流使用 actions/checkout@v4、actions/setup-node@v4(Node 20)与 npm ci,通过环境变量 FIGMA_PAT、FIGMA_FILE_KEY、FIGMA_ICON_FILE_KEY、FIGMA_ICON_FRAME_ID 调用 node scripts/extract-figma-tokens.mjs 与 node scripts/export-figma-icons.mjs。密钥可用 gh secret set FIGMA_PAT --body "figd_your-token-here" 设置,文件键等非敏感值用 gh variable set 设置。手动运行可用 gh workflow run figma-token-sync.yml,再以 gh run watch 与 gh pr list --label design-tokens 查看结果。
适用场景:设计令牌定期同步、图标批量导出、设计系统一致性校验与基于 PR 的设计变更评审。
限制:依赖 Figma PAT 与正确的文件键;PAT 过期会出现 403,文件键错误会导致令牌输出为空,并发工作流可能触发限流,需加 concurrency group;Node 模块缓存过期需清理 actions/cache。无变更时任务正常退出且不创建 PR。部署模式参见 figma-deploy-integration。