谷歌 Chrome 团队最近在 GitHub 上开源了一个项目:Modern Web Guidance。一直在 GitHub 日榜上挂着。它解决的问题是这样:现在让 AI 写网页,有时还会看到 2020 年前后很常见的写法。模型在训练时看过不少旧代码和教程,遇到类似的需求,容易沿用当时的做法。这个开源项目就想缓解这个问题,给 Agent 装上现代 Web 技术大脑。

比如直接用 AI 写网页,遇到聊天框里的文字多到换行时,经常会出现输入框跟着变高的问题。以前常用 JavaScript 在每次输入后重新算一遍高度,现在可以让文本框宽度固定、高度保持自动了。但是这个特性 Agent 不一定知道,因为 AI 大模型预训练的数据可能不是最新的。

针对类似这种问题,Chrome 团队出手了。把这个开源项目装进 Codex、Claude Code 等 Agent,提醒它们写网页前先查查浏览器有哪些现成的功能。这样就通过 Skill 把 Web 平台专业知识、最佳实践和浏览器兼容性的知识给到 Agent。

开源项目简洁
Modern Web Guidance 把网页开发专家审核过的写法按场景整理成指南。Agent 接到相关任务后,Skill 会提示它先用命令行工具在本地搜索。你可以点名某个浏览器功能,也可以只描述想要的效果,搜索会同时看关键词和需求的意思。找到相关指南后,Agent 可以读到具体怎么写、哪些细节容易漏掉,以及怎么兼容项目要支持的浏览器。

举一个例子。很多网页聊天框用回车发送消息,拼音输入法也可能用同一个键来确认候选词。如果代码一收到回车就发送,正在编辑的半句话就可能被发出去。Skill 会让 Agent 先看按键事件里的 isComposing,如果输入法还在组字,就跳过这次发送。部分 Safari 版本处理组字和按键事件的顺序有差异,Skill 也有兼容写法。

再举一个懒加载的例子。如果 AI 写了博客网站,你期望打开博客文章时首屏封面尽快出来。如果它和后面的配图一起设成懒加载,浏览器可能晚一点才开始下载这张图。Skill 会建议找出首屏上最重要的那张图,去掉它的懒加载,再用 fetchpriority="high" 提示浏览器优先下载。页面下方的普通配图可以用 loading="lazy",等读者快滚到时再加载。

怎么用
在 Codex 或 Claude Code 里,把仓库链接丢给你的 Agent,让它教你怎么用就行了。想让它先参考指南,可以在需求里加一句「先用 Modern Web Guidance 查这个需求的推荐写法,再改代码」。
Github:https://github.com/GoogleChrome/modern-web-guidance-src