java-test

Java 測試執行器是一個專業的工程工具，旨在管理 BIC Scoreboard 環境中的 Java 後端測試生命週期。它主要提供給負責驗證後端變更、偵錯測試失敗或確保曲棍球記分板服務完整性的開發人員與軟體代理使用。透過直接與 Gradle 建置系統介接，它能過濾複雜建置輸出的雜訊，專注於識別迴歸問題或功能缺陷所需的關鍵數據。

當在大型多模組專案中運作時，此技能特別有效，因為標準測試輸出通常包含過多的樣板代碼、完整的堆疊追蹤或遮蔽失敗根源的日誌。它採用上下文壓縮策略來最小化 LLM 的 Token 使用量，確保即使對於大型測試套件，測試結果也能保持在可管理的範圍內。

• 使用 ./gradlew test 封裝程式執行專案特定的 Java 測試，並支援目標測試類別執行。

• 實作解析邏輯以去除 ANSI 跳脫序列與 Gradle 建置雜訊，僅呈現必要的失敗報告與測試統計數據。

• 提供自動摘要，包含總測試數、通過/失敗/跳過計數，以及特定的失敗細節（類別.方法名稱與截斷的斷言訊息）。

• 支援與持續整合 (CI) 工作流程及本地開發環境（包括 Windows/WSL 與 Linux）的無縫整合。

• 利用最佳化的執行模式（如 no-daemon 旗標），在容器化或臨時建置環境中保持高可靠性與可重現性。

• 開發人員應在修改 Java 邏輯後的活躍開發週期中呼叫此技能，以確保標準 TestNG 測試與 Selenium 整合測試保持一致。

• 此工具僅限於 Java 測試工作流程，不會取代 Vitest 或 Playwright 等 UI 專用測試執行器。

• 預期輸出結構為狀態更新（PASSED/FAILED）、計數摘要，以及限制前五個錯誤的精簡失敗清單，以便快速修正。

• 在資源受限的環境中，建議使用提供的任務代理方法，或透過指定的 scripts/parse-test-output.py 工具導向輸出，以維持精簡的互動日誌。