create-unit-test

此技能作為 AnySoftKeyboard 軟體工程師的自動化指南，旨在促進穩健單元測試的創建與維護。它旨在確保程式碼變更保持穩定且正常運行，同時避免產生回歸錯誤。該技能嚴格執行專案特定的測試架構，要求開發者遵守標準化的檔案放置、命名慣例，並使用 Robolectric 框架在 JVM 環境中測試 Android 組件。

• 提供明確的測試檔案命名與位置指南，特別鎖定 /src/test/java/ 路徑。

• 引導開發者使用 Arrange-Act-Assert (AAA) 模式編寫測試，提升測試的可讀性與可維護性。

• 要求使用 Robolectric 進行 Android 組件測試，確保資源（如字串與主題）在執行期間能正確解析。

• 鼓勵使用 Fakes 取代 Mocks 或複雜的修補程式，以維持測試的可靠性與確定性。

• 簡化透過 Gradle 執行測試的流程，為不同專案模組提供特定的命令列範本。

• 透過指引開發者前往 Gradle 產生的 XML 測試失敗報告位置，加快除錯速度。

• 專為在 AnySoftKeyboard 程式碼庫中進行錯誤修復、功能開發或重構的開發者設計。

• 在建議實作細節前，先專注於辨識核心功能、邊界情況與錯誤場景。

• 強調所有測試應放置於 test 原始碼集中，不建議將 androidTest 用於一般單元測試，以維持 CI 組建效率。

• 透過引導使用者存取 build/test-results/ 目錄下的失敗日誌，協助解決測試失敗問題。

• 透過執行一致的測試實踐並避免影響儲存庫穩定性的脆弱測試 (flaky tests)，來維持專案品質。