工具

Chrome 為 Coding Agent 補上現代 Web 開發指南

Chrome 團隊開源 modern-web-guidance,以瀏覽器平台規則引導 Coding Agent 優先採用 CSS.highlights、<dialog> 與 field-sizing。這能減少重複維護前端狀態,也能降低不必要的依賴。

字級

Chrome 開源了 modern-web-guidance,透過瀏覽器平台規則,引導 Coding Agent 少寫 JavaScript、少安裝依賴。這對日常開發的影響很直接:當 Agent 產生前端程式碼時,較少複製舊式彈窗、高亮與表單邏輯。

模型知道 CSS.highlights、<dialog>、showModal() 這些名稱。

但要它修改文字高亮、彈窗或自動增高的輸入框時,仍可能寫出一大段 JavaScript,再順手加上一個依賴。

這並不是模型不會用 API。

比較像是訓練資料中的舊習慣太深。

Google Chrome 團隊開源 modern-web-guidance,目標是為 Coding Agent 補上現代 Web 平台知識。專案摘要寫得很直接:

「We started an effort in Chrome to supplement coding agents with this key domain knowledge.」

它不是新框架,也不是新的執行環境。它比較像一層專為 Agent 設計的領域規則:先告诉 Agent 哪些功能瀏覽器已經具備,再讓它產生程式碼。

模型知道 API,卻不一定會用

Coding Agent 常見的問題不是「不知道」,而是「知道但不用」。

專案觀察到,模型即使知道部分現代 API 的名稱,仍經常不選用平台原生方案,反而沿用既有的 JavaScript 模式。

這與人類開發者的慣性十分相似。

2019 年要處理文字選取樣式,常見做法是監聽 selectionchange、遍歷 DOM 節點,再手動維護高亮狀態。到了 2026 年,瀏覽器早已提供 CSS.highlights,但舊程式碼仍占訓練資料的大多數。

模型進行程式碼補全時,最容易延續的不是「最佳實務」,而是「出現頻率最高的模式」。

因此,我們會看到幾種十分具體的浪費:

  • 文字高亮邏輯散落在多個 JavaScript 回呼中;
  • 模態框自行管理遮罩、關閉按鈕與焦點;
  • textarea 高度仰賴監聽 input、讀取 scrollHeight,再寫回 style.height;
  • 為這些小型功能導入 Popper、Headless UI 或其他依賴。

產生的程式碼確實能執行。

但程式碼更笨重、狀態更多,瀏覽器相容性邊界也更複雜。

Chrome 正在補齊平台領域知識

modern-web-guidance 的定位相當克制:它不會替 Agent 撰寫應用程式,而是補足瀏覽器平台這部分的領域知識。

這一點很重要。

通用模型會寫 React、Vue、Node.js,也熟悉大量 JavaScript 慣用法。但如果缺少足夠明確的平台規則,模型就容易把「可以呼叫 API」與「應該優先使用 API」混為一談。

這個專案採用結構化指南。目錄依領域與具體能力分類,Agent 可以在寫程式碼前讀取相應規則,而不必把整本 API 文件塞進上下文。

它要解決的不是上下文長度問題。

恰恰相反,它試圖改變上下文的內容與優先順序。

過去,替 Agent 追加 API 文件,常見效果只是讓它多知道一些選項。現在,Chrome 團隊嘗試明確寫出「預設選擇」:遇到文字範圍高亮,先考慮 CSS.highlights;遇到模態對話框,先考慮 <dialog> 與 showModal();遇到輸入框自動調整高度,先考慮 field-sizing。

規則比範例更接近限制。

範例告訴 Agent「可以這樣寫」;規則則告訴 Agent「優先這樣寫」。

三項能力,三種程式碼

以下範例取自專案列出的能力方向。它們不是完整框架程式碼,但足以呈現「交給瀏覽器處理」與「自行維護狀態」的差異。

1. 文字範圍高亮

舊模式通常需要自行監聽選取變更、計算範圍、套用樣式,再處理清除作業。

現代方案使用 CSS.highlights,並透過 Highlight 註冊文字範圍:

const highlight = new Highlight();
CSS.highlights.set('search-results', highlight);

const range = document.createRange();
range.selectNodeContents(document.querySelector('#result'));
highlight.add(range);

專案對這項能力的說明是:以 CSS.highlights 實作文字範圍高亮,不必再將相同邏輯散落到各處 JavaScript。

