让 AI 写前端,经常会遇到这种情况:一个弹窗,它给你写了一大段 JS 监听点击遮罩、手动锁滚动,而浏览器原生 <dialog> 早就能搞定。原因并不复杂,训练数据里旧代码太多。
谷歌 Chrome 团队的 modern-web-guidance 就是冲着这个问题来的。它的源码仓库 GoogleChrome/modern-web-guidance-src 截至北京时间 11 月 14 日 7 点(美西时间 13 日 15 点)查看,共有 4,764 颗星,当日在 GitHub Trending 上新增 1,875 颗,许可证 Apache-2.0。README 写明,项目由 Google Chrome、Microsoft Edge、Mozilla Firefox 和 MDN 团队与社区共同维护。
GoogleChrome/modern-web-guidance-src 仓库预览图。图源:GitHub
它是什
一句话:一套给编码 Agent 用的“技能”(skill)。Agent 写代码前,可以通过它的 CLI 检索到有针对性的现代 Web 指南,放进上下文里。覆盖范围包括:
- 交互体验:View Transitions、进出场动画、滚动驱动效果;
- CSS 布局:容器查询、subgrid、
oklch颜色空间; - 性能:预加载、INP 诊断、
scheduler.yield; - 表单与组件:Anchor Positioning、Popover API、dialog、
:user-invalid; - 无障碍,以及浏览器内置 AI(本地翻译、摘要、语言检测 API)。
README 里列出的完整清单一共 250 个现代 Web 特性,其中 CSS 与布局占 140 个。官方还强调指南做过“省 token”优化,模型本来就会的内容会被裁掉。
不安装,先试三条命令
需要 Node.js 环境。我实测的版本是 1.0.0:
# 1. 按需求搜索指南
npx modern-web-guidance@latest search "animate a dialog modal backdrop"
# 2. 按 ID 取回完整指南
npx modern-web-guidance@latest retrieve "light-dismiss-a-dialog"
# 3. 扫描代码库里的过时写法
npx modern-web-guidance@latest legacy-scan .
search 返回的是 JSON 列表,第一条就是 animate-to-from-top-layer(顶层元素进出场动画),后面还有点击遮罩关闭弹窗、弹窗打开时禁止背景滚动等。retrieve "light-dismiss-a-dialog" 给出的做法很简洁:给 <dialog> 加 closedby="any",再用 dialog.showModal() 打开,遮罩样式用 ::backdrop 写。
实测:search 与 retrieve 的输出。图:小方ai资讯实测截图
legacy-scan 我拿一个用 div 遮罩 + JS 锁滚动写的小页面试了一下,结果是 “0 findings from 33 qualified guides”。工具也很坦诚地提示:这个扫描目前只覆盖 33 份指南(约占全部内容的 20%),通用问题建议用 search。所以它更适合当 Agent 的“参考资料库”,而不是完整的 lint 工具。
装进你的 AI 编程工具
一键安装(交互式向导):
npx modern-web-guidance@latest install
也可以按工具分别安装,README 给出的方式包括:
# Vercel Skills CLI
npx skills add GoogleChrome/modern-web-guidance
# GitHub CLI
gh skill install GoogleChrome/modern-web-guidance
# OpenAI Codex
codex plugin marketplace add GoogleChrome/modern-web-guidance
codex plugin add modern-web-guidance@googlechrome
Claude Code 里则是:
/plugin marketplace add GoogleChrome/modern-web-guidance
/plugin install modern-web-guidance@googlechrome
/reload-plugins
另外 README 提醒:如果之前通过 Claude Code 内置的 claude-plugins-official 市场安装过,那个市场从 10 月 12 日起不再更新第三方插件,版本会停在 v0.0.194,建议卸载后改用 googlechrome 市场。通过 npx 安装的,用 npx modern-web-guidance@latest update 更新。
适合谁
经常让 Claude Code、Codex、Copilot 写前端页面的同学,可以装上试试,尤其是弹窗、表单、动画、响应式布局这类“老写法和新写法差别很大”的场景。装好以后,Agent 写组件时会优先考虑浏览器原生能力,少引一个库,代码也更短。
更多每日 AI 资讯见「小方ai资讯(AI直冲)」:www.aizc.club/blog