用途
本技能面向 Figma 设计文件的分析、资源导出与设计审计，通过 Figma REST API 提供专业级集成能力，适用于设计系统维护、开发交付和品牌合规检查等场景。
主要能力
文件操作与分析
- 获取任意 Figma 文件的完整 JSON 表示
- 列出所有组件、样式和设计令牌
- 批量导出画板、组件或指定节点为 PNG/SVG/PDF
- 访问特定文件版本和分支信息
设计系统管理
- 审计颜色使用、排版一致性和间距模式
- 识别未使用的组件并衡量使用模式
- 检查跨文件的品牌指南遵循情况
- 从 Figma 样式生成 CSS/JSON 设计令牌
批量资源导出
- 支持 PNG、SVG、PDF、WEBP 多格式导出
- 生成 @1x、@2x、@3x 等平台特定尺寸资源
- 按格式或平台自动组织输出文件夹
- 生成包含文档的完整交付包
无障碍与质量分析
- 验证 WCAG 颜色对比度要求
- 分析字体大小确保可读性
- 检查触控目标尺寸要求
- 验证键盘导航的焦点状态
使用方式
认证设置
# 设置 Figma 访问令牌
export FIGMA_ACCESS_TOKEN="your-token-here"
# 或存储到 .env 文件
echo "FIGMA_ACCESS_TOKEN=your-token" >> .env
基本操作
# 获取文件信息和结构
python scripts/figma_client.py get-file "your-file-key"
# 导出画板为图片
python scripts/export_manager.py export-frames "file-key" --formats png,svg
# 分析设计系统一致性
python scripts/style_auditor.py audit-file "file-key" --generate-html
# 检查无障碍合规性
python scripts/accessibility_checker.py "file-key" --level AA --format html
工作流模式
- 设计系统审计：提取文件数据 → 分析一致性 → 生成报告 → 手动实施改进
- 资源导出：确定导出目标 → 配置导出设置 → 批量处理 → 组织输出
- 分析与文档：提取设计数据 → 审计合规性 → 生成文档 → 导出交付物
集成示例
# 生成 CSS 设计令牌
python scripts/export_manager.py export-tokens "file-key" --format css
# 审计品牌合规性
python scripts/style_auditor.py audit-file "file-key" --brand-colors "#FF0000,#00FF00,#0000FF"
# 生成客户交付包
python scripts/export_manager.py client-package "file-key" --template presentation
适用场景
- 设计系统维护与一致性审计
- 开发交付资源批量导出
- 品牌合规性检查
- 无障碍合规性验证
- 设计令牌生成与文档编写
- 客户交付物打包
限制
本技能通过 REST API 提供只读访问，可以提取数据、导出资源、分析审计和生成报告，但无法修改现有文件（颜色、文本、组件）、创建新设计或组件、批量更新多个文件，也不支持实时协作功能。如需修改文件，需使用 Figma Plugin API 开发插件。
技术特性包括内置 API 速率限制与重试逻辑、全面的错误处理与日志记录，以及多格式资源导出支持。