项目2026-11-11 · 智涌AI

Modern Web Guidance 是什么:谷歌给编程 Agent 的前端指南包

Modern Web Guidance 头图:终端演示 search、retrieve、legacy-scan 三条命令,检索到弹窗动画指南,标注 203 篇用例指南、评测通过率提升 28 到 36 个百分点、v1.0.0 于 11 月 10 日发布

Modern Web Guidance 是谷歌 Chrome 团队发起的一套 Agent Skill,治的是编程 Agent 写前端时的老毛病:一个弹窗手写几十行 JS,一个提示框直接装个库,可浏览器早就有原生方案了。2026-11-10(北京时间)它发布 v1.0.0,正式结束预览,改由 Chrome、Microsoft Edge、Mozilla Firefox 和 MDN 团队共同维护。代码 Apache-2.0,指南内容 CC-BY 4.0。

它是什么

它由两部分组成:一个告诉 Agent「写 HTML/CSS/前端 JS 之前先查一下」的 SKILL.md,和一个 npm 包里的命令行工具 modern-web-guidance。指南按场景来写,比如「导航抽屉」「可排序表格」「复制按钮」,每篇写清该用哪个原生特性、浏览器兼容情况、老浏览器怎么降级,还有容易踩的坑。仓库里另带一个 chrome-extensions Skill,讲 Manifest V3 扩展开发和上架 Chrome 应用商店。

仓库github.com/GoogleChrome/modern-web-guidance(源码在 modern-web-guidance-src)
维护方Google Chrome、Microsoft Edge、Mozilla Firefox、MDN 团队与社区
许可证代码 Apache-2.0;指南内容 CC-BY 4.0
热度GitHub 3,524 星、120 fork(GitHub API,2026-11-11 15:18 北京时间);npm 上周下载 102,803 次(11-03 至 11-09);skills.sh 包页安装 modern-web-guidance 40.7K、chrome-extensions 13.2K
运行要求Node.js 22 及以上;任一支持 Skill 或插件的编程 Agent
最新版本v1.0.0(发布于 2026-11-10 11:24,北京时间);此前 v0.0.x 大约每周一版

解决什么问题

README 给的理由很实在:模型训练数据里老代码太多,Agent 默认就往老路上走。就算模型知道某个 API,也常常不清楚生产环境里该怎么写、哪里会出问题。拿导航抽屉举例,指南要求只做抽屉时用 <dialog> 配 showModal(),焦点管理、Esc 关闭、背景不可交互都交给浏览器;如果它在宽屏上还要变成侧边栏,就换成 popover="manual"。手势跟手用 CSS scroll-snap 实现,不用自己写指针事件。

指南还会写一些容易漏掉的细节,比如 fetchLater() 的负载上限是 64KB,allow-discrete 应该单独写在 transition-behavior 里,不要塞进 transition 简写,否则老浏览器会把整条声明丢掉。还在 Origin Trial 阶段的 API,以及只有一个引擎刚上线的「易变特性」,用 search 搜得到,retrieve 默认取不出来,需要在 .mwgrc 里手动打开。

先让 Agent 查一下浏览器现在已经能做什么,再决定要不要装库。

怎么用

官方推荐用交互式向导安装,会问你装到哪个 Agent、装哪几个 Skill:

npx modern-web-guidance@latest install
npx modern-web-guidance@latest install --choose   # 只挑 modern-web-guidance 或 chrome-extensions

不想装也能直接试,三条命令分别是搜索、取指南、扫老代码:

npx modern-web-guidance@latest search "animate a dialog modal backdrop"
npx modern-web-guidance@latest retrieve "animate-to-from-top-layer"
npx modern-web-guidance@latest legacy-scan .

各家 Agent 的安装方式(任选其一):

# Vercel Skills CLI
npx skills add GoogleChrome/modern-web-guidance
# Claude Code(官方插件市场)
claude plugin install modern-web-guidance@claude-plugins-official
# OpenAI Codex
codex plugin marketplace add GoogleChrome/modern-web-guidance
codex plugin add modern-web-guidance@googlechrome
# GitHub Copilot CLI
/plugin marketplace add GoogleChrome/modern-web-guidance
/plugin install modern-web-guidance@googlechrome

装好以后照常提需求,不用点名 API。文档给的示例提示词有「把老的模态窗口改成 <dialog>,用现代 CSS 加动画」「我的应用长任务很多,INP 不好,帮我修」。SKILL.md 规定 Agent 交付时要在末尾附一段 ### Modern Web Guidance,写明用了哪篇指南、避开了什么坑,方便你核对。想整体改造老项目,就让它按「扫描、核实、报告、改造」四步走 legacy-scan。

浏览器支持方面,默认把 Baseline「广泛可用」的特性当作可以直接用,其余的按指南写降级。目标浏览器更严或更宽的话,官方建议把规则写进 AGENTS.md 或 CLAUDE.md,例如「允许新近可用的特性,降级代码不超过 20 行、不引入外部依赖」。

评测与注意事项

官方的评测是这样做的:拿两个完整的示例应用出题,提示词里不提任何 API 名称,用 Playwright 检查源码、计算样式、DOM 行为和无障碍状态,再对比装和不装这套 Skill 时的通过率。README 里 11 月 8 日的一组结果:

Agent(模型)任务 / 断言不装 → 装上
Antigravity CLI(gemini-4-argon)214 / 167358% → 94%(+36pp)
Claude Code(opus-5-5)215 / 180157% → 88%(+31pp)
Codex CLI(gpt-6.1-sol)215 / 179554% → 82%(+28pp)

这是项目方自己的评测,每篇指南的分项结果可以在公开的评测面板上查。使用前有几点要知道:

适合谁 / 不适合谁

适合经常让 Agent 写页面、组件、表单的人,特别是在意无障碍和性能、不想项目里堆一堆 UI 小库的团队。它和 Chrome DevTools MCP 能配合着用:一个让 Agent 在真浏览器里量性能、看无障碍树,一个告诉它该怎么改。想管视觉风格的,可以另外看 Impeccable 这类设计 Skill,两者各管一块。

纯后端、脚本或数据项目用不上。必须兼容很老浏览器的项目,要先把支持策略写清楚,不然 Agent 会默认按 Baseline 来写。

最后

手头有老前端项目的话,先在项目根目录跑一次 npx modern-web-guidance@latest legacy-scan .,挑一两条结果让 Agent 照指南改,看改出来的代码是不是比原来短。

关注公众号「智涌AI速递」

每天的 AI 快讯、实用教程和 AI项目实测,也会同步发到微信公众号。在微信里搜索「智涌AI速递」就能关注;不用微信的话,可以用 RSS 订阅本站。