Modern Web Guidance 是 Chrome、Edge、Firefox、MDN 四方联合维护的一套官方技能:把现代 Web 平台的写法、最佳实践与浏览器兼容数据直接装进编程智能体,让它写网页时按最新规范来,而不是凭训练数据里的老代码给你堆臃肿实现。Apache-2.0 许可证,发行仓库 GitHub 实时 22,089 星(本站核对:2026-11-18),2026 年 11 月 9–15 日那周新增约 1.49 万星,是当周 GitHub Trending 第二名。本站验证:npx modern-web-guidance@1.0.1 search 与 retrieve 不装即跑通,搜到 10 条指南并取回 244 行完整指南;安装向导未在客户端内实测,步骤以官方文档为准。
能干什么
- 262 条官方指南随取随用:CSS 与布局 140 条、HTML 与 DOM 37 条、JavaScript 与 API 85 条,覆盖弹窗、动画、表单、容器查询、subgrid、oklch 颜色、Popover、Anchor Positioning、INP 性能诊断等近几年的新能力。
- 三种用法:
search "想做的事"找指南、retrieve 指南编号取完整写法、legacy-scan .扫一遍你的代码,列出哪些是该换掉的老写法。 - 兼容性有数:指南按 Baseline 真实兼容数据写,哪些浏览器能用、哪些要加轻量回退,里面直接写清;实验性 API 默认锁着,要显式开锁才放给智能体。
- 两个技能包:
modern-web-guidance(约 205 tokens,通用 Web 写法)与chrome-extensions(约 175 tokens,Manifest V3、后台 Worker、扩展 API 与上架),装的时候可用--choose只挑需要的。
优缺点
优点:四方官方背书,指南由浏览器厂商自己写;评测有数——官方 11 月初的评测快照里,三家智能体在 200 多个任务上,有指导后的通过率从 50% 多升到 82%–96%,提升 27–36 个百分点;搜索在本地跑(零依赖 embedding 模型加 BM25),不联网、不要 API key;指南按 token 精简过,塞进上下文不占地方。
缺点与边界:它只解决“写法”问题,不管产品逻辑与业务判断;指南是英文的,英文吃力的用户要先让智能体用中文复述要点再动手;Claude Code 官方插件市场曾在 10 月 12 日停止更新第三方插件,旧版会卡在 v0.0.194 收不到更新,必须改用 googlechrome 市场;实验性功能默认锁住,想尝鲜要手动开配置。
下载与安装(官方文档口径)
- 一键安装(推荐):
npx modern-web-guidance@latest install,交互向导会问你要装给哪个智能体、装哪几个包;只想装某个包用npx modern-web-guidance@latest install --choose。 - 不装也能先试三条命令:
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 .——本站就是这么验的,不用装、不用注册。 - 其他安装路线:Vercel Skills CLI(
npx skills add GoogleChrome/modern-web-guidance)、GitHub CLI(gh skill install GoogleChrome/modern-web-guidance)、Claude Code 插件(先/plugin marketplace add GoogleChrome/modern-web-guidance再安装)、Codex 插件、Google Antigravity、Kimi Code、Grok Build CLI。 - 更新:
npx modern-web-guidance@latest update。Claude Code 旧版迁移:先/plugin uninstall modern-web-guidance@claude-plugins-official,再按第 3 条从 googlechrome 市场重装并开 AutoUpdate。 - 国内网络:npx 默认走官方注册表,下载慢可换 npm 国内镜像源(
npm config set registry https://registry.npmmirror.com),装好之后搜索与取指南全程离线。
调用与使用
- 装好后不用你操心调用:智能体接到与网页相关的任务时,会自己按任务调这个技能的 CLI 查指南、取写法,再写代码。
- 本站实测:
search "animate a dialog modal backdrop"返回 10 条指南,包括animate-to-from-top-layer、light-dismiss-a-dialog、dialog等;retrieve "animate-to-from-top-layer"取回 244 行完整指南,讲清@starting-style、transition-behavior: allow-discrete、overlay属性与::backdrop动画,附可直接用的 CSS。 - 先给自己的站做一次体检:
npx modern-web-guidance@latest legacy-scan .,扫出来的老写法清单就是重构排产表,按“影响性能与无障碍”的顺序改。 - 实验性功能开锁:项目根目录放一个
.mwgrc文件,"allowOriginTrials": true解锁 Origin Trial 相关指南,"allowVolatileFeatures": true解锁刚发布三个月内的单引擎新特性;开锁前先确认目标浏览器支不支持。
调教成自己的
- 把 .mwgrc 提交进仓库:团队共用一份配置,谁开锁、谁不开,代码库里说了算,不靠每个人口头约定。
- 只装用得上的包:只做网站就装通用包;做浏览器插件的人再加 chrome-extensions 包,别两个全装占上下文。
- 把 legacy-scan 变成固定动作:每次接手老站或改版前先扫一遍,清单贴进任务表;改完再扫一次,看清单是不是真的清零了。
- 让智能体先复述再动手:英文指南读着费劲时,先让它用中文讲一遍“这个写法解决什么、兼容性如何、回退怎么做”,确认理解对了再让它写代码。
玩法:独立站卖家给店铺加弹窗,再也不用 JS 库堆
模拟一位做独立站的创业者:想给店铺加一个“新客领券”弹窗和一个手机端抽屉菜单。过去让智能体写,它大概率拖一个 JS 弹窗库进来,又重、手机上又卡。装了这个技能之后打法变了:
- 直接对智能体说需求,不用指定技术方案:“加一个新客领券弹窗,点外面能关;再加一个手机端抽屉菜单。”
- 智能体自己去查指南:弹窗走原生
dialog加light-dismiss(点外面关闭)、抽屉走导航抽屉指南,进出场动画用@starting-style与transition-behavior: allow-discrete。 - 你拿到的是原生写法:没有第三方库、代码量小、手机上自带无障碍支持,旧浏览器也有写好的轻量回退。
- 改完用 legacy-scan 再扫一遍,确认没有新的老写法被写进来。
避坑指南
- 认准两个仓库,别装错:
GoogleChrome/modern-web-guidance是发行仓(装这个),GoogleChrome/modern-web-guidance-src是源码仓(看代码、提 issue 走这边)。两个仓库 README 内容一样,星数不同。 - Claude Code 插件认准 googlechrome 市场:官方市场里的旧版已断更,卡在 v0.0.194;按正文第 4 条迁移,否则收不到新指南。
- 指南是英文:先让智能体中文复述要点再动手,别凭猜往代码里贴。
- 实验性 API 默认是锁的:搜得到、取不到是正常现象,不是装坏了;确实要用再开
.mwgrc,开之前先查 Baseline 兼容数据。 - 遥测可以关:官方会收集匿名的安装量、调用的智能体名、指南检索编号与搜索词,不收原始提示词;不想被收集就设环境变量
DISABLE_TELEMETRY=1。
档案
- 仓库:发行仓 github.com/GoogleChrome/modern-web-guidance,源码仓 github.com/GoogleChrome/modern-web-guidance-src;许可证 Apache-2.0(干净可商用,可二开、可改、可分发,须保留声明、改动注明);文档 developer.chrome.com;npm 包 modern-web-guidance,最新版 1.0.1(注册表核对)。
- 星数:发行仓 22,089,源码仓 8,465(2026-11-18 实时核对);2026 年 11 月 9–15 日那周新增约 1.49 万星,GitHub Trending 周榜第二。
- 本站验证:
search与retrieve不装即跑通(10 条指南、244 行完整指南);安装向导与各客户端插件接入未实机部署,步骤以官方文档为准。
常见问题
直接问 AI 写网页,和装这个技能有什么区别?不装时智能体凭训练数据里的老代码写,容易用上已被更好方案替代的写法;装了之后它会先查官方指南再写,写出来的更接近当前浏览器的原生做法。
它会联网吗?装好之后搜索与取指南全程本地离线,不联网、不要 API key;只有 npx 安装与更新那一步需要下载。
支持哪些智能体?官方给出 Claude Code、Codex、Antigravity、Kimi Code、Grok Build、GitHub Copilot CLI 等多条安装路线,另有 Vercel Skills CLI 与 GitHub CLI 通用路线。
中文站能用吗?能。指南讲的是 Web 平台写法,与页面语言无关;只是指南本身是英文,读的时候让智能体中文复述即可。
装完不知道有没有生效怎么办?先跑正文里的 search 与 retrieve 两条命令,能出指南就说明 CLI 正常;再看智能体写代码时是不是真的去查了指南。可以看本站的部署与配置跑通服务,把跑通这一步交出去。
站内往下读:AI智能体栏目、AI编程栏目、OpenCode:终端里的开源 AI 编程智能体、harness 是什么:模型之外的一切,才决定 AI 干活的水平。