瀏覽器負責維護高亮集合。JavaScript 只需提供範圍,樣式則可放在 CSS 中:

::highlight(search-results) {
  background-color: #fde68a;
  color: #111827;
}

對 Coding Agent 而言,這是一項明確的預設值切換:不是把原本的狀態管理重寫得更漂亮,而是盡可能直接刪除狀態管理。

2. 模態對話框

手寫彈層時,遮罩、捲動鎖定、焦點移動,以及關閉後的焦點恢復,都很容易變成專案中的隱性基礎設施。

HTML 原生方案是 <dialog> 搭配 showModal():

<dialog id="settings-dialog">
  <form method="dialog">
    <h2>Settings</h2>
    <button value="close">Close</button>
  </form>
</dialog>
const dialog = document.querySelector('#settings-dialog');

openButton.addEventListener('click', () => {
  dialog.showModal();
});

專案對這項做法的說明包含兩個具體效益:原生 backdrop,以及更理想的焦點管理。

換言之,遮罩不再需要額外的 div;焦點進入彈窗、限制在模態情境中,以及關閉後的恢復,都有瀏覽器語義可以承接。

Agent 若能在遇到「模態框」時預設選擇 <dialog>,一個小型互動元件便可能從數十行 JavaScript 縮減為幾行呼叫。

3. 自動增高的 textarea

舊程式碼再熟悉不過:監聽 input、讀取 scrollHeight,接著設定高度。

現代 Web 平台提供了 field-sizing:

<textarea rows="3" field-sizing="content"></textarea>

使用者輸入時,textarea 會自動增高。

專案將這項能力概括為:讓 textarea 隨使用者輸入自動增高。

不必監聽 resize,不必快取高度,也不必在框架狀態中保存衍生值。

這個例子最能說明這類指南的價值。它未必讓 Agent 學會全新的架構,只是讓它不要再複製一段存在多年的樣板程式碼。

Agent 缺少的不是上下文

許多人看到 Coding Agent 寫得保守,第一個反應是「再多塞一些現代 JavaScript 教學進去」。

通常,這並不足夠。

因為問題不在於缺少 API 說明,而是預設選擇被舊程式碼壓過了。

模型看過大量 GitHub 專案:其中有些帶著歷史包袱,有些有相容性需求,也有些反映作者個人偏好。模型從統計角度重現這些程式碼,本來就不足為奇。

但若任務是「實作現代 Web 互動」,最佳答案未必是重現最常見的舊實作。

modern-web-guidance 試圖在產生程式碼前,加入由瀏覽器團隊維護的領域限制。受限制的不是語法,而是技術選型:

  • 平台具備原生能力時,優先不重寫 JavaScript;
  • 原生元素足以表達語意時,優先使用語意元素;
  • 平台已處理焦點、尺寸或高亮時,不再維護重複狀態。

這類規則還有一項工程上的優勢:比「請遵循最佳實務」更容易驗收。

你可以檢查產生的程式碼是否仍手寫 textarea 拉伸、是否以 div 模擬 dialog,以及是否為簡單高亮引入依賴。

編輯觀察

這件事之所以重要,不是因為 Chrome 又開源了一個儲存庫,而是平台團隊開始直接維護「給 Coding Agent 的限制層」。過去,框架團隊透過文件、範例與 lint 規則影響程式碼產生;現在,瀏覽器團隊也能將自身的能力邊界編碼成 Agent 可讀取的指南。

我的判斷是,未來有效的 Agent 規則,主要來源不會是更大的模型,而會是更接近執行平台的限制。模型負責撰寫程式碼,平台團隊則負責界定哪些功能不該重新實作。

它與過去不同的地方在於:RAG 通常負責補充事實,指南則要改變預設動作。事實回答「field-sizing 是什麼」,限制則要回答「什麼情況下必須優先使用它」。

不過,成效不能只看規則寫得多漂亮。瀏覽器版本支援、專案相容範圍、框架 hydration 行為,以及真實程式碼庫中的歷史限制,都會影響最終結果。特別是 dialog、Popover API 與 field-sizing 的相容情況,不能以新瀏覽器上的示範取代正式環境驗證。

我會持續關注兩件事:產生程式碼的依賴是否真的下降,以及指南進入 Agent 工作流程後,是否會被專案層級的規則覆蓋。限制是否有用,最終要看它能否減少程式碼,而不只是增加知識。

來源

https://github.com/GoogleChrome/modern-web-guidance

來源: https://github.com/GoogleChrome/modern-web-guidance