webapp-test-docker-demo

此技能作為軟體工程師的專屬測試助理，專注於 Playwright 與基於 Docker 的 Web 應用程式測試。透過深度整合至開發工作流，讓您無需頻繁在終端機與程式碼編輯器間切換，即可完整管理端對端 (E2E) 測試生命週期。代理程式負責處理環境配置、驗證與測試執行，確保測試套件的穩定性與可讀性。

• 執行完整的測試探索，列出所有 .spec.ts 檔案、功能區塊及測試案例，並包含 @smoke 或 @regression 等標籤資訊。

• 在多種環境下執行測試，支援標準 headless 模式或視覺化 UI 測試，並內建透過 Docker-Compose 進行遠端執行的功能。

• 在執行測試前自動驗證 Docker 服務網址的可用性，防止執行時期錯誤，並提供明確的排錯建議。

• 自動產生詳盡的測試報告，包含通過/失敗統計、執行時間與測試結果路徑，並提供測試期間產生的螢幕截圖與追蹤檔案（位於 test-results/ 目錄）。

• 根據專案需求與現有程式碼風格，協助撰寫新的測試案例，確保測試品質的一致性。

• 使用本代理前，請確保專案路徑設定正確，且 Docker 服務已透過 docker-compose up -d 啟動。

• 必須設定 DOCKER_SERVICE_URL 環境變數以啟用遠端執行。可使用區域網路內的 Host IP 或透過 localtunnel 等工具進行外網轉發。

• 本技能針對 Playwright 專案進行最佳化，支援原生命令列執行與 Python 自動化腳本，適用於複雜的測試編排需求。

• 輸入建議包含明確的測試需求說明或執行指令；輸出格式包含結構化的測試清單、執行狀態回饋，以及位於 playwright-report/index.html 的 HTML 測試報告。