你让 AI 写个弹窗,它给你手算位置、绑一排事件监听,再叠一层遮罩——而浏览器现在的 `dialog` 加 `showModal()`,背景和焦点管理自带。知乎
不是它笨,是它学的代码太老:模型的训练数据里,老代码远多于新写法。知乎

四家团队一起署名,这很少见
11 月 10 日,GitHub 仓库 GoogleChrome/modern-web-guidance 发布 v1.0.0,Apache-2.0 协议。README 的署名是 Google Chrome、Microsoft Edge、Mozilla Firefox、MDN 四个团队,加 Web 开发社区共同维护。知乎哔哩哔哩知乎知乎
它连着三天挂在 GitHub Trending 上,单日新增 star 从 159 涨到 739、再到 1,925,11 月 13 日那天是日榜第一。同期 Show HN 拿了 209 分、58 条评论。知乎知乎知乎

不改模型,改上下文
250 个现代 Web 特性——CSS 与布局 140 个、HTML 与 DOM 36 个、JavaScript 与 API 74 个,另配 203 个真实开发场景——被切成一份份短指南,在 agent 需要时按需塞进上下文。知乎知乎
检索全在本地跑,用离线零依赖的 embedding 模型加 BM25,不发网络请求、不要 API key。npm 包自包含,没有额外依赖。知乎知乎

Chrome 团队的 paulirish 在 HN 举的例子很典型:CSS.highlights 做文本高亮,dialog 加 showModal() 自带 backdrop 和焦点管理,field-sizing 让 textarea 随输入自动增高。模型知道这些 API 的名字,就是不会默认用。知乎
一条命令,0 元
```
npx modern-web-guidance@latest install
```
交互式向导装完就能用,Cursor、Claude Code、Codex、Copilot、Antigravity、Kimi Code、Grok Build CLI 都有入口,Claude Code 还能直接走插件市场。知乎知乎

不想装也能先试三条:`search` 按任务找指南、`retrieve` 按编号取全文、`legacy-scan .` 扫一遍现有代码里的旧写法。知乎
效果数字,先看清口径
README 自述 11 月 8 日那批评测,约 215 个任务、1800 条断言:Claude Code(opus-5-5)通过率从 57% 到 88%,Antigravity(gemini-4-argon)从 58% 到 94%,Codex CLI(gpt-6.1-sol)从 54% 到 82%。知乎知乎
听着很猛,但这 88% 跑的是官方自己的任务集,换个场景还剩多少,官方博客没写。好在它没有只晒高分——unguided 基线也一起报了,姿态比只报好消息诚实。拿自己的项目跑一遍,才知道值不值。知乎知乎
三个别忽略的坑
一,legacy-scan 只覆盖约两成指南,就是有确定性规则的那部分。别指望一键翻新旧仓库——官方也刻意没做自动修复,怕改完表面干净、行为悄悄变了。先扫一眼,人工对着看。知乎知乎
二,遥测默认开着。匿名收集安装次数、agent 名称、被检索的指南 ID 和搜索查询,不收原始 prompt,`DISABLE_TELEMETRY=1` 可以关。公司项目上线前,这条先过合规。知乎
三,实验性 API 默认锁着。Origin Trial API 和发布三个月内的易变特性,search 里能看到但 retrieve 被门控,要开发者显式解锁。这条其实是优点:它不许你的 agent 擅自押注不稳定 API。知乎
榜单上更大的信号
11 月 8 日到 14 日这一周,大厂官方仓库在 GitHub 热榜占了 32 席,比前三周加起来的 31 席还多一席。名字带 skill 的仓库从一周 8 席涨到 12 席,同期在榜的还有 openai/codex-security、alibaba/open-code-review、anthropics/skills、cloudflare/security-audit-skill。知乎
热榜总热度并没抬——四周里每天冠军的新增 star 一直落在 1,700 到 4,300 之间。变的是坐在上面的人。大家争的不再是"谁的模型强",而是谁能把人写好的规矩,压成 agent 读得进去、还经得起验证的文件。知乎

顺带一句风险:规范文件本身也是新攻击面。11 月初 Forever Security 披露了一种 AGENTS.md 投毒攻击,用真实攻击者的 payload 在虚拟机里复现,针对 Codex 的成功率超过九成。装任何第三方 skill 前,先看一眼它要哪些权限。量子位
该不该装
天天让 AI 改前端的:值得。0 元、一条命令,最坏情况是 agent 多查几次文档。
只做后端、Python/Go、CI/CD 的:SKILL.md 自己就写明了不触发这些场景,暂时用不上。知乎
指望它替你验证页面跑得对不对的:它只给规范,验证得靠让 agent 自己开浏览器测。知乎