How-toMulti-source

Figma 页面还原 Skill:让 Agent 自己截图比对改代码

用了这 Skill,前端兄弟都觉得好

Why we picked it

前端还原设计稿最烦的肉眼对像素环节,这篇直接让 Agent 自己截图、自己查 DOM、自己改。用的都是现成工具:Figma MCP 加 EGO Lite 浏览器加 Sharp 脚本,Claude Code 和 Cursor 都能跑。每天跟设计稿找茬的同学照着搭一遍能省不少时间。

作者分享了一套自用近半年的 Figma 页面还原 Skill,核心是把「读设计稿 → 写页面 → 浏览器截图比对 → 查原因修改」串成一条 Agent 自动闭环的流水线。

Body

输入只要两样:一个 Figma 节点链接和一个本地页面地址。工作流分四步:在固定视口、DPR 和页面状态下截图;

将页面截图与设计区域对齐生成叠加图和差异图;结合差分与 DOM 盒模型排查偏差来源;

修改代码后重新截图复验,循环到验收达标。工具链由四部分组成:Codex、Claude Code 或 Cursor 当调度 Agent,Figma MCP 负责读节点树和导切图,EGO Lite 浏览器保留登录态截图,Sharp 基于 libvips 做像素级对比。

作者还立了四条规矩减少 Agent 跑偏,例如布局缩放与切图倍率分开算(360px 开发基准下区分一倍稿和 720px 二倍稿)、差分只报位置而改代码前先查原因、动态内容留真实 DOM。文章不发代码包,而是拆解如何让 AI 顺着自家项目把这套工具链搭出来。

Original · 掘金本周最热

用了这 Skill,前端兄弟都觉得好

这个 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 替咱们盯设计稿,是为了早点写完下班,可不是为了给自己再造一个新坑。

Industry Coordinates & Source Verification

This report is categorized under AITOP's "How-to" desk, focusing on China's AI industry and domestic foundation model ecosystem. Within our cross-regional analytical framework, it directly maps to AI developer toolchains, coding agents, and engineering workflows. Key entities and technical topics under continuous tracking include Figma, Figma MCP, Cursor, Claude Code.

Source attribution: curated from 掘金本周最热 (@不一样的少年_). Cross-source corroboration: 11 independent sources have covered this development (including berryxia, Varun Mohan, shao__meng), confirming industry-wide signal strength.