Modern Web Guidance:让编码智能体先查现代 Web 做法
Modern Web Guidance 是现代 Web 开发指南技能:编码智能体先搜索再检索指南,覆盖 250 项特性,并按浏览器兼容性提供回退建议。
Skill 资料
npx skills add GoogleChrome/modern-web-guidance --skill modern-web-guidance写一个对话框、表单或滚动动效时,编码智能体很容易照着训练语料里的旧做法实现。Modern Web Guidance 是 Google Chrome 推出的现代 Web 开发指南技能:它让 coding agent 先查一条具体的 HTML、CSS 或浏览器 API 用法,再把相关指南取回上下文。README 当前列出 250 项现代 Web 特性;1.0 版于 2026-11-10 发布。
现代 Web 指南先搜后取
这套技能要求在动手写 Web UI、样式或客户端 JavaScript 前先搜索,而不是直接让模型凭记忆选 API。查询要用 2–5 个英文单词描述一个用户可见动作,例如“animate a dialog”,不要把 React、页面名称和多个功能堆在一起。搜索返回指南 ID 和简述;如果结果不对,先用具体的 HTML 元素或 UI 控件改写一次,再决定是否检索。找到合适的 ID 后,retrieve 会把完整做法交给智能体,包括相关的通用 HTML、CSS、无障碍、安全或性能建议。
这套顺序适合把“做一个表格”拆成响应式布局、排序行为等具体能力,也能避免检索一大组和任务无关的文档。查到指南后,智能体要按指南核对实现与回退方案;如果指南没有覆盖这个主题,就继续实现已能证实的部分,不要拿相近但无关的建议硬套。广泛整理旧项目时才用 legacy-scan;它只检查约五分之一带有静态规则的指南,不是完整代码审计。特定组件任务不应先跑这个扫描器。
指南覆盖什么
项目 README 将内容分成用户体验、CSS 布局、性能、表单与界面、无障碍和浏览器内置 AI 等领域,覆盖容器查询、Popover、View Transitions、passkey、图像优先级、INP 诊断等例子。README 说指南按 token 效率设计;每条指南面向一个具体任务,给出实现做法、回退建议与兼容性信息。内容由独立的 source repo 编写、校准和评测;面向使用者的技能与 CLI 在 GoogleChrome/modern-web-guidance 发布。README 称项目由 Chrome、Edge、Firefox、MDN 团队与 Web 社区共同维护。
兼容性、网络与隐私
兼容性是它最有用的约束之一:指南默认把 Baseline Widely Available 功能视为可直接使用;对未达到该基线的特性,智能体必须遵循指南给出的回退做法,除非用户明确提供浏览器支持政策。指南目录按 HTML、CSS、JavaScript、表单、无障碍、性能与 PWA 等主题划分。对不愿维护回退代码的团队,这个规则可能意味着选用较新的浏览器能力前要先明确目标浏览器。
CLI 通过 npm 使用,npm 元数据要求 Node.js 22.0 或更新版本;安装和更新需联网,技能不需要用户提供模型 API key。另一个应在组织内先评估的点是遥测:项目 README 称默认收集匿名使用数据,源代码显示搜索词、指南 ID、操作系统、CLI 与技能版本、Agent 名称、延迟区间和成功状态,由后台进程发送给 Google;README 表示不收集原始用户提示。可在 shell 环境设置 DISABLE_TELEMETRY=1 退出遥测。它适合需要最新平台做法和明确兼容性边界的前端团队;若工作主要在后端、构建脚本或测试配置,这个技能说明自己不应触发。
截至 2026-11-12,分发仓库有 4,414 颗星,TypeScript 源仓库有 1,537 颗星;两者的 GitHub API 许可证均为 Apache-2.0。想让智能体先定产品语气、版式和设计 token,可搭配 frontend-design;Modern Web Guidance 关注浏览器平台能力与兼容性,两者处理的是界面工作的不同层面。本文依据仓库 README、SKILL.md 与源码核对,未在本机运行 CLI。