让 AI 写个"点外面关闭",它写了 40 行

让 AI 写个"点外面关闭",它写了 40 行

上周让 agent 给我那个下拉菜单加个"点外部收起"。它写了四十来行:一个绝对定位的 div、一段自制的遮罩层、一段锁 body 滚动的逻辑,还有一个 keydown 监听处理 Esc。能用,但我盯着看的时候觉得眼熟——这不是十年前 jQuery 项目里那套写法吗,变量名都没变。

换成原生其实三行。一个 <button popovertarget>,一个带 popover 属性的 div。点外部关闭、Esc 关闭、焦点回退到按钮、层级压过其他元素,全是浏览器白送的,一行 JS 都不需要。

它不知道这些。更准确地说,它知道,但它更习惯写那四十行。

有人把这些整理成了 262 条

Google Chrome 团队做了个东西,叫 Modern Web Guidance,今年一月开源,现在九千二百多星。我不想把它说成"文档站",因为它不是——它是一套 skill 加一个 CLI,agent 卡壳的时候去查,把那一小段直接塞进上下文。

覆盖 262 个现代 Web 特性,光 CSS 和布局就占了 140 条。

其中有几条我看的时候愣了一下。容器查询,组件终于能按自己的宽度写样式,不用再迁就视口;oklch(),调亮度不再跑色相;text-wrap: balance,标题断行不用手调;CSS Anchor Positioning,做 tooltip 不用再算 getBoundingClientRect。

还有 :user-invalid。这个特别典型:以前要在 blur 里判断 touched && invalid,维护一堆状态位;现在一个伪类,浏览器自己知道什么时候该标红,什么时候什么都不做。

<dialog> 和 ::backdrop 也是同一类东西。焦点陷阱、Esc、背景遮罩全都有,agent 每次都还是给你手写一遍。

顺带说一句,参与的不止 Google。Microsoft Edge、Mozilla Firefox、MDN 三个团队一起在维护这个仓库。一套只对 Chrome 有效的规范,Firefox 和 Safari 不会陪着做两年——这件事本身比任何跑分都有说服力。

我不敢信的评测,它自己挂出来了

我本来准备好一句"这是官方自评,姑且听之",结果仓库首页就挂着评测面板,还是每晚自动跑的。

同一批任务,Claude Code、Codex CLI、Antigravity CLI 各跑两遍——一遍不装,一遍装上,跑完用 Playwright 打开真实浏览器,检查渲染出来的 DOM 和可访问性语义。不是看代码长什么样,是看浏览器里实际发生了什么。

今天页面上的数:通过率 **53% → 92%**,无障碍检查 **58% → 94%**,样本 228 个任务、约 5,900 项检查。

官方评测面板:装与不装的 A/B 对比

我随手点开了其中一个,叫 Action menu,要求做一个带多级子菜单的导航。Claude Code 跑的:

不装:0/25 通过。 装上:25/25 通过,无障碍 15/15。

代价摊在同一张卡上,没藏。耗时 3 分 34 秒变成 5 分 39 秒,token 从 6.6 万涨到 12.4 万。

多花一倍的钱和时间,换一个本来零分的功能拿到满分。这买卖对做产品的人值,对交个 demo 的人不值。

而且它自己写了"为什么装了也不是 100%":任务 prompt 从来不提 MWG,agent 得自己意识到该查哪条指南。漏掉的原因有三种——跳过了某一步比如没做老浏览器降级、该查的时候没查、或者评分器太严。

翻译成大白话:它依赖你的 agent 主动去查。它不是在系统层强加规则,是把一本手册放在手边。手册再好,不看就是没有。

无障碍那段也实在:自动化检查只覆盖无障碍要求的一个子集,不衡量完整的 WCAG 合规,也不能替代人工测试。

一个项目肯把"我们没证明什么"写进文档,通常说明它真被用过。

现在就能跑,先扫自己的旧账

三条命令,npx 直接跑,什么都不装:

npx modern-web-guidance   search "dialog"

npx modern-web-guidance   retrieve "animate-to-from-top-layer"

npx modern-web-guidance legacy-scan .

(为手机上好读省略了 @latest,实际跑建议带上。)

第三条是我觉得最值的一条。前两条是让 AI 写新东西时别跑偏,legacy-scan 是回头收拾旧账:扫一遍代码库,告诉你哪里还在用那些已经有原生替代的写法。

一个跑了三年的前端项目,这种地方通常几十处。不是每个都该改,但知道它们在哪儿,比不知道强。

想正式接进 agent,npx modern-web-guidance@latest install,交互式向导会问你用哪个 agent(Claude Code、Codex、Copilot、Cursor),然后写对应的 skill 配置。要 Node 22 以上。

如果你的 agent 已经接了 chrome-devtools-mcp,两者能串起来用:先用 DevTools 跑性能审计、看无障碍树、抓 console 报错,再用这套东西取对应的修法。查问题和知道怎么改,本来是两件事。

至于要不要装——你天天跟 agent 生成的那堆 div 搏斗,就装;产品要上线、有人在 review 你的代码,更该装;只是偶尔让 AI 帮忙写个页面,算了,反正跑起来就行。


相关链接:

评论

暂无评论。

登录后可发表评论。