一次不掺水的 Agent Skill 实测:modern-web-guidance 不是一段提示词,是一套把「浏览器本来会做的事」从你的代码里拿走的教材。两个工程点值得看:一是它不靠模型自觉,而是把新标准装进技能目录,AI 先翻教材再动手,所以同一个需求装前装后能摆在一起 diff;二是它区分两种查法------扫描旧写法的命令只认有把握的规则、宁可漏报(实测报零),换成对着教材挑,一挑一大把(九个弹窗手拼遮罩、行为写在标签上五十多处、innerHTML 三十多处、Esc 一行都没有)。本文按六步还原,附 6 段完整可抄文本、两版代码前后对照,以及「新写法好维护不是因为代码少」这个结论的来由。
我是小虎,浙大计算机本硕,破局行动家,《AI超级个体------一人公司完全指南》作者,专注于AI培训、超级个体打造、公司提效陪跑。
最近 GitHub 的趋势榜上有个项目蹿得很快:谷歌 Chrome 团队牵头做的一个技能包,发布没几天,一天就涨了一千多个星,现在仓库里有一万八千多颗星。给它站台的,是四大浏览器厂商。
大家好,我是小虎。

▲ GitHub 上这个项目的主页,红圈里是星数
为什么四家罕见联手?因为 AI 写代码用的都是训练时学的那套老写法,光靠一家喊话没用,得把新标准打包成教材,直接塞进 AI 编程工具里。
如果你也让 AI 写过网页,大概率见过这种代码:功能全对,写法全是老的------弹窗自己拿标签拼遮罩,气泡靠算坐标,还有一堆官方标了废弃的写法照用不误。不是 AI 偷懒,是它学的那套教材太旧。
这两天我拿这个新项目做了个试验:6 段提示词,装它之前先让 AI 做一个带弹窗的页面,装上之后再做一遍一模一样的,最后拿我自己天天在用的一套真代码开刀,看这本新教材到底管不管用。
主角是 GoogleChrome/modern-web-guidance:Chrome、Edge、Firefox 加上 MDN 一起维护,收了两百多个现代网页的新特性、两百来个真实场景的标准写法,专门给 AI 编程助手当教材。
第一步 装之前,先让 AI 裸做一版
我把需求原样丢过去:
text
帮我做个网页小工具:一个提醒我喝水的页面,页面上有个按钮,点一下就弹出一个提醒弹窗,弹窗出来的时候背景要那种慢慢变暗还有点模糊的效果。好看一点,做完直接打开给我看看效果。
页面很快出来了,单文件,双击就能开:弹窗出来时背景慢慢变暗、慢慢变模糊,还有一点上浮的动画。右侧直接把页面开出来了。

▲ 装技能前 AI 做的第一版喝水提醒页
看着挺像回事。这版先留着,当对照组。
第二步 把技能装进来
text
GitHub 上有个最近很火的项目叫 modern-web-guidance,说是四大浏览器厂商一起做的,专门管 AI 写前端代码老用老套路的问题。你装一下,装完告诉我装好之后它能干嘛、怎么用。
它把两百多个文件装进了 WorkBuddy 的技能目录,然后告诉我三条用法:搜某个主题的指南、取完整指南、扫项目里的旧写法。装完它还顺手拿刚才那个喝水页试了一刀,真抓出了东西。

▲ 技能装好后 AI 的回话,它当场拿第一版试了一下
第三步 同一个弹窗,再做一遍
text
再来做一遍刚才那个喝水提醒弹窗,要求一模一样,但是这次用你刚装的那个技能来做。做完打开给我看,再告诉我这次的写法跟上一回有什么不一样。
这次它先翻教材再动手,做完还把两版代码做了一次复盘:装前的版本挑出三处旧套路,装后归零。

