Figma 页面还原 Skill 如何串联设计读取、页面实现与视觉验收
用了这 Skill,我觉得前端兄弟可以毕业了
作者分享一套用于还原 Figma 页面并进行视觉验收的工作流,将读取设计节点、拆分素材与代码实现、浏览器截图对比、排查 DOM 偏差和修正复验串联起来。流程使用 Figma MCP、编码 Agent、浏览器截图工具及 Sharp 对比脚本,并强调固定视口、DPR、字体和页面状态。
这个 Figma 页面还原 Skill,我已经悄悄用了快半年。
讲道理,现在大家写页面基本都用上 AI 了,但很多时候只是从“切图仔”转岗成了“AI 监工”——代码确实是 AI 生成的,可最后还是得咱们自己瞪着眼睛,左边浏览器、右边设计稿来回切屏找茬,然后在对话框里卑微打字:“哥,标题往下偏了 2px”“按钮背景被拉变形了,再改改”。
用了这套 Skill 之后,我感觉咱们前端兄弟终于能从这活儿里毕业了:直接把 Figma 节点和本地页面地址甩给 AI,从读稿、切图、写样式,到自己打开浏览器截图比对、查 DOM 修偏差,整套活儿它自己就能闭环跑完。
我平时喂给它的内容就这么两行:一个目标模块的 Figma 链接,加一个本地能打开的页面地址。
说白了,不管是自己手写还是让 AI 生成初稿,最折磨人的永远是最后那步“肉眼对像素”。所以我干脆把“写页面 + 截图验收 + 查原因重改”绑成了一条流水线:让 AI 先去读 Figma 节点,分清楚哪些该导切图、哪些该写代码;写完自己拉起浏览器截张图,跟设计稿做像素对比,发现哪里不对劲,就去测一下 DOM 盒模型,找准病根接着改。
至于里面的脚本和规则,你也完全不用找我要源码。现在的 AI 早就进化到“你把规矩讲明白,它自己就能把工具写出来”的阶段了。只要你想清楚每一步要干嘛、给什么输入、怎么算过关,直接让 AI 顺着你们自己的项目搭一套,拿真实页面跑两轮就能用起来。所以这篇文章不发代码包,专门把这套工作流的门道拆开聊透。
平时用下来,基本就是甩个链接就能去喝水了。当然,AI 也不是神仙:前提是它得有权限读到 Figma 节点和所属画板,本地页面也能顺利打开并停在要对比的状态;要是只丢给它一张糊图,或者页面卡在登录页进不去、连设计稿多宽都摸不清,它还是会老老实实停下来找你补信息的。
先看结论:整条工作流是怎么转起来的?
一句话概括:把“读设计稿 → 拆图层、写页面 → 浏览器截图比对 → 查原因、改代码”串起来,让 Agent 根据对比结果修正,再截图复验。
想让这个闭环转起来,第一步得先给 AI 接上 Figma MCP,让它能直接读到目标设计节点的结构和素材信息,而不是干瞪着一张截图瞎猜。
图:从设计节点出发,经过实现、浏览器截图、差分定位,再回到代码修正。
页面生成出来只是第一步。接下来,工作流会在固定条件下截图,把页面与设计稿对比,再根据偏差排查和修改;改完以后再截图,按需重复,直到满足验收要求。
图:每次修改后重新截图,让下一轮调整有实际页面效果作依据。
| 环节 | 工作流做什么 |
|---|---|
| 截图 | 固定视口、DPR、字体和页面状态,等目标页面就绪后截图 |
| 对比 | 将生成的页面进行截图与对应设计区域对齐,生成叠加图和差异图 |
| 排查 | 结合差分、DOM 盒模型、素材和字体等信息,检查偏差来源 |
| 修正与复验 | 修改代码后再次截图对比;遇到信息不足或结果不收敛时补充信息并检查环境 |
想让 AI 在这四步里少跑偏,靠的不是多写几个 top、left,而是提前给它立好四条规矩:
- 入口只要选中一个 Figma 节点:在 Figma 里选中要还原的页面或模块节点就行,不用手动挨个切图、量尺寸。
- 布局缩放和切图倍率分开算:CSS 尺寸按项目的布局基准算,切图倍率按素材展示场景算,两本账别混在一起。
- 动态内容留 DOM,复杂视觉考虑用素材:会变的文案和要点击的区域优先留真实 DOM,复杂图层再用素材和 CSS 配合。
- 差分只管报位置,改代码前先查原因:像素对不上可能是布局、素材、字体或渲染环境的问题,先去浏览器里测清楚再动手。
跑通这套流程,需要准备哪几样工具?
你只需要凑齐四样东西:一个当“包工头”的编码 Agent、Figma 读取工具、能截图的浏览器,外加一段图片对比脚本。
图:Agent 读取设计并实现页面,将设计参考图与页面截图对比;修改后再次截图验收。
下面是这套流程用到的工具和可选项,你可以按手头的环境随便换:
- 编码 Agent(包工头调度):Codex、Claude Code、Cursor 都行。按它支持的方式配好规则和工具,让它把前后步骤串起来,顺着你们项目现有的技术栈改代码,不用为了迁就它去重构项目。
- Figma MCP(读稿 + 导切图):负责钻进节点树里读取结构、画板宽度和图层属性,需要切图时按需把真实素材导出来。
- EGO Lite 浏览器(带登录态截图):很多业务页必须登录才能访问。Playwright 这类工具没法直接复用现成登录态,而直接控制日常 Chrome 又会切乱你正在用的 Tab。EGO Lite 同样基于 Chrome 内核,既能保留登录态供 AI 自动进页面截图,又不会打扰你正在操作的浏览器。
- Sharp + 对比脚本(像素级找茬):说白了就是给 AI 写出来的页面拍张照,再用 Sharp(底层基于
libvips)把这张照片和 Figma 设计稿统一尺寸与通道、叠在一起比对,生成叠加图和差异图;一旦发现哪里没对上,AI 就回头改代码、再拍照比对,循环往复直到还原达标。
一、读设计与算尺寸:先找准画板基准,再分开算 CSS 和切图
拿到 Figma 节点后,别急着埋头写样式,先把设计范围、画板尺寸和项目的布局约定摸清楚,再决定 CSS 怎么写、切图怎么导。
以前咱们手动切图,最容易漏掉外发光、蒙版裁切或者透明边距。换成 Figma MCP 后,下面这些盘点工作完全由 AI 模型和 MCP 在后台自动交互完成,平时开发用的时候根本不用你操心(你只需要在写 Skill 规则时,交代 AI 动手前必须先通过 MCP 查清这四件事):
- 这个节点属于哪个页面画板?画板有多宽?
- 组件的真实边界、父级裁切和遮罩关系是什么?
- 哪些复杂图标或插画需要导出最小完整节点?
- 项目里有没有现成可复用的组件或样式变量?
1. 先说前提:为什么移动端切图要用“二倍图”?
做移动端 H5 的同学都知道,现在的手机屏幕基本都是高清屏(DPR 至少是 2)。如果页面上有个图标,你在 CSS 里写的是 40px × 40px,但切图也只导了一张 40×40 像素的一倍图塞进去,到了手机屏幕上被放大显示就会发虚、发糊。要想画面清晰,实际塞进去的图片得有 80×80 的物理像素——也就是常说的二倍图。
图:在这个 DPR 为 2 的例子里,CSS 尺寸相同,图片像素数量不同。
2. 以 360px 开发基准为例:设计稿是 360 还是 720,决定了怎么写 CSS 和导图
明白了“为什么要用二倍图”,再看我们前端写代码的基准。
比如我们团队前端统一以 360px 屏宽作为开发基准,但不同设计师画稿的习惯不一样:有的人画 360px 宽(一倍稿),有的人画 720px 宽(本身就已经放大了一倍)。我们平时丢给 AI 的 Figma 链接往往只是页面里的一个按钮或弹窗,光看这个局部节点是看不出画板比例的,所以 AI 第一步必须顺着节点往外找,先确认整张页面画板到底是 360px 还是 720px:
- 如果设计稿是
360px宽:画板宽度和我们的开发基准一样。稿子里量出来40px的图标,CSS 里直接按1:1写40px就行;但导切图时,得让 Figma 按2x(二倍图) 导出,才能拿到80px的高清图。 - 如果设计稿是
720px宽:设计师已经帮你把画板放大一倍了。同一个图标在稿子里量出来是80px,写 CSS 时就得除以 2 写成40px;而导切图时,直接按1x(一倍图) 导出就是80px,天生就相当于360px基准下的二倍图了。
图:设计尺寸、CSS 尺寸与导出像素分开计算;具体基准和倍率按项目约定。
把这条规则给 AI 讲清楚之后,它就不会再犯“拿到 720px 稿子直接把 80px 抄进 CSS 导致按钮大一倍”,或者“在 720px 稿子里还傻乎乎按 2x 导图”这种错误了;要是没权限读到外层画板,或者你只丢了一张截图看不出是 360px 还是 720px,它就会先停下来问你。
二、拆图层:哪些该导成切图,哪些该写 DOM 和 CSS?
图层分流就看三条标准:内容会不会变、要不要交互、用纯 CSS 好不好还原。
图:按内容和视觉特点选择 DOM、CSS、素材,或组合实现。
不给 AI 立规矩的话,它写页面特别容易走两个极端:要么偷懒把整个模块压成一张大图,要么突然燃起奇怪的斗志,硬用纯 CSS 或手写 SVG 去画复杂插画。我们在规则里直接给它划好分流表:
| 内容类型 | 落地方式 | 原因 |
|---|---|---|
| 标题、描述、金额、倒计时、排名 | 真实 DOM | 文案会变、要接接口数据、做多语言或响应状态 |
| 背景色、渐变、圆角、边框、简单阴影 | CSS | 规则清楚,能跟着容器尺寸自然伸缩 |
| 插画、角色、复杂纹理、光效、颗粒 | 独立素材或组合实现 | 根据视觉复杂度、复用需求和素材格式选择 |
| 复杂底板 + 动态文案 | 素材底 + DOM | 底板保住视觉细节,上层 DOM 保住文案和点击交互 |
比如做一个“立即领取”按钮,带金属光泽的金色底图直接导出成图片,上面的 Go Now 文案用真实 DOM 叠上去;做奖励卡片时,保留复杂的卡片底板切图,再在上面用 DOM 排布图标、数量和名称。
图:把动态文案和点击区域留在 DOM,并检查切图边缘是否带入了背景色。
这里有两个最容易踩坑的细节,一定要写进规则里提醒 AI:
- 别图省事把整个模块压成一张死图:比如把按钮连底图带文字整张导出来,第一眼看着是挺像,但后端接口返回的新文案塞不进去,点击事件和埋点没处挂,一换多语言长文案更是直接撑爆。所以只要有文字会变、有地方要点,就老老实实用“切图当底板 + 真 DOM 写文字”;只有那种纯摆设、既不点也不改字的装饰图,才考虑整块导出来。
- 导切图时盯紧“透明底”,别把画布背景色一起截进来:有时候页面上的异形按钮或卡片四角莫名其妙冒出黑边,真不是 CSS 没写好,而是从 Figma 导图时选错了层级,把底下深色的画布背景一起导进图片里了(就像上面图里右边那样)。一旦黑底已经焊死在图片里,你在 CSS 里加再多
border-radius也洗不掉。所以规则里得交代 AI:导图时只选干净的图形节点,导完顺手检查一圈四角是不是真透明。
三、视觉验收:先把浏览器条件锁死,再跑截图差分
先把视口、DPR、字体和页面状态锁死,再做截图差分,比出来的结果才算数。
图:固定截图条件,并确认设计稿与页面截图对应同一区域。
如果不锁环境,同一份 CSS 截出来的图简直像开盲盒:窗口宽窄变一点、DPR 不对、Web 字体还在路上没加载完、懒加载图片没滚出来,或者弹窗和业务状态压根没点开,比出来的结果全是冤假错案。
所以自动验收固定分两步走:
- 等页面彻底就绪再截图:浏览器工具按验收要求的视口和 DPR 打开目标页面;需要登录时,配置或复用有效登录态并切到目标状态,耐心等字体、图片和目标模块都渲染稳定后,再截取对应区域。
- 对齐尺寸跑像素差分:先确认两张图框住的是同一块区域,再用 Sharp 处理到可比较的尺寸,跑对比逻辑算出差异,生成叠加图(overlay)和差异图(diff)。
为什么不能直接把两张图丢给 AI 看,非要先过一道 Sharp?
很多人可能会问:现在的 AI 不是都能看图了吗?直接把“设计稿”和“浏览器截图”两张图塞给它,让它自己找不同不行吗?还真不行,主要卡在两个很现实的问题上:
图:先确认两张图是同一区域,再处理尺寸和通道;叠加图与差异图帮助定位偏差。
-
AI 直接看两张分开的图,是个“近视眼”:你让 AI 左边看设计稿、右边看截图,要是标题往下偏了
2px、行高差了一丢丢,它是根本看不出来的,十有八九会自信满满地骗你说“已经一模一样了”。只有像小时候描红本那样,把两张图叠在一起(生成重影叠加图),再用刺眼的红色标出没对上的像素(生成差异图),把几像素的偏差变成显眼的红斑,AI 才能一眼看出哪里歪了。 -
两张图尺寸对不上,根本没法直接叠在一起:想把两张图按像素叠一起,前提是它们的宽高得一模一样。但 Figma 导出来的参考图可能是
720px宽,而浏览器截出来的图可能是360px宽,或者高度因为小数取整差了1px。尺寸差一点,直接叠上去要么脚本报错,要么整张图全错位飘红。Sharp 在这里干的就是“裁缝”的活儿:比对之前,先把两张图缩放到完全一样的宽高和格式,让它们能严丝合缝地叠在一起。
顺手还要给 AI 打个预防针:浏览器渲染出来的文字,跟 Figma 里的文字本来就会有一圈细微的边缘毛刺。所以红斑图的作用是帮它找“哪块位置歪了”,可别为了那点文字毛刺死磕“零误差”。
四、怎么改偏差:别让 AI 瞎调 top,先像人一样打开控制台查原因
拿到红斑对比图后,最忌讳让 AI 盯着红色区域直接硬改 top、left 或 margin——得让它先去浏览器控制台量一下真实 DOM,找准病根再下刀。
如果不立这条规矩,AI 改样式基本就是在玩“打地鼠”:比如它看到差分图上标题往上偏了 4px,想都不想就给标题塞个 margin-top: 4px;结果标题是对齐了,底下整排卡片全被往下顶歪了 4px,越改差异越多。
其实咱们前端自己调页面时,看到不对劲也不会上来就盲改数字,而是先打开 F12 控制台看一眼盒子模型。所以我们把这套排查经验直接写进了规则里,让 AI 按“看图识症状 → 控制台查 DOM”的套路走:
| 对比图上看到的现象 | 真正的原因往往是什么(让 AI 查哪里) |
|---|---|
| 整个模块都歪了,出现整块重影 | 外层容器的起点、宽高算错了,或者 360 / 720 的缩放比例没换算对 |
| 框子对齐了,唯独里面的字有重影或换错了行 | 字体还没加载完,或者没写死 line-height(行高),被浏览器默认行高撑歪了 |
| 图标或角标突然缺了一截,像被一刀切掉 | 别重画图标!顺着父元素往上找,八成是哪个祖先节点挂了 overflow: hidden 或蒙版把内容裁了 |
| 按钮看着好好的,但怎么点都没反应 | 在按钮坐标上跑一下 elementsFromPoint(),看看是不是被哪层透明遮罩或更高的 z-index 盖住了 |
| 圆角图片四个角长出了黑边 | 回头看一眼切图文件,多半是从 Figma 导图时把底下的深色画布背景一起截进去了 |
说白了,就是让 AI 在改代码之前,先去浏览器里跑几行脚本(相当于替我们点开 F12):用 getBoundingClientRect() 量一下这个元素实际渲染出来的宽高和坐标到底是多少,顺着父节点往上查一圈谁加了 overflow: hidden,再用 elementsFromPoint() 看一眼是谁挡在最上面。
图:先看对比图上的现象,再去浏览器里量盒模型、查父级裁切和遮挡关系,确认病根后再改代码。
最后还要给 AI 栓一条**“防死磕”的止损绳**:第一轮对比出来后,先把所有错位的地方一次查清、集中改完;要是连着改了两轮还是对不上,必须立刻停手,回头去检查是不是设计稿尺寸看错了、字体没加载出来,或者页面压根没切到对应的状态——千万别让它在原地跟 top: 1px、top: 2px 死磕到底。
怎么让 AI 帮你搭一套自己的还原工作流?
直接把“怎么确认设计基准、怎么拆图层、什么条件下截图、差分后怎么排查”这几条规矩喂给 AI,让它顺着你们项目现有的技术栈先搭起来,挑个简单模块试跑一轮。
图:先写清规则并试跑,再结合项目条件调整。
试跑的时候,要是碰上读不到设计基准、页面状态不明确,或者改了两轮还对不上的情况,就让它先停下来找你补信息或查环境。等流程跑顺了,再把项目里的常用组件、切图存放路径和验收细节一点点补进去,攒成你们自己的 Skill 或规则文件。
这套流程在我自己手里已经跑了快半年;搬到其他项目时,再顺着实际的设计稿习惯、手头工具和页面状态微调几下就行——毕竟让 AI 替咱们盯设计稿,是为了早点写完下班,可不是为了给自己再造一个新坑。
来源:掘金 · juejin.cn