Modern Web Guidance 教學手冊
Modern Web Guidance 教學手冊 Modern Web Guidance AI Agent 現代化 Web 開發實戰教學手冊 建立 AI Coding Agent 的現代 Web Platform 知識、瀏覽器最佳實踐、相容性治理與企業級開發能力 適用對象:Frontend/Full-Stack Engineer、SA、Software Architect、QA、PM、AI Agent Engineer、DevSecOps 文件性質:企業內部開發規範與教育訓練教材(偏「實戰與維運」) 版本基準:npm modern-web-guidance 1.0.1(2026-11-16 發布;發行 repo GoogleChrome/modern-web-guidance tag v1.0.1 = commit 64a6d70);原始碼 repo GoogleChrome/modern-web-guidance-src 追蹤至 main e8feb43(2026-11-18) 實測環境:Windows 11、Node.js 24.16.0、npm 11.13.0、Git Bash、Google Chrome 158、Claude Code 2.1.328、web-features 3.46.0、Vue 3.5.45、Vite 8.3.8、Playwright 1.65.1 查證日期:2026-11-19 重要聲明 Modern Web Guidance 不是 AI Coding Agent,也不是 MCP Server。 它是一組 Agent Skill(SKILL.md+指南 Markdown)加上一支本機 CLI(search/retrieve/list/legacy-scan)。Agent 讀到 Skill 說明後,自己呼叫 CLI 把指南拉進 context。官方技術文章明確說明「為什麼是 CLI skill 而不是 MCP server」(第 3.6 節)。 它只提供知識,不會替你寫程式、改程式或做架構還原。 逆向工程、Framework 升級、測試與 Code Review 仍要靠 Agent、工具與人。本手冊會把每一項能力標示成「官方功能」或「企業自建/建議流程」,請勿混用。 CLI 預設開啟遙測。 會送出 Agent 名稱、guide ID、Agent 產生的搜尋詞到 Google(play.googleapis.com),不含原始 prompt 與程式碼。金融業環境請先讀第 4.9 節,統一設定 DISABLE_TELEMETRY=1。 版本變動很快。 1.0.0(2026-11-10)到 1.0.1(2026-11-16)只隔 6 天,Skill 預設以 npx -y modern-web-guidance@latest 執行,等於每次都抓最新版。本手冊所有輸出都以 1.0.1 為準;升級前請照第 17 章重新驗證。 本手冊不是官方文件的翻譯。 內容是依 npm 套件、發行 repo、原始碼 repo(src/cli、src/rag、src/core、src/analyzing)與 developer.chrome.com 官方文件重新查證,再加上企業導入做法、實測工具與案例。 案例皆為教學用虛構情境。 「貸款入口網站」「貸款案件管理」「ACME Bank」等名稱與資料都不是真實專案。 實測範圍要先看清楚。 已實測:CLI 全部指令(含未寫在 README 的 set-baseline)、.mwgrc 閘門 7 種情境、legacy-scan 3 個樣本專案、install 在隔離目錄安裝到 Claude Code、8 支企業自建工具(20 個測試、8 個突變測試全部被抓到、本機 CI 模擬 2 情境、搜尋回歸 13 案例)、Vue 3 範例(vue-tsc、vite build、Playwright 11 個 E2E 含 fallback 路徑與 axe)。未實測:各 Agent 實際載入 Skill 後的行為(未以付費帳號跑 Agent)、Copilot/Codex/Cursor/Gemini/Antigravity 的 plugin 安裝、GitHub Actions 實跑、Safari 與 Firefox 實機。未實測的內容標 🧪。 AI 產出一律要人工驗證。 官方評測數據(第 1.14 節)是 Google 在自家測試應用上量到的,不代表你的專案會得到同樣結果。 閱讀約定 來源標示 全書在句末或表格中使用下列標示。凡標示為「企業自建」或「建議流程」的內容都不是 Modern Web Guidance 官方功能,請勿在簡報或對外文件中寫成官方保證。 ...