Android Figma UI 生成器
将以下提示词粘贴到你的 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 布局代码