vitest

此技能為使用 Vitest 測試 TypeScript 應用程式提供了結構化的指導。它強調實用的測試哲學，將開發精力集中在具有高價值與高風險的程式碼路徑上，而非追求無意義的覆蓋率指標。此技能協助 AI 編碼代理針對業務邏輯、資料轉換、Zod Schema 與複雜的工具函式編寫強韌的測試，同時提供模擬外部服務與處理非同步操作的清晰模式。它透過標準化的檔案結構、命名慣例與測試資料工廠等輔助函式，推廣測試驅動開發 (TDD) 的工作流程。

• 利用 vi.mock 與 vi.spyOn 實作高效的 Mocking 策略，以隔離測試單元並驗證服務互動。

• 提供測試非同步函式的強大模式，包括錯誤處理、網路請求模擬與基於 Promise 的斷言。

• 包含驗證 Zod Schema 與複雜驗證邏輯的範本，以防止資料完整性回歸。

• 提供定義測試資料工廠的結構化指引，以保持測試套件的整潔與易維護性。

• 配置執行測試的標準 CLI 工作流程，包括監控模式 (Watch mode)、檔案篩選與覆蓋率報告生成。

• 在實作新功能或重構遺留模組時使用此技能，以確保核心穩定性。

• 優先針對驗證函式、複雜業務邏輯以及 bug 成本較高的程式碼編寫測試。

• 略過瑣碎的 Getter、Setter 或透傳函式 (pass-through functions) 的測試，以維持 CI/CD 管線的高效率。

• 務必將測試檔案與原始碼共置 (例如 source.ts 與 source.test.ts)，以提升專案的可發現性與維護性。

• 記得在每個測試週期中使用 beforeEach 與 vi.clearAllMocks 清除 Mock，以避免測試之間的相互干擾。