GoogleChrome/modern-web-guidance-src

项目介绍

Modern Web Guidance 把 Web 平台知识、最佳实践和浏览器兼容性数据封装成可供编码 Agent 加载的技能。它要解决的是 Agent 训练数据里旧代码太多、倾向重写 polyfill 或引入大体积库的问题，引导模型优先采用平台原生能力。本仓库是已发布技能的源码仓库，包含内容创作、校准和评测所需的代码与文档 项目文档。

指南内容分为用户体验、CSS 布局、性能、表单与 UI、可访问性、内置 AI 六个方向；README 列出 250 项现代 Web 特性和 203 个开发者用例，各自对应一份指南。项目由 Chrome、Edge、Firefox、MDN 团队和社区共同维护。

快速使用

不安装也能体验检索效果：

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

要装进编码 Agent，运行交互式安装器：

npx modern-web-guidance@latest install

安装过程会询问要装哪些技能包，--choose 可手动选择。支持的安装入口包括 Vercel Skills CLI、GitHub CLI、Google Antigravity、GitHub Copilot CLI、Claude Code、Grok Build CLI、Kimi Code 和 OpenAI Codex，各自命令见 安装方式。安装后，Agent 在遇到相关 Web 任务时会触发该技能，执行本地语义检索，再把匹配的指南取进上下文。更新用 npx modern-web-guidance@latest update。

检索方式

检索使用内置嵌入模型和 BM25 索引离线完成，不联网、不需要 API Key。指南按 token 效率设计，模型已掌握的内容会在评测后裁掉。实验性的 Origin Trial API 和近期才稳定或仍在变化的单引擎特性仍可被搜索到，但需要开发者显式授权才能取用，通过项目根目录的 .mwgrc 或 ~/.mwgrc 控制。

使用约束

CLI 通过 npm 分发，机器上需要有 npx。遥测默认开启，会上报安装次数、调用的 Agent 名称、取用的指南 ID 和检索查询词，不收集用户原始提示词；设置 DISABLE_TELEMETRY=1 可关闭 遥测说明。指南内容会随实验特性变化而调整，回退策略采用渐进增强，而非统一引入 polyfill。

许可按内容区分：代码使用 Apache-2.0，guides/ 下的内容使用 CC-BY 4.0。

HotRepo 点评

仓库在 2026-11-11 进入 GitHub 全语言日榜第 3 名，当天新增 133 Star。这只是单日快照，能说明当天涨势明显，不足以判断长期趋势。更值得看的是项目形态：README 附带评测看板和按日期记录的 Agent 结果，例如 11 月 8 日的运行中，codex_cli 从 54% 提升到 82%，antigravity_cli 从 58% 提升到 94%。这些数字来自项目自己的评测框架，不是独立基准，但能看出它把指南质量当作需要持续测量的对象，而非只靠叙述来主张效果。