Communitygithub.com

rhpxgr8pzm-max/claude-skills

執行自動化的部署後 UI 驗證,包含瀏覽器自動化 MCP(claude-in-chrome、Playwright 或 Puppeteer):主控台錯誤與 Core Web Vitals 煙霧測試、表單與認證流程互動測試、三個斷點下的截圖視覺回歸、以及 axe-core 無障礙審計,最後產出 SHIP / DO-NOT-SHIP 的結論。

claude-skills 是什麼?

此技能為一個功能完整的瀏覽器品質保證自動化工具,能在部署後或程式碼審查前,對前端頁面進行全面的 UI 驗證。它支援多種瀏覽器自動化 MCP(如 claude-in-chrome、Playwright、Puppeteer),並以四個階段進行測試:第一階段煙霧測試檢查主控台錯誤、網路請求與 Core Web Vitals 指標;第二階段互動測試驗證導航連結、表單提交與認證流程;第三階段視覺回歸測試針對三個斷點進行截圖比對;第四階段無障礙審計則使用 axe-core 檢查 WCAG 2.2 AA 規範。最終輸出包含明確的 SHIP / SHIP WITH FIXES / DO NOT SHIP 結論。此工具特別適合在開發者將前端變更部署至預覽或暫存環境後、審查前端相關 PR 時、或需要確保響應式佈局與無障礙性時使用。它預設為唯讀模式,以避免對生產環境造成意外影響,並要求使用測試憑證而非真實的生產登入資訊。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/rhpxgr8pzm-max/claude-skills/tree/HEAD/plugins/tally-dev/skills/browser-qa

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Browser QA — 自動化視覺測試與互動

使用時機

  • 將功能部署到暫存/預覽環境之後
  • 需要跨頁面驗證 UI 行為時
  • 出貨前 — 確認佈局、表單、互動的實際運作
  • 審查涉及前端程式碼的 PR 時
  • 無障礙審計與響應式測試

運作方式

使用瀏覽器自動化 MCP(claude-in-chrome、Playwright 或 Puppeteer)像真實使用者一樣與線上頁面互動。

安全第一 — 爆炸半徑(預設唯讀執行)

Browser QA 會驅動真實的認證與使用者流程,因此需明確處理爆炸半徑。 預設為唯讀:絕不對生產 URL 執行會變更狀態的流程(結帳、付款、刪除、大量更新)— 需要明確的選擇加入以及暫存/預覽 URL。使用種子測試憑證,切勿使用真實的生產登入資訊,並在儲存任何螢幕截圖前遮罩憑證/令牌/PII。

階段 1:煙霧測試

1. 導航至目標 URL
2. 檢查主控台錯誤(過濾雜訊:分析工具、第三方)
3. 確認網路請求中無 4xx/5xx
4. 在桌面與行動裝置視埠擷取網頁首屏截圖
5. 檢查 Core Web Vitals:LCP < 2.5s、CLS < 0.1、INP < 200ms
   (INP 於 2024 年 3 月取代 FID;閾值依 web.dev 規範)

階段 2:互動測試

1. 點擊每個導航連結 — 確認無死連結
2. 使用有效資料提交表單 — 確認成功狀態
3. 使用無效資料提交表單 — 確認錯誤狀態
4. 測試認證流程:登入 → 受保護頁面 → 登出(僅使用測試憑證,絕不使用正式帳號)
5. 測試關鍵使用者旅程(結帳、入職引導、搜尋)
   — 預設唯讀;僅在明確選擇加入且針對暫存環境時,才執行會變更狀態的流程
     (參見上方「安全第一」)

階段 3:視覺回歸

1. 在 3 個斷點(375px、768px、1440px)擷取關鍵頁面的螢幕截圖
2. 與已提交的基準螢幕截圖進行比較
   — 無基準 ⇒ 回報「無法判斷」,切勿無聲通過
3. 標記超過 5px 的佈局位移、遺失元素、超出範圍
4. 檢查深色模式(如適用)

階段 4:無障礙性

1. 在每個頁面上執行 axe-core 或同等工具
2. 標記 WCAG 2.2 AA 違規(對比度、標籤、焦點順序)
3. 驗證鍵盤導航能完整運作
4. 檢查螢幕閱讀器地標

注意:axe-core 自動涵蓋 WCAG 約 30–40%。檢測通過是必要但不充分條件 — 鍵盤導航、焦點順序與螢幕閱讀器測試仍需手動檢查。請勿僅因自動檢測通過就回報「可無障礙存取」。

輸出格式

## QA 報告 — [URL] — [時間戳]

### 煙霧測試
- 主控台錯誤:0 個重大錯誤,2 個警告(分析工具雜訊)
- 網路:全部 200/304,無失敗
- Core Web Vitals:LCP 1.2s ✓、CLS 0.02 ✓、INP 89ms ✓

### 互動
- [✓] 導航連結:12/12 正常運作
- [✗] 聯絡表單:無效電子郵件遺失錯誤狀態
- [✓] 認證流程:登入/登出正常運作

### 視覺
- [✗] Hero 區塊在 375px 視埠下超出範圍
- [✓] 深色模式:所有頁面一致

### 無障礙性
- 2 項 AA 違規:Hero 圖片缺少替代文字、頁尾連結對比度不足

### 結論:附修正出貨(2 個問題,0 個阻擋)
# 結論 ∈ 出貨 / 附修正出貨 / 不出貨;若無視覺基準則使用「無法判斷」

整合方式

可搭配任何瀏覽器 MCP:

  • mChild__claude-in-chrome__* 工具(首選 — 使用您的實際 Chrome)
  • 透過 mcp__browserbase__* 使用 Playwright
  • 直接使用 Puppeteer 腳本

可與 /canary-watch 搭配,用於部署後監控。

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

相關技能