▲ AI 做完第二版后自己给的复盘
外观看不出差别,差别全在代码里。我把两版的关键代码拷出来摆在一起。先看开弹窗这段,老版的手笔:
text
<div class="overlay" id="overlay"> <div class="card"> <h2>💧 该喝水啦</h2> <button onclick="closeOverlay()">好的,马上喝</button> </div></div>
text
function openWater(){ overlay.classList.add("show"); }function closeWater(){ overlay.classList.remove("show"); }document.addEventListener("keydown", e => { if (e.key === "Escape") closeWater();});overlay.addEventListener("click", e => { if (e.target === overlay) closeWater();});
新版换成了原生的弹窗标签,JS 只剩一句:
text
<dialog id="waterDlg"> <h2>💧 该喝水啦</h2> <form method="dialog"><button>好的,马上喝</button></form></dialog>
text
btn.addEventListener("click", () => waterDlg.showModal());
整份弹窗代码下来,删了约三十行:Esc 关闭、焦点圈住再还回去、背后页面变灰锁滚动,这些弹窗本来就该有的行为,全改由浏览器自带。
还有一处老版压根没有的:关弹窗的时候,变暗和模糊会按来时的路退回去,不是瞬间消失------这招在老写法里得自己拿定时器补。

▲ 第二版的喝水弹窗
第四步 气泡这种贴着飘的效果
text
再做一个:鼠标悬到一个问号图标上,会浮出来一个小气泡说明的那种效果,气泡要贴着问号的位置,别跑偏。也用那个新技能做,做完打开给我看。
气泡要贴着问号,以前得算坐标,滚动缩放还得自己盯着调。
这次回话里就一个新词:锚点定位------气泡声明自己贴着谁,位置浏览器自己算,跑到屏幕边上还会自己调头。

▲ 做出来的悬停气泡
第五步 拿我自己天天用的签到页开刀
text
我 D 盘有个「狮务签到」文件夹,里面是个单文件的签到页,我自己天天用。你看看这里面有多少老写法,挑最典型的一处,用那个技能按新写法改一遍,改完前后摆在一起给我看看。
它先跑了一遍那个扫描旧写法的命令,报零------这命令只认它有把握的规则,宁可漏报。
换成对着教材挑,一挑一大把。九个弹窗全是拿标签手拼的遮罩;行为直接写在标签上的,五十多处;拿 innerHTML 往页面里塞内容的,三十多处。
最扎眼的是 Esc:一行都没有,弹窗打开只能点那个小叉。
挑签到成功那个弹窗开刀。老写法长这样:
text
<div class="modal-mask" id="signModal"> <div class="modal"> <button class="mx" onclick="closeModal('signModal')">✕</button> <div class="big-ok">✓</div> </div></div>
text
.modal-mask{position:fixed;inset:0;background:rgba(0,0,0,.45); display:none;align-items:center;justify-content:center;z-index:50;}.modal-mask.show{display:flex;}
按指南改完:
text
<dialog id="signModal"> <form method="dialog"> <button class="mbtn" value="ans" autofocus>查看依据与配图</button> </form></dialog>
text
dialog::backdrop{background:rgba(0,0,0,.45);}
那层遮罩的定位、层级、显隐三条样式,收进了 backdrop 后面一条。打开就一句:dlg.showModal()。
改完我把两版各开了一遍。弹窗长相没变,变的有三样:打开时有个缩放加淡入的动画;主按钮上自动多了一圈焦点环;按 Esc 能关了。
这三样一行代码都没写,浏览器自带的。


▲ 上图是签到页改前,下图是改后
改的不是一个弹窗。那套手拼的遮罩,是九个弹窗共用的底子。
第六步 摆在一起比一比
text
最后帮我把今天做的这几个东西理一理:装技能前后两次弹窗的代码摆在一起比一比,哪种写法更好维护,为什么;气泡那个效果用传统写法大概得多写多少东西。简单点说,别太长。
弹窗那份结论一句话:新写法好维护,不是因为代码少,是因为少了一堆必须记得写对的东西------焦点归还、Esc 处理这类,忘了就是看不见的毛病,还很难测出来。少代码只是结果。
气泡那份是笔行数账:算坐标、盯滚动缩放、防跑偏、点外面关闭,一笔一笔加起来,六七十到一百行;新写法三行定位声明加两个标签属性,JS 一行都不用。

▲ AI 最后给的盘点
写在最后
签到页那个弹窗,改完我按了一下 Esc,它自己关上了,焦点也回到了原来那个按钮上。
这些事老版本里从来没做过,用了这么多年也没人觉得少什么,手拼的写法压根不会提醒你这些该做。
整场试验下来,这本教材管的其实就一件事:把浏览器本来会做的事,从你的代码里拿走。

以上为完整实测记录,6 段文本可直接复用;把「装前对照组 → 装后同需求重做 → 拿真代码开刀」这套流程沉淀下来,换项目只改提示词里的路径,就是一次自己的前端现代化体检。