写前端的人大概都碰过这种事:让 AI 帮你改一段代码,它给你甩回来一大坨 JavaScript,跑起来倒也能跑,可那套写法大概是十年前的,浏览器原生的方案早就能干了,它不知道。
谷歌 Chrome 团队在 GitHub 上放了个仓库,叫 modern-web-guidance-src。这东西本身不是库,也不往你的项目里塞代码。它是一套给编程 agent 用的“技能包”,把 web 平台的最佳实践、浏览器兼容数据,直接喂进 agent 的上下文里,让它别再照着老黄历写。
他们自己解释得挺实在:模型的训练数据里躺着海量遗留代码,所以默认就往旧路上走。有些 API 它其实知道存在,但缺真实世界里现代写法的密度,写出来还是不能上生产。这仓库就是补这中间的缝。
里面覆盖了二百五十来项现代 web 特性,CSS 布局占了一大半,一百四十项。容器查询、subgrid、oklch 这些颜色空间、text-wrap 调优,还有 View Transitions 那种平滑过渡,弹层用 Popover API 和锚点定位,表单校验用 :user-invalid,性能上提了 scheduler.yield 和 INP 诊断。连内置 AI 都算进去了,本地翻译、摘要、语种检测那一套。
有一件事我觉得比功能清单更值得看:这仓库是 Chrome、Edge、Firefox 和 MDN 的团队一起在管。四家平时在标准会上互相掰扯,这回凑一块维护一份给 agent 看的指南。说白了,是怕 AI 把整个 web 生态往回拽。
它还给了一个不用安装就能试的命令,跑个向导就装好。不过我好奇的是,模型训练数据那摊子老账,靠一个上下文窗口能掰回来多少。