Playwright 測試套件

## 概覽

Playwright Test Stack 是一個專注於協助團隊建構可靠 web-app test workflows 的套件。它結合具韌性的 Playwright test patterns、本機 UI 除錯、瀏覽器記錄、螢幕截圖，以及 selector 指引，讓你能從不穩定的重現案例，帶著證據推進到穩定的 E2E 或 integration test。

## 快速開始

1. 在你的 OpenClaw workspace 中安裝 plugin：
   `npx skillstore add @playwright-test-stack`
2. 建立或編輯匯入 `@playwright/test` 的 `.spec.ts` / `.test.ts` 檔案時，使用 `0xbigboss-playwright-best-practices` / `playwright-best-practices` 來建構具韌性的 locators、Page Object Models、fixtures、web-first assertions，以及 network mocking。
3. 驗證本機 web app 時，使用 `7spade-webapp-testing` / `webapp-testing` 來執行 Playwright checks、擷取瀏覽器螢幕截圖、檢查瀏覽器記錄，並除錯 UI 行為。
4. 當 test 不穩定或大量依賴 selector 時，使用 `c0ntr0lledcha0s-playwright-testing` / `playwright-testing` 取得 Playwright 專用的 E2E 與 integration 指引，涵蓋 selectors、locators，以及 page objects。

## 主要工作流程

- **具韌性的 test 撰寫** — `playwright-best-practices` 協助優先採用穩定的 locators、Page Object Models、fixtures、web-first assertions，以及 network mocking，而不是脆弱的 sleeps 或 CSS chains。
- **本機 web-app 驗證** — `webapp-testing` 聚焦於針對本機 app 執行瀏覽器層級 checks、收集螢幕截圖、讀取 console output，以及診斷 UI 失敗。
- **Selector 與 page-object 除錯** — `playwright-testing` 會在 Playwright config、selectors、locators、page objects，以及位於 `e2e` 或 `tests` 目錄中的 `*.spec.ts` 檔案相關情境下啟用。

## 提示

- 從瀏覽器證據開始：在變更 test 之前，使用 `webapp-testing` 重現問題並收集記錄或螢幕截圖。
- 保持修正有紀律：使用 `playwright-best-practices` 採用 web-first assertions 與穩健的 locator strategy，而不是加入任意 timeouts。
- 重構 page objects 或 integration specs 時，使用 `playwright-testing`，讓 selector 變更持續符合 Playwright conventions。