由 Google Chrome、Microsoft Edge、Mozilla Firefox 和 MDN 团队与网页开发社区共同维护的 Modern Web Guidance,是一套面向编程 agent 的技能。它把网页平台知识、最佳实践和浏览器兼容性数据引入 agent,目标是让 AI 在编写网页时更多使用浏览器原生能力,减少对旧式实现的依赖。
项目 README 指出,大模型训练数据中包含大量遗留代码,编程 agent 因而经常默认采用旧写法,用臃肿的 JavaScript 实现网页平台已经原生支持的高性能功能。即使模型知道某个 API 存在,也可能缺少足够的现代实战范例,难以写出适合生产环境的代码。
Modern Web Guidance 的做法,是通过命令行工具将有针对性、经过专家整理的指南送入 agent 的上下文窗口。指南重点帮助模型正确使用容易误用的现代浏览器 API,优先选择可由浏览器优化、具备内置无障碍支持的平台级 API,并采用合理、轻量的后备方案,避免依赖笨重的 polyfill 或旧库。
据项目 README 列出的数量,指南覆盖 250 个现代网页特性,其中 CSS 与布局占 140 个,HTML 与 DOM 占 36 个,JavaScript 与 API 占 74 个;此外还列出了 203 个真实开发场景指南。
内容包括 View Transitions 和进出场动画等用户体验能力,容器查询、subgrid 和 oklch 等 CSS 能力,以及即时预加载、INP 诊断和通过 scheduler.yield 调度任务等性能主题。
表单与 UI 部分涉及锚点定位、Popover API 和对话框;无障碍部分关注屏幕阅读器、键盘操作及内容导航。浏览器内置 AI 也是核心领域之一,涵盖客户端本地模型提供的翻译、摘要和语言检测 API。
项目还称,指南以节省 token 为设计目标,会通过评测删减模型已经掌握的基础内容。
README 提供的安装命令为 npx modern-web-guidance@latest install,运行后会启动交互式安装向导。
开发者也可以不安装便试用:使用 npx modern-web-guidance@latest search 搜索相关指南,使用 npx modern-web-guidance@latest retrieve 按 ID 获取指南,或运行 npx modern-web-guidance@latest legacy-scan .,扫描代码库中需要现代化改造的过时写法。