2026 年 11 月 11 日——Google Chrome 团队于 11 月 10 日发布面向编码 Agent 的技能包 Modern Web Guidance 1.0 稳定版,结束自 5 月 Google I/O 起的预览阶段。据官方 GitHub 发布说明,1.0 版包含 203 条用例指南,覆盖 250 项 Web 平台功能,项目现由 Google Chrome、Microsoft Edge、Mozilla Firefox 与 MDN 四方团队联合 Web 开发社区共同治理,并新增旧代码静态扫描工具 legacy-scan。
Modern Web Guidance 以 Agent Skill 形式将 Web 平台专业知识、最佳实践与 Baseline 浏览器兼容性数据直接注入编码 Agent 的上下文窗口,引导 Agent 放弃旧有模式、改用原生平台能力。官方表示,LLM 训练数据中存在大量遗留代码,编码 Agent 常为已有原生方案的任务生成臃肿的 JavaScript;指南库按 token 效率设计,通过评测裁掉模型已掌握的常识性内容。项目仓库位于 https://github.com/GoogleChrome/modern-web-guidance,采用 Apache-2.0 许可证。
1. 指南库规模与审核机制
1.0 版指南覆盖用户体验、CSS 布局、性能、表单与 UI、无障碍、浏览器内置 AI 六大方向,另含 Passkeys、安全等主题。本次新增 15 条指南(UI 组件 8 条、UI 行为 3 条、布局与体验 3 条、PWA 1 条),更新 98 条,其中近 70 条完成人类专家无障碍审查,涉及非文本 UI 至少 3:1 对比度、表单错误经 aria-describedby 动态关联并由 polite live region 播报、滑动手势提供按钮或键盘替代等要求。
据 Search Engine Journal 报道,Chrome 官方公告称每条指南均经领域技术负责人审核批准,面向用户的功能指南另由日常使用辅助技术的无障碍专家进行专项审查。该报道同时回顾,无障碍顾问 Adrian Roselli 曾于 5 月测试预览版,指出 Antigravity 生成的手风琴组件不符合 WCAG、动画在 Firefox 中无法运行;该测试针对预览版而非 1.0 版。
项目治理文档于 11 月 9 日上传 GitHub,设 6 个所有者席位:Chrome 占 2 席,Edge 与 Mozilla 各 1 席,独立 Web 平台专家 2 席(当前 1 席空缺),Apple 未持有席位。
2. Baseline 兼容数据与功能门控
官方文档显示,指南内嵌 Baseline 兼容性数据,互操作性分三档:Limited availability(未互操作)、Newly available(近 30 个月内实现互操作)、Widely available(互操作满 30 个月及以上)。项目未配置时默认采用 Baseline Widely available 目标,开发者可在 AGENTS.md 或 CLAUDE.md 中声明项目 Baseline 目标;对未达广泛可用的功能,指南给出渐进增强与条件加载 polyfill 的回退策略。
对仅单一浏览器引擎实现、近 3 个月内发布或仍在稳定化的易变功能,指南保持可搜索,但 retrieve 取回需在 .mwgrc 中显式开启(set-allow-volatile-features 命令),与 Origin Trial 门控对齐。
3. legacy-scan 旧代码扫描与 CLI 更新
新增的 legacy-scan 子命令对项目 HTML、CSS、JavaScript 及 package.json 做静态扫描,识别旧版 Web 平台模式,并将每处发现映射到给出替代方案的指南。官方表示,首版覆盖约两成已具备确定性检测规则的指南,技能为 Agent 配套「扫描、核验、报告、现代化」四步工作流:
npx modern-web-guidance@latest legacy-scan .
搜索改用零依赖嵌入模型加 BM25,替换 TensorFlow.js,保持完全离线,npm 下载体积从 23.5 MB 降至 8.8 MB。安装命令为 npx modern-web-guidance@latest install,支持 Claude Code、Codex、Copilot CLI、Gemini CLI、Antigravity、JetBrains WebStorm 等主流编码 Agent 的插件渠道,CLI 安装方式支持自动更新。
4. 评测数据与早期采用案例
官方评测面板已公开,Anthropic、OpenAI、Google 的编码 Agent 每晚运行同一组任务,对比有无指南的表现,由真实浏览器校验完成应用的 DOM、样式与源码。官方文档称,早期结果显示现代最佳实践遵循率平均提升 37 个百分点,实际效果因项目、模型与提示词而异。据 Search Engine Journal 11 月 10 日查看的面板数据,基于 11 月 8 日夜间运行结果,有指南组自动检查通过率 88%,无指南组 56%,每个 Agent 任务数在 199 至 215 之间。
早期采用方面,据 Chrome 官方博客案例(Search Engine Journal 转述),日本创作平台 note inc. 在生产代码库克隆上以 2 个编码 Agent 执行 6 项 UI 任务、共 180 次测试运行,19 项浏览器检查得分依次为:未安装指南 60.8%、安装但提示词未点名 76.5%、提示词显式调用 94.0%(另一 Agent 对应为 75.8%、86.2%、90.0%)。MetaMask 将指南接入其开源浏览器扩展的 PR 自动审查流程,截至 10 月 21 日的前 5 周内在 57 个功能与修复 PR 中识别 102 个问题,其中 43 个已完全修复、3 个部分修复。
5. 数据一览与后续计划
| 项目 | 数据 |
|---|---|
| 版本 | v1.0.0,2026 年 11 月 10 日发布,结束预览 |
| 用例指南 | 203 条(本版新增 15 条,更新 98 条) |
| 覆盖 Web 平台功能 | 250 项 |
| legacy-scan 覆盖率 | 约 20% 指南(具备确定性旧版规则者) |
| npm 下载体积 | 23.5 MB → 8.8 MB |
| 默认 Baseline 目标 | Widely available |
| 治理席位 | 6 席(Chrome 2、Edge 1、Mozilla 1、独立专家 2) |
| 许可证 | Apache-2.0 |
| GitHub Star | 约 4100(截至 2026 年 11 月 11 日) |
据 Search Engine Journal 报道,官方计划扩大旧代码审计覆盖面,并引入由 Agent 推理实际代码的审计方式;官方建议将指南与面向 Agent 的 Chrome DevTools 搭配使用,让 Agent 在浏览器内运行并验证生成代码。官方文档与完整指南列表见 https://developer.chrome.com/docs/modern-web-guidance。
评论