AI 做的页面一眼高级,进项目就露馅:技能包读不懂你家组件库,才是真分水岭
AI 做的页面一眼高级,进项目就露馅:技能包读不懂你家组件库,才是真分水岭
这两年用 AI 写前端的人越来越多,很多人都有过同一个尴尬时刻。
鼠标一点,页面唰地出来了:留白舒服、字重讲究、卡片圆角恰到好处,第一眼真挺唬人。可你把代码拖进自己的项目里,跑起来一看,心里咯噔一下——
按钮不是你家的按钮,输入框不是你家的输入框,图标全换成了另一套,字体也不是你们设计稿里那个。整页像是从别人家客厅搬来的一套家具,单看都好看,摆进你家就是不对劲。
这时候你会发现,改比重写还累。
最近 Skills 这个概念火得一塌糊涂,从 Anthropic 提出 Agent Skills 标准,到 Google 开源 stitch-skills,再到国内社区一篇文章动辄几万阅读,大家都在讨论“怎么让 AI 生成不丑的界面”。
但真正的分水岭,其实不在“好不好看”这四个字上。
而在另一件更朴素的事上:这个技能包,认不认识你家已经有的那套设计系统。
一、先把这个仓库说清楚:它不是画图工具,是给 AI 立规矩
GitHub 上有个叫 ai-design-skills 的小仓库,MIT 协议,谁都能拿去用、改、甚至卖。
它里面目前就两个技能包,一个叫落地页设计,一个叫设计转动效。
听起来像插件,其实不是。它没有任何模型、没有显卡要求、也没有要部署的服务。说白了,它就是一份写给 AI 看的说明书。
你用 Claude Code、Cursor、Codex、Windsurf 这些工具时,把这份说明书放进项目里,AI 在动手做界面前会先读一遍,然后照着里面的规矩来。
这就像装修队进场前,你先塞给他一本《本小区施工规范》:哪里能砸墙、插座装多高、瓷砖留几毫米缝,全写清楚。他不用猜,也不会自由发挥。
社区里有个说法我觉得特别到位:Skills 就是“给 AI 的设计系统文档”。
二、它到底管什么?一半管“说什么”,一半管“长什么样”
拿那个落地页技能举例,它把自己劈成两半。
前半部分管内容:先反过来问你一堆问题——这个页面只允许用户做哪一件事?访客最担心的三个顾虑是什么?凭什么信你?然后它才决定页面分几段、标题怎么写、按钮上写什么字、常见问题放几条。
后半部分管长相,而且管得非常细,细到有点“洁癖”:
字体只认 Geist、Manrope、Poppins 这几个,明确禁用 Inter、Roboto、Arial;
字号不许自己拍脑袋,必须落在固定档位上,落不上就往下取最近一档;
间距只有一张固定的表,2、4、8、12、16、24、32、40、48、64、80、96,中间不许插队;
卡片不许只画一条边,背景不许用渐变,暗色模式的底色只有六个指定色值;
图标只用 Phosphor、Solar、Iconamoon,Material 图标直接判出局;
连文案都有规矩:英文里禁止“颠覆、赋能、极致、无缝”这类词,示例人名不许叫张三李四,价格不许是整数,因为太假。
另一个动效技能更有意思:你把一张设计稿丢给它,它能把页面还原到像素级一致,然后让每个图表、每个列表、每张日历“演”一遍自己的故事——列表不断有新条目落下来,图表被光标一路读过去,输入框里的提示词自己打字又删掉,最后循环播放,还能直接导出成 MP4 和 GIF。
一个管“从零搭一套好看的”,一个管“让静态设计活过来”。分工挺清楚。
三、分水岭就在这:技能包自带一套“审美宪法”
问题来了。
上面那些规矩,单看每一条都很专业。可它们凑在一起,其实已经是一套完整的、自带主张的设计系统了。
而你公司,很可能早就有一套自己的。
你们用 Ant Design,按钮有一堆现成变体;你们用 Element Plus,表格和分页都是封装好的;或者你们是自研组件库,按钮的圆角就是 4 像素,主色是老板亲自定的那个蓝。字体是系统默认,图标是 Material,暗色底是 #1A1A1A。
这时候 AI 拿着技能包进来,会发生什么?
它会开始跟你打架。
更关键的是,落地页技能里明明白白写着一句话:当这里的规则和框架默认值冲突时,以这个文件为准;当用户的明确要求与规则冲突时,以用户为准。
翻译成人话就是:AI 优先听技能包的,你不发话,它就按自己的来。
你家的组件库如果没被写进技能包,在 AI 眼里就只是“框架默认值”那一档,是被覆盖的对象。
这事儿就有意思了。同一个作者写的两个技能,态度还不一样——动效技能里专门有一条:尊重站点自己的系统,用它的组件、它的变量、它的圆角、它的字体。
一个说“我说了算”,一个说“你说了算”。
差别不在技术水平,而在有没有人提前把“适配”这件事写进去。
这就是我说的分水岭:技能包能不能从“我教你审美”,变成“我学你的规矩”。
四、三种适配思路,只有一种能活得久
真要把技能包接到自家组件库上,社区里大致摸索出三条路。
| 做法 | 大白话 | 好处 | 坑 |
|---|---|---|---|
| 直接点名组件 | 告诉 AI“主按钮就用 Button 加 primary” | 一次就对,最省心 | 换库、升级、改接口,全废;组件一多,说明书变字典 |
| 抽象语义层 | 只说“主操作、危险操作、次要操作”,让 AI 自己找 | 跨库通用,换框架不怕 | 每次都要现场判断,同名不同义时容易选错 |
| 双层映射 | 上层固定“小名”,下层写“当前对应谁” | 换库只改下层,上层不动 | 前期要多花半天时间建表 |
前两种都有人用,但真正能撑过两次组件库升级的,基本只有第三种。
道理跟我们生活里一样。你让孩子“去把那个东西拿过来”,他得猜。你说“去把茶几上那个蓝色杯子拿过来”,一次就对。
“蓝色杯子”就是语义别名,永远不变;至于它是宜家的还是无印良品的,那是下一层的事,换了也不用改口。
五、AI 开始“自造组件”,就是最早的报警信号
适配没做好,不会一上来就报错,它是一点点漂移的。
有几个信号特别明显,看到就该警觉:
第一个,冒出你项目里根本没有的组件名。 比如突然出现一个“主按钮组件”、一个“区块标题组件”、一个“卡片外壳组件”。你翻遍代码库,一个都不存在。这是 AI 在野生装修,自己锯木头做了个沙发。
第二个,给你已有的组件套了一层新壳。 明明有现成的按钮,它非要在外面包一层,再改样式。看着是复用了,其实是在你的组件上面又长了一层。
第三个,不用你的样式类名了。 它开始写自己的一套类名,颜色数值也是新的,比如那种一眼就能认出来的紫蓝渐变。
第四个,出现规范外的数字。 18 像素、22 像素、13 号字。你的规范里明明只有 4、8、16、24,它偏要插一个 18 进去。
第五个,图标变成了 emoji。 这个最直观,也最容易被忽略。
社区里有篇文章把这个叫“AI 味”:紫蓝渐变头图、四个一模一样的并排卡片、emoji 当图标、纯黑字配纯白底。以前大家以为这是模型审美不行,其实很多时候,是它不知道你家的规矩,只能输出一个“平均值”。
六、这笔账怎么算:先做十个,别做一百个
一说到适配,很多团队第一反应是“那我们得把组件库全梳理一遍”。
真不用。这笔账可以粗算一下:
适配工作量 ≈ 高频组件数 × 每个组件要说清的条目数。
一个组件要说清什么?默认长什么样、悬停什么样、禁用什么样、有几种尺寸、主色和危险色怎么用、图标放哪边、文字多长会换行。七八条,不算多。
但关键在于,这里有个“复用系数”:用得越多的组件,写一次省一百次。
所以正确的顺序不是从 A 开始按字母排,而是按“出现频率”排。
先做十个,基本能覆盖八成界面:
按钮、输入框、下拉选择、表格、卡片、弹窗、标签徽标、分页、导航、提示条。
这十样定死了,剩下那上百个长尾组件,等真用到再补。
反过来,如果你一上来就整理一百个组件,很可能整理到第三十个就没人维护了,最后技能包里躺着一堆过期规则,比没有还危险。
七、真想落地,建议按这个顺序来
我把它拆成五步,都是大白话。
第一步,先别急着写组件,先写“小名”。 把界面上的动作和容器抽象成十个词:主操作、次要操作、危险操作、输入、选择、容器、分组、反馈、导航、空状态。这些词永远不变。
第二步,给每个小名写清楚“什么时候用、什么时候别用”。 比如“危险操作”只用于删除、清空、不可恢复的动作,不要因为按钮是红色就往上套。
第三步,再写“当前项目里它对应谁”。 这一层是易耗品,换了组件库就重写,上面的小名一个字都不用动。
第四步,加一条兜底规则,这条最重要:找不到对应组件时,先问,不许自造。
就这一句话,能挡掉八成的命名漂移。因为 AI 不是故意捣乱,它只是遇到空白时倾向于“帮你补上”。你明确说了不许补,它就会停下来问。
第五步,把技能包当代码管。 进版本库,谁改了写一句为什么。设计规范是会变的,技能包不跟着变,三个月后它就成了历史文件。
上线前还可以做个三十秒验收:让 AI 生成一个页面,然后搜一遍有没有新造的组件名,数一数有没有规范外的字号和间距,看看图标是不是自家的。三眼就能看出适配到不到位。
八、普通人能用吗?门槛真不在技术
不需要显卡,不需要服务器,不需要懂代码。
它就是一个纯文本文件。放进项目里,AI 工具自己会读;不想折腾命令行,网页版里把文件当附件传上去,说一句“按这个来”,也能跑。
设计师可以拿它约束 AI 输出的视觉;前端可以拿它统一组件用法;产品经理甚至可以直接用它生成一份能看的原型,拿去开会。
真正的门槛是另一个:你得先知道自己家的规范到底是什么。
很多团队的规范,一半在设计师的 Figma 里,一半在前端的代码里,还有一半在老员工的脑子里。从来没被写成一张能读的表。
而适配组件库这件事,说白了就是逼你把这张表写出来。这活儿 AI 替不了你,但它能帮你把这张表变成“会执行”的东西。
九、最后说句实在话
AI 生成界面这件事,去年比的是“能不能看”,今年比的是“像不像你家的”。
再往后,比的会是“改起来费不费劲”。
一个技能包再漂亮,如果每次生成完都要人工返工两小时,那它只是个高级草稿机。反过来,一个规矩写得土的技能包,只要它认得你家每一个按钮、每一个输入框、每一套间距,它就能真的替你干活。
前者是玩具,后者才是同事。
你们团队的组件库现在有多少个组件?有没有哪次 AI 给你造了一个你从来没见过、但看起来还挺顺眼的按钮?
评论区聊聊,我挺好奇大家被“野生组件”坑过多少次。