Chrome 给 AI 写了份教材,只收它写错的
- 2026-11-21 02:00:44
上周三夜里给页面加弹窗,我随手把需求丢给编码 Agent。它回我的还是那一套:display:none 切 display:block,外加四行手写的 z-index。
翻完 README 我才想明白这件事——它不是不会,是它见过的老代码比新代码多。

01四家浏览器凑了一本教材
这几天它一直挂在 GitHub 日榜上,名字叫 GoogleChrome/modern-web-guidance-src。拗口,干的事一句话就能说完:把现代 Web 平台的正确写法,塞进编码 Agent 的上下文。
牵头的是 Chrome 团队,联合署名的是 Microsoft Edge、Mozilla Firefox 和 MDN。三家平时抢份额,在「别让 AI 再用老办法居中」这件事上倒是站到了一边。
仓库今年 1 月 27 日建的,PR 编号已经排到 3593 号,今天 5,146 星。
02250 条是删完剩下的
README 写覆盖 250 个现代 Web 特性,光 CSS 与布局就占 140 个。乍看像本大厚书。
往下读才发现是反的。这 250 个特性的内容,先被模型考过一遍:他们在真实应用上出题、跑评分,模型本来就会的那部分,直接剪掉。
这是 11 月 8 日那轮的数,214 个任务、1673 到 1801 个检查项,三套模型各涨 28 到 36 个百分点。
口径我核对了 README 原文:opportunity 是「100% 减裸考通过率」,uplift 是「装上减裸考」。自己会的删掉,老是错的补上,这套判断写在评测那一节,不是我的推测。
03205 个 token 装得下什么
装完之后,整个技能包 205 个 token。一条长点的微信消息都比它长。
小得下来是因为出题时就堵了作弊。底稿是两个完整的应用,一个叫 daily-grind,一个叫 devtools-times。任务描述不许点 API 名,比如只说「让我的图片加载快点」,至于该用 View Transitions 还是 container queries,Agent 自己找。
npx modern-web-guidance@latest install
评分器还得双向标定:对着三个模型给出的标准答案必须 100% 通过,对着没改过的原始应用必须 100% 失败。一头做不到就重调。
授权也分了两层:代码 Apache 2.0,guides/ 里的正文是 CC-BY 4.0。想把内容搬进自己的提示词库,署名那一步省不掉。
04有两扇门是关着的
也不是 250 个都能直接用。标了 Origin Trial 的、三个月内只有单一引擎实现的「易变特性」,search 搜得到,retrieve 取不出来。得在项目根目录放个 .mwgrc,显式写上 allowOriginTrials 才算同意。
降级也卡了线:优先写 50 行以内的轻量兜底,不是引一整包 polyfill 顶着。
⚠️默认会上报安装量、调用它的 Agent 名字、以及检索了哪些指南 ID。原始 prompt 不上报,介意就设 DISABLE_TELEMETRY=1。
💡说白了,给 Agent 写规范要把顺序反过来:先让它裸跑,把它做对的删掉,只留它做错的。我收藏夹里躺着十几个装了一半的技能包,基本都死在「把我懂的都写进去」这一步。
蝼蚁科技随谈 · 只挑 48 小时内值得说的