Google 发布 Modern Web Guidance 1.0：给 AI 编程 Agent 补上现代 Web 知识

Google 把 Modern Web Guidance 升级到 1.0，这是一套免费的技能包，能让 Claude Code、Codex 等 AI 编程工具按当前浏览器能力写代码，并新增了对存量代码的审计功能。官方评测显示带引导的代码通过率 88%，不带只有 56%，日本平台 note 和 MetaMask 的实测也验证了效果。

1.0 版本新增了什么

• 新增代码审计功能：扫描项目的 HTML、CSS、JavaScript 和 package.json，找出可以安全升级的旧写法，再引导 Agent 逐步修改
• 目前审计基于静态分析，只能识别有限的代码模式
• 指南库已覆盖数百个经过验证的 AI 知识盲区，重点解决可访问性、安全响应头、脚本和图片加载优先级等模型常犯的错
• 每篇指南由领域技术负责人审核，面向用户的功能指南还由日常使用辅助技术的专家做专门的可访问性审查

治理结构：不止 Google 一家说了算

• 项目在 GitHub 上公布了治理文档，设六个所有者席位：Chrome 占两席，Microsoft Edge 和 Mozilla 各一席，另外两席给独立的 Web 平台专家
• 目前还有一个独立席位空缺，Apple 没有参与
• Firefox 和 Edge 在 1.0 版本加入项目，不再只是 Chrome 单方面输出规范

官方评测：带引导通过率 88%，不带 56%

• Google 公开了一个评测仪表盘，Anthropic、OpenAI 和 Google 的编程 Agent 每晚跑同一批任务，有引导和无引导各跑一遍，再用真实浏览器检查 DOM、样式和源码
• 11 月 8 日的数据：带引导的运行通过 88% 的自动化检查，无引导只有 56%，每个 Agent 每晚跑 199 到 215 个任务
• 任务提示词里不提这套指南，Agent 需要自己判断何时套用
• 代价是带引导的运行更慢、消耗更多 token
• 可访问性检查只覆盖键盘、焦点、表单标签等基础项，官方明确说这不是完整的 WCAG 审计

第三方实测：note 和 MetaMask 的数据

• 日本创作平台 note 用两个 Agent 在生产代码库的克隆版上跑了 6 个 UI 任务、共 180 次测试：Agent One 从 60.8% 升到 76.5%（装了技能但提示词不点名），再升到 94.0%（提示词明确点名）；Agent Two 从 75.8% 到 86.2% 再到 90.0%
• 一个典型错误：无引导时 Agent 给首图同时写了高优先级和懒加载，两个属性互相矛盾
• MetaMask 把这套指南接进了开源浏览器扩展的 PR 自动审查流程，前五周在 57 个 PR 里发现 102 个问题，43 个完全修复、3 个部分修复，16 个被拒或误报，20 个未处理

怎么用起来

• 在项目目录运行 npx modern-web-guidance@latest install 安装，也可从主流编程 Agent 的插件市场获取
• 已有用户可用 npx modern-web-guidance@latest update 升级
• Google 建议搭配 Chrome DevTools for agents，让 Agent 自己运行并测试写出的代码
• 提示词里明确点名使用指南效果最好，note 的数据证明了这一点

值得注意的争议

• 可访问性顾问 Adrian Roselli 在 5 月预览版测试中发现，Antigravity 生成的手风琴组件不符合 WCAG，动画在 Firefox 上也失效，且无法保证 Agent 真会遵循指南——不过这是预览版的结果，不代表 1.0