testing-standards

name	testing-standards
description	測試標準。定義測試策略、命名慣例、覆蓋率要求等。 QA Reviewer agent 應注入此 skill，開發類 agent 可選擇性注入。

Testing Standards 規範

測試策略

• 單元測試：核心業務邏輯、工具函數
• 整合測試：API 端點、資料庫操作
• 元件測試：關鍵 UI 元件的渲染和互動
• E2E 測試：核心用戶流程（視專案規模決定是否需要）

測試框架

• 單元/整合測試：Vitest（優先）或 Jest
• 元件測試：React Testing Library
• E2E 測試：Playwright（如需要）

命名慣例

• 測試檔案：{module}.test.ts 或 {module}.spec.ts
• 測試描述：使用中文或英文皆可，保持一致
• describe：描述被測試的模塊/函數
• it/test：描述預期行為（「should ...」或「當...時，應該...」）

測試結構

describe('模塊名稱', () => {
  describe('函數/方法名稱', () => {
    it('should 預期行為 when 條件', () => {
      // Arrange
      // Act
      // Assert
    })
  })
})

品質標準

• 每個 API 端點至少有 happy path + error path 測試
• 工具函數覆蓋率目標：80%+
• 測試應獨立、可重複執行
• 避免測試實作細節，測試行為和結果
• Mock 外部依賴（API 呼叫、資料庫）

稽核檢查清單

• 測試是否覆蓋完成定義中的所有驗收條件
• 測試是否包含邊界情況
• 測試是否可獨立執行（不依賴外部狀態）
• 測試命名是否清晰描述預期行為
• 是否有不必要的 snapshot 測試

已知注意事項

（由 QA 迭代時追加）

詳細模式參考：references/patterns.md 歷史教訓：references/lessons.md