generate-e2e-test

generate-e2e-test 技能是一項全面的工程自動化工具，旨在連結使用者定義的工作流程與穩健的測試覆蓋率。它作為一個智慧助手，接收高階功能描述或使用者故事，並將其轉換為生產就緒的 Playwright 測試代碼。透過利用 Playwright MCP 工具，代理程式會在瀏覽器中逐步執行工作流程，即時捕捉狀態、選擇器和互動序列，然後完成測試實作。

此技能適用於需要維持高測試速度且不想手動編寫樣板代碼的軟體工程師與 QA 專業人員。它在自動化回歸測試套件、將手動測試流程轉換為持久的自動化資產，以及確保測試模式在身分驗證、儀表板管理和複雜客戶端功能等不同專案領域中的一致性方面特別有效。

• 使用 Playwright 瀏覽器工具以互動方式執行工作流程，實現精確的狀態捕捉與元素識別。

• 自動提取穩定的選擇器，優先採用基於無障礙存取 (Accessibility) 的策略 (如 role, aria-label) 而非脆弱的 CSS。

• 審查 TESTING.md 與 e2e-utils 中的專案特定測試規範、夾具 (fixtures) 和公用函數，確保生成的代碼遵循既定架構。

• 在最終提交前，透過在環境中執行生成的測試來驗證其正確性，並調試選擇器、時間問題或斷言失敗。

• 根據功能區域（如 admin, auth, workouts）將測試規約放置在適當的子目錄中，以支援結構化的測試組織。

• 始終從導航至目標網址並利用 browser_snapshot 映射應用程式狀態開始。

• 優先使用 tests/e2e/utils/test-helpers.ts 中的助手方法，以維持與現有專案模式的一致性。

• 使用穩健的等待策略 (如 waitForElementWithRetry) 而非靜態延遲，以防止測試不穩定 (flakiness)。

• 處理複雜表單時，使用 browser_fill_form 以提高效率，並始終透過斷言或吐司通知檢查來驗證結果。

• 儘早追蹤會話狀態與驗證要求；若存在身分驗證助手，請將其整合至測試初始化階段。