工具

Front-End Checklist 大改版:把規則打包成 MCP Server,讓 AI Agent 自己跑前端審查

21 萬顆星的老牌前端審查清單 Front-End Checklist 最近重構了一次,整個專案改成 MCP Server 形式,讓 Claude Code、Cursor 這類 AI Agent 能直接呼叫同一套結構化規則做 code review。

字級

Front-End Checklist 在 GitHub 上是個老牌前端專案,多年來一直被當作開源的前端 code review 清單在用。最近一次大改版把它重構成 MCP Server——也就是把同一份規則打包成 AI Agent 可以直接呼叫的結構化端點。

這件事值得聊聊。它解決的問題是:Lighthouse、axe-core、ESLint、Stylelint 各顧一塊,要拼齊 a11y / 效能 / SEO / 安全性 / i18n / 隱私這些面向,一直得自己寫膠水程式碼。而進入 AI Agent 時代,Cursor、Claude Code 這類工具雖然能讀程式碼,卻拿不到結構化的清單——你叫它「check best practices」,它吐出來的是「記得加 alt」,而不是「你的 <label> 缺 for 屬性」。

下面把背景、用法和這次的 MCP 化改動說清楚。

它是什麼

一個開源的前端程式碼審查清單專案,涵蓋 a11y、效能、SEO、安全性、圖片、隱私等面向。每條規則都帶有優先級、說明和修復建議。

歷史上它有三種入口:

  • 網站:打開站台逐條對照
  • GitHub README:直接在儲存庫 README 裡走 checkbox 列表
  • 套件 / CLI:透過 npm 套件或命令列執行

這次改版做了什麼

作者把規則庫拆成了 MCP Server。以 MDX 作為單一事實來源,再用 pnpm 腳本編譯出多端產物:

  • 靜態網站
  • README checkbox 列表
  • MCP Server tool schema(這次新增)

Agent 拿到的不是 markdown 純文字,而是帶有結構化欄位的規則物件——可以依優先級過濾、用規則 ID 引用、掛進編輯器做 inline hint。

怎麼用

接 MCP 的設定(Claude Desktop / Cursor 相容):

{
  "mcpServers": {
    "front-end-checklist": {
      "url": "https://mcp.frontendchecklist.io",
      "transport": "streamable-http"
    }
  }
}

配好之後讓 Agent 呼叫 list_rules 拿分類,再依優先級篩選規則,給出帶規則 ID 的修復建議。

它哪裡好

  • 涵蓋面向比單一工具更全。a11y、效能、SEO、安全性、i18n、隱私都收進同一張表。
  • 規則帶修復動作,不只是「打勾」。每條規則都附上修復程式碼範例和驗證方式。
  • MCP 化走在同類專案前面。比大多數同類專案更早一步把規則變成 agent-consumable。

它哪裡不好

  • 靜態規則無法理解專案上下文。它不知道你用的是 Next.js 13,還是累積五年技術債的 React app。
  • 部分規則偏傳統 HTML 專案,對純 SPA / 現代建置工具鏈涵蓋有限。
  • 全量塞給 Agent 是 token 負擔。需要 Agent 自己挑優先級,使用者 prompt 得明確指定「critical and high-priority first」。
  • 不支援自訂規則權重。

誰適合用

適合的情境:

  • 前端團隊想統一 review 標準——不用再自己寫內部 checklist 文件
  • 給新人 / 外包一份上手清單
  • 做 AI 輔助 code review,想接入結構化規則來源

不適合的情境:

  • 只跑 Lighthouse 就夠用的小專案
  • 純後端 / 行動端

結語

Front-End Checklist 這個專案的思路值得參考:把「人類知識」和「Agent 可消費的形式」統一在單一事實來源。MDX 作為 SSOT,再以 pnpm 腳本編譯出多端產物,算是相當工程的解法。

下一步,如果你的團隊已經在用 Claude Code 或 Cursor 做 review,可以把這個 MCP server 接入 PR 流程——不是要取代人工 review,而是讓機器先把全量規則過一遍,把人 review 的精力留給真正需要判斷的地方。

參考:Front-End Checklist GitHub

來源: https://github.com/thedaviddias/Front-End-Checklist