Agent Skills
返回列表
Android Figma UI 生成器

Android Figma UI 生成器

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_a0462c2e/android-figma-walkthrough

技能介绍

要解决的问题

当用户给出一个 Figma URL 时,传统做法要么手动截图对齐设计稿、要么让 AI 直接“脑补”组件结构,结果经常生成与设计不符的 UI。这个技能解决这个问题的思路是:先看见,再分析,最后才生成代码——所有包含 Figma 链接的请求必须先物化节点截图并展示给用户确认,避免基于错误的节点猜测。

另一个常见问题是边界失控:很多设计类 skill 会在用户只说“看看这个设计”时顺手生成一堆代码,污染上下文。本技能用严格的触发门槛和降级策略来防止这类行为。

核心能力与执行流程

  • URL 解析与节点确认:解析 https://www.figma.com/file/ 或 /design/ 格式的链接,提取 fileKey 和 nodeId;URL 缺少 node-id 时不会假设当前选中节点,而是提示用户提供。
  • 截图优先展示:任何包含 URL 的请求,第一个动作不是读数据,而是通过 mcp__figma__get_screenshot 获取节点截图并保存到 {screenshotsDir},让用户确认节点正确后再继续分析。
  • UI 走查:inspect 子命令读取设计节点树,校验返回节点 ID 与请求一致;节点校验失败时脚本以非零退出码停止,防止展示错误数据。
  • 资源下载与格式转换:下载 PNG 资源到 {assetsDir},并用 rename-assets.mjs 统一命名;cwebp 可用时自动转换 WebP,产物落入 {webpDir}。
  • 条件触发代码生成:只有在用户明确使用 codegen 子命令、或明确说出“生成 Compose 代码”“实现 XML 布局”等指令时,才进入 Phase 7 检索项目代码规范并生成代码;普通截图、走查、资源下载请求不会触发目录扫描或代码输出。
  • MCP/REST API 降级机制:Figma MCP 连接失败时自动切换到 scripts/figma-rest-api.mjs,只要设置了 FIGMA_ACCESS_TOKEN 即可等价获取截图与数据,避免抓取中断。

适用边界与注意事项

  • 截图是硬前置步骤:前后端任何节点分析、资源枚举、代码生成之前,必须先拿到并展示节点截图。截图失败时必须报告失败原因并询问是否继续,不能默默跳过。
  • 代码生成需要双重确认:单独出现 @https://www.figma.com/... 或 “Implement this design from Figma.” 这类标准包装语句不构成代码生成触发条件;必须额外写明目标代码类型、输出代码或执行 codegen 才允许进入代码阶段。
  • 资源下载带版本优先级:优先使用新版 mcp__figma__download_assets,旧版客户端回退到 mcp__figma__download_figma_images;两个工具都不可用时直接停止并提示更新 MCP,不允许伪造下载结果。新版工具返回的临时 URL 必须立即落盘,不能写进生成代码。
  • 工作空间隔离:首次使用会自动初始化 .figma-android/ 目录结构,并在对应工具配置目录下写入 android-figma-walkthrough-config.json,自动追加 .gitignore 规则,避免缓存文件污染版本库。
  • 环境依赖有底线:依赖 Node.js ≥ 18 和 FIGMA_ACCESS_TOKEN;convert 等辅助命令还要求本机有 cwebp,缺失时会引导用户安装而非静默降级功能。

使用场景

  • 拿到 Figma 设计稿链接,需要预览页面节点并把截图保存到本地
  • 需要从 Figma URL 获取图标和图片资源,并统一转换生成 WebP 文件
  • 已有 Android 代码路径,要和 Figma 设计稿对比找出 UI 实现差异
  • 明确要求生成 Compose 或 XML 布局代码来还原设计稿中的指定界面

适合人员

  • 负责 Android Compose 界面还原的客户端工程师,需要对照 Figma 稿准确生成 UI 代码
  • 负责多端设计走查的前端工程师,需要批量检查 Figma 链接对应的视图与资源
  • 维护设计系统的团队成员,需要从 Figma 文件中提取图标资源并整理成项目可用格式
  • 维护旧版 Android 原生 View 界面的工程师,需要根据设计稿更新 XML 布局代码