Modern Web Guidance 是什麼?AI 寫網頁最常錯的 10 件事、4 個案例與安裝教學

AI 寫出來的網頁能動,不代表寫對。Chrome 的 Modern Web Guidance 1.0 準備了 200 多份專家審過的網頁開發指南,讓 AI 動手前依任務查出需要的那幾份。這篇整理它是什麼、AI 最常錯的 10 件事、4 個官方案例的真實口徑,以及怎麼安裝。

以後在 Google 搜尋,想先看到王董的文章?
加入偏好來源,這篇文章所在的網域會更容易被 Google 推薦給你。
Modern Web Guidance 是什麼?AI 寫網頁最常錯的 10 件事、4 個案例與安裝教學

叫 AI 幫你寫一個網頁,它通常寫得出來,畫面也會動。

但如果你請一位資深前端工程師來審這份程式碼,他幾乎一定挑得出毛病:可以更快、對身障使用者更友善、更安全。

切入重點,先用一句話講結論:

Modern Web Guidance 是給 AI 寫程式工具用的網頁開發技能包,提供專家指南與瀏覽器相容性資料。

AI 接到寫網頁的任務時,它會依需求查出最相關的指南,把精簡內容放進 AI 的工作記憶,引導 AI 用現代瀏覽器內建的寫法,少用十年前的老套路。2026 年 11 月 10 日推出 1.0 穩定版,由 Chrome、Firefox、Edge 三家瀏覽器團隊合作,MDN 也一起維護。

效果有多大?在 Chrome 自家的評測套件裡,沒有額外指引的 AI coding agent,平均只通過約 50% 的現代網頁檢查;使用 Modern Web Guidance 時約為 90%(Chrome for Developers)。

這篇整理它是什麼、為什麼需要、1.0 多了什麼、AI 最常錯的 10 件事、四家公司的官方案例,以及怎麼安裝。

Modern Web Guidance 是什麼?

先講兩個名詞。

AI coding agent(AI 寫程式代理):像 Claude Code、Codex、Cursor、GitHub Copilot 這類工具,你用自然語言交代任務,它自己讀程式碼、寫程式、跑指令。

Skill(技能包):裝進 agent 的一份工作手冊。平常 agent 只看得到一小段說明,遇到相關任務才把完整內容叫出來用。如果你想看 skill 怎麼變成品管關卡,可以參考這篇 Claude Code skill 教學:把手動品管檢查變成 AI 自動驗證關卡。

Modern Web Guidance 就是一個專門教 agent「網頁該怎麼寫才對」的 skill。

做過百貨專櫃的人都懂這個邏輯:新人上櫃,品牌會發一本陳列與話術手冊。新人不笨,賣得出東西,但沒有手冊,他會照自己的習慣來,品牌的標準就跑掉了。

Modern Web Guidance 就是發給 AI 的那本手冊,而且是一頁一頁、用到才翻。

它的時間軸很短:

  • 2026 年 5 月:Google I/O 首次以 early preview(早期預覽)推出,當時支援 100 多個使用情境(Chrome at I/O 26)
  • 2026 年 11 月 10 日:1.0 穩定版上線,Firefox 與 Edge 加入(1.0 發表文)
  • 2026 年 11 月 13 日:Chrome 發了一篇總整理,把整週的文章、案例、影片串起來(ICYMI 導讀文)

為什麼 AI 寫網頁需要它?

你知道為什麼嗎?

因為 AI 是讀舊程式碼長大的。GitHub 官方 repo 的說法是:模型的訓練資料裡有大量的舊寫法,所以 agent 預設就會往舊的方向走(GitHub README)。過去十年的舊程式碼,份量遠遠蓋過最近一年的新寫法。

Chrome 在導讀文舉了兩個例子:

  • 動畫:AI 偏好裝一個 JavaScript 動畫套件,而不是用瀏覽器已經內建的 CSS scroll-driven animations(跟著捲動播放的 CSS 動畫,不必寫 JavaScript)。
  • 下拉選單:AI 會用一層又一層的 div 硬刻一個可自訂外觀的下拉選單,而不是用 appearance: base-select 這行 CSS 直接讓原生選單變得可以自訂。

用生意人的話翻譯:

以前要做一個漂亮的下拉選單,得自己蓋一棟違章建築;現在瀏覽器已經內建了,AI 卻還在蓋違建。

違建不是不能住。問題是它比較慢、比較難維護,身障使用者用螢幕閱讀器(幫視障者朗讀網頁的軟體)時,也常常讀不懂。

Chrome 評測中,沒有指引的 AI 平均通過約 50% 的現代網頁檢查,使用 Modern Web Guidance 時約 90%
Chrome 評測中,沒有指引的 AI 平均通過約 50% 的現代網頁檢查,使用 Modern Web Guidance 時約 90%

重點是什麼?

AI 寫網頁的問題,在於它寫得出「能動」的東西,但不知道「現在最好的寫法」是什麼。

對行銷和電商人來說,這直接連到你在乎的指標:頁面載入速度、Core Web Vitals(Google 衡量網頁體驗的三項核心指標)、結帳表單能不能被瀏覽器自動填入、身障使用者能不能順利下單。

Modern Web Guidance 1.0 帶來什麼?

1.0 主要四件事(1.0 發表文):

★ 200 多份專家審過的指南

涵蓋效能、樣式、無障礙、資安、隱私、表單等領域。GitHub README 目前列出 203 個實際開發情境、涵蓋 250 項網頁功能。每份指南都經過該領域的 tech lead 簽核,面向使用者的指南還另外做了無障礙審查,由每天都在使用輔助科技的無障礙專家實際測過。

★ 跨瀏覽器、內建相容性資料

每份指南都附上 Baseline(網頁功能在各大瀏覽器支援程度的標準)資料與 fallback(後備方案)。意思是:新功能如果還沒有全部瀏覽器都支援,指南會教 AI 怎麼讓舊瀏覽器也不壞掉。Chrome 的評測顯示,在這類「需要後備方案」的檢查上,沒指引的 AI 只過 43%,有指引提高到 87%(Cross-browser by default)。

★ 公開評測

所有指南都有對應的評測,結果放在公開的評測儀表板上,任何人都能看每個模型、每份指南的通過率。

★ 舊專案改造流程(legacy-scan)

新的 modernization workflow(現代化流程)可以掃描既有的 HTML、CSS、JavaScript 與 package.json,找出可以安全升級的舊寫法,再帶 agent 改。這段在後面安裝的地方細講。

再補一個小細節:它很省 token(AI 計算用量的單位)。平常 agent 只看到約 205 tokens 的說明,真的要用時,搜尋一次回傳 10 筆結果約 530 tokens,拉一整份指南約 800 tokens,而且搜尋是在你電腦本機跑的,不需要 API 金鑰(技術解析文)。

AI 寫網頁最常錯的 10 件事

Chrome 把評測裡最常失分的地方整理成十項(Top 10 things AI gets wrong in web development)。下面用白話各講一兩句,程式細節請看原文。

1. 無障礙:鍵盤焦點管理

打開彈窗後,焦點(鍵盤現在停在哪裡)沒有移進去,關掉後也沒回到原本的按鈕。用鍵盤或螢幕閱讀器的人,會在背景內容裡迷路。

2. 無障礙:減少動態效果

有些人對畫面晃動會頭暈。AI 做一般動畫還記得檢查「使用者是否要求減少動態」,換成平滑捲動、頁面轉場、捲動動畫這些新功能,就常常忘記。

3. 無障礙:表單驗證、格式提示與自動填入

使用者還沒填就先跳紅字、卡片到期日的格式提示只寫在一打字就消失的灰字裡、提示放在輸入框下方被手機鍵盤蓋住。結帳表單的一個小卡關,就可能掉一筆訂單。

4. 體驗:滑動與觸控手勢

AI 很會用 JavaScript 自己算滑動物理,但手感常常不如原生 App。很多手勢其實可以用 CSS 和瀏覽器內建的捲動功能完成,順暢度更好。

5. 體驗:彈窗、浮層與轉場

AI 常自己手刻彈窗的開關動畫、點外面關閉、鎖住背景捲動。瀏覽器現在已經有原生的 dialog 和 popover 可以處理,程式碼少很多,bug 也少很多。

6. 體驗:深色模式

少一行設定,深色模式的使用者每次開頁面都會先閃一下白畫面;原生的捲軸、表單元件也會卡在淺色。切換開關也常常沒有「跟隨系統」這個選項。

7. 效能:互動反應速度

AI 大多記得載入速度的老規則,但「頁面載完之後點下去有沒有卡」這件事常做不好,這正是 INP(互動到下一次畫面更新的時間,Core Web Vitals 之一)在量的東西。

8. 效能:版面位移與畫面閃爍

AI 記得幫圖片標寬高,但影片、網頁字型替換、手機瀏覽器網址列伸縮、A/B 測試的防閃爍程式碼,都還是會讓版面跳動,拉高 CLS(累計版面位移,Core Web Vitals 之一)。

9. 資安:防範跨站腳本攻擊

模型幾乎不會主動加上內容安全政策這類防護。Chrome 的說法是:整套評測裡,沒有被明確要求時,模型沒有主動加過 CSP(內容安全政策);就算 prompt 直接要求,沒指引的模型在資安檢查上仍然有超過一半沒過。

10. 資安:Passkey 登入

Passkey(通行金鑰,用手機指紋或臉部辨識登入、不用密碼)對使用者更安全,也有助登入轉換。但 AI 實作時常自己手刻編碼轉換、漏掉能力偵測,或讓已刪除的金鑰還留在使用者的密碼管理器裡。

你會發現,很多項目背後都是具體的「人」:用鍵盤的人、會暈的人、用手機填表單的人、在意帳號安全的人。

這些需求沒有明列出來,AI 就很容易漏掉。

四個官方案例:數字與口徑

Chrome 這次一起公布了四家合作夥伴的案例。以下數字都是 Chrome for Developers 官方案例文公布的數據,口徑與範圍列在表格最後一欄。

四個官方案例的代表數字:Pensionbazaar、MetaMask、WeTV、note inc.
四個官方案例的代表數字:Pensionbazaar、MetaMask、WeTV、note inc.
公司 怎麼用 成效數字 口徑與範圍
Pensionbazaar/Policybazaar(印度保險與退休規劃平台) Pensionbazaar 用 Modern Web Guidance + Chrome DevTools for agents 開發並驗收新頁面;Policybazaar 用 DevTools for agents 自動跑效能稽核 新頁面開發測試週期縮短超過 90%(約 4 天→幾小時)、新畫面 UI bug 少超過 90%;人工效能稽核工作量少 92% 前兩項是 Pensionbazaar 的新頁面;92% 是 Policybazaar 約 30 個高流量 landing page
MetaMask(加密錢包瀏覽器擴充功能) 在每個 PR(程式碼合併請求)上掛一個只用三行 prompt 設定的建議型 review bot,不擋合併 約 480 個 PR 中留言 64 個;功能與修正類 PR 上的 102 項建議,工程師修掉 54 項、部分修 3 項;從留言到修正中位數 15.2 分鐘 上線後五週內(截至 2026-10-21);中位數以 38 筆可追到 commit 的修正計算
WeTV(騰訊國際影音平台) 把 AI agent 接進 CI/CD(自動建置部署流程),用 DevTools for agents 診斷、用 Modern Web Guidance 修 90% 的效能測試失敗/反覆出現的效能回歸可自動診斷並修好;除錯到驗證完成從 4 小時縮到 30 分鐘(-87%) WeTV 的上線關卡是 CLS ≤ 0.1,案例主要是版面位移;30 分鐘含完整建置與人工評估
note inc.(日本創作者平台) 把 Modern Web Guidance 跟自家設計系統 note-ui 一起用,改造 Next.js 前端 現代網頁檢查通過率從 60.8% 提高到 94.0%;導入後的 PR 中,LCP 圖片正確優先載入寫法的採用率 +28%、表單自動填入寫法的採用率 +69% 在正式程式碼的複本上做 6 個 UI 情境、180 次測試、19 項標準;94% 是主力 agent 在明確提示使用指南時的成績,另一個 agent 是 75.8%→90.0%;+28% 與 +69% 來自 431 個導入後的 PR。設定上讓自家元件優先、指南補足元件沒涵蓋的部分

另外,Pensionbazaar、WeTV 的成效,都是 Modern Web Guidance 和 Chrome DevTools for agents 搭配使用的結果;Policybazaar 那 92% 主要來自 DevTools for agents 的自動稽核。從 Pensionbazaar 和 WeTV 的案例看得出來:

把「寫」和「驗收」接起來,才是時間省最多的地方。

站內驗收迴圈那篇講的是同一個道理:讓 AI 做得好的關鍵,常常不在 prompt 寫多長,而在你有沒有給它檢查自己作業的方法。

Modern Web Guidance 怎麼安裝?

目前最新版本是 1.0.0(以 npm 上的 modern-web-guidance 為準,2026 年 11 月 10 日發布)。

1. 用 npx 安裝(官方推薦)

在你的專案資料夾執行:

npx modern-web-guidance@latest install

這會跑一個互動式的安裝精靈,一步一步帶你設定專案和 agent。官方的說法很幽默:你直接叫 agent 幫你裝,也許會成功,但用這行指令最保險。

如果你在 I/O 預覽版時期就是用 npx 裝的,升級到 1.0 用(從外掛市集裝的,就照各家 agent 的外掛更新方式):

npx modern-web-guidance@latest update

2. 其他安裝方式

GitHub repo 列了各家 agent 的外掛市集安裝法,例如:

# Vercel Skills CLI
npx skills add GoogleChrome/modern-web-guidance

# GitHub CLI
gh skill install GoogleChrome/modern-web-guidance

# OpenAI Codex
codex plugin marketplace add GoogleChrome/modern-web-guidance
codex plugin add modern-web-guidance@googlechrome

Claude Code 和 GitHub Copilot CLI 則是在 agent 裡輸入:

/plugin marketplace add GoogleChrome/modern-web-guidance
/plugin install modern-web-guidance@googlechrome

另外也支援 Google Antigravity、Cursor、Grok Build、Kimi Code、WebStorm 等工具的外掛市集。

3. 不安裝,先試用

想先看看指南長什麼樣子,可以直接搜尋或拉一份出來看:

# 搜尋相關指南
npx modern-web-guidance@latest search "animate a dialog modal backdrop"

# 依 ID 取出一份指南
npx modern-web-guidance@latest retrieve "animate-to-from-top-layer"

這也是 Chrome 推的另一種用法:把它當學習工具。不寫程式的人也能直接去官方指南目錄翻,了解現在的瀏覽器已經內建了哪些功能。

4. 用 legacy-scan 改造舊專案

大部分網站都是累積了好幾年舊寫法的老專案,很少從零開始。1.0 新增的現代化流程可以這樣跑:

npx modern-web-guidance@latest legacy-scan .

或者直接用自然語言叫 agent 做,官方範例是:

Modernize this repository using Modern Web Guidance. Scan our frontend files for legacy patterns, verify the findings, and propose a modernization plan before making any code edits.

它的設計很克制(Modernization workflow 文件):

  • 掃描在本機用語法解析器跑,不呼叫 AI、不花 token
  • 候選規則在約 45,000 個開源專案上分成兩半,一半用來寫規則、調校,另一半當成沒看過的程式碼來驗證;要在沒看過的程式碼上達到靜態比對精準度 80% 以上、經 agent 驗證後 90% 以上,才會預設啟用
  • 目前只涵蓋約 200 份指南中的約 20%,也就是能確定抓得準的那些,之後會擴大
  • 接進 CI/CD 自動化的功能還在開發中

掃描本身不花 token,但後面的步驟仍由 agent 讀上下文、排除誤報、提出修改計畫,所以完整流程還是會用到模型。

如果你問我,這種「先只做抓得準的」的策略是對的。掃描工具一旦每次都噴一堆誤報,工程師很快就會直接無視它。

Chrome DevTools for agents 是什麼?怎麼搭配驗收

Chrome DevTools for agents 是 Chrome 給 AI agent 用的開發者工具,透過 MCP(讓 AI 連接外部工具的標準協定)把一個真的 Chrome 接給 agent 操作。官方強烈建議它跟 Modern Web Guidance 一起用:

  • Modern Web Guidance:在寫之前,給 agent 專家知識
  • Chrome DevTools for agents:在寫之後,讓 agent 打開真的 Chrome,跑效能追蹤、檢查無障礙、錄下動畫、檢查記憶體,確認寫出來的東西真的能用
Modern Web Guidance 負責寫之前的專家指南,Chrome DevTools for agents 負責寫之後的真實瀏覽器驗收
Modern Web Guidance 負責寫之前的專家指南,Chrome DevTools for agents 負責寫之後的真實瀏覽器驗收

想像一下這個工作場景:你請 agent 做一個商品頁的彈窗動畫。它先查 Modern Web Guidance,知道要用原生 dialog 加 CSS 轉場、要尊重「減少動態」設定;寫完之後,再用 DevTools for agents 在模擬的低階手機 CPU 上跑效能追蹤,確認主執行緒沒有被卡超過 50 毫秒,最後錄一段動畫影片自己看一遍。

這就像從「請工讀生照手冊做」,進化到「照手冊做,做完還自己拿量尺驗收」。

Modern Web Guidance 的限制與資料蒐集

兩件事要先講清楚。

第一,指南不保證結果。無障礙專家 Adrian Roselli 在預覽版時期就實測過:用官方首頁的示範 prompt 產出的手風琴元件,動畫在 Firefox 上不能動,也有無障礙錯誤;他也指出 Baseline 並沒有追蹤無障礙功能的支援程度(Adrian Roselli)。1.0 加強了無障礙審查,但「裝了就合規」這種想法還是要避免。

第二,它會匿名蒐集使用資料,包括安裝次數、呼叫的 agent 名稱、agent 下的搜尋字串與取用的指南 ID,官方說不蒐集原始 prompt。想關掉可以在 shell 設定 DISABLE_TELEMETRY=1(GitHub README)。

不寫程式的你,可以做什麼?

對不寫程式的行銷與電商人來說,不必學會這些指令,但要知道該問什麼。

► 第一:問你的工程團隊或外包,AI 寫網頁時有沒有給它指南、有沒有驗收

用不用 AI 已經不是重點,該問的是「AI 寫完誰檢查、用什麼檢查」。MetaMask 那種只掛三行 prompt 的 review bot,門檻其實很低。

► 第二:把 Core Web Vitals 和無障礙放進驗收清單

案例涵蓋 CLS 版面穩定、LCP 圖片載入設定、表單自動填入這些跟轉換直接相關的細節。驗收清單沒列,AI 就比較容易漏掉。

► 第三:舊網站先掃一遍再說

如果你的網站已經好幾年沒大改,請工程師跑一次 legacy-scan,先看看它抓得到哪些舊寫法、哪些值得改。

► 第四:自己去翻指南目錄

挑「表單」和「無障礙」兩類看就好,你會知道現在瀏覽器原生就能做到哪些事,跟外包談需求時更有底氣。

AI 讓「做得出來」變便宜之後,「做得對」反而更值錢,站內vibe coding 都做得出來了,客戶為什麼還要付你錢那篇談的就是同一件事。

結語:寫程式變快之後,品質靠流程守

Chrome 在 1.0 發表文裡講了一句很直白的話:當大家都在用 coding agent,速度就不再是競爭優勢。

以前比的是誰寫得快,現在比的是誰的 AI 寫得對、驗得嚴。

Modern Web Guidance 把資深前端的經驗包成 agent 用得到的手冊,DevTools for agents 給 agent 一雙能在真實瀏覽器裡驗收的眼睛。兩個都是開源、免費。

接下來幾週,Chrome 還預告了 DevTools for agents 的下一個里程碑。整個 AI 原生開發流程正在被重寫,如果你想看全貌,可以搭配這篇 AI 原生 SDLC 是什麼一起讀。

常見問題

Q:Modern Web Guidance 是什麼?

Chrome 推出的開源 skill,裝進 AI coding agent 後,會在 agent 寫網頁前依任務找出相關的專家指南並注入精簡內容,引導它用現代瀏覽器內建的 HTML、CSS 與 Web API,而不是舊寫法。1.0 穩定版於 2026 年 11 月 10 日推出,Chrome、Firefox、Edge 三家瀏覽器團隊與 MDN 共同維護。

Q:Modern Web Guidance 要錢嗎?

Modern Web Guidance 本身免費開源:程式碼以 Apache 2.0 授權,指南內容以 CC BY 4.0 授權,搜尋在本機執行、不需要 API 金鑰。搭配使用的 AI agent 與模型服務,仍依各自方案計費。

Q:Modern Web Guidance 怎麼安裝?

在專案資料夾執行 npx modern-web-guidance@latest install,跟著互動精靈設定即可;原本用 npx 安裝的舊版,升級用 npx modern-web-guidance@latest update。也可以透過 Claude Code、Codex、Cursor、GitHub Copilot、Antigravity 等工具的外掛市集安裝。

Q:Modern Web Guidance 和 Chrome DevTools for agents 差在哪?

Modern Web Guidance 管「寫之前」:給 agent 專家知識與瀏覽器相容性資料。Chrome DevTools for agents 管「寫之後」:讓 agent 在真實 Chrome 裡執行、檢查效能與無障礙、除錯。官方建議兩個一起用。

Q:Modern Web Guidance 支援哪些 AI 工具?

官方列出的外掛市集包括 Claude Code、Codex、Cursor、Antigravity、GitHub Copilot、WebStorm、Kimi Code、Grok Build;也能用 npx skills、gh skill install 安裝。

Q:不寫程式的人可以怎麼用?

可以直接到官方指南目錄翻「表單」「無障礙」等分類,了解瀏覽器現在原生能做到什麼;也可以請工程團隊在 AI 開發流程裡加上指南與驗收,並把 Core Web Vitals、無障礙列進驗收清單。


協作聲明與免責

這篇文章由王董與 AI 一起整理製作完成。文中引用的第三方資料、研究或工具都會標註來源名稱;若原始出處有公開連結,會以 [來源名稱](URL) 形式附上,方便你進一步查找。若文中內容與原始出處有任何出入,請以原文為準。

內容僅供參考與學習交流,不構成任何專業、商業或投資建議,請依自身情況判斷並自行承擔行動風險。文中提及的工具功能、數據與平台政策可能隨時間異動,請以各官方最新公告為準。

Read more