universal-dev-standards 3.5.1-beta.1 → 3.5.1-beta.11

package/bundled/locales/zh-TW/skills/claude-code/test-coverage-assistant/SKILL.md

@@ -0,0 +1,282 @@
+---
+name: test-coverage-assistant
+description: |
+  使用 7 維度框架評估測試完整性。
+  使用時機：撰寫測試、審查測試覆蓋率、確保測試品質。
+  關鍵字：test coverage, completeness, dimensions, 7 dimensions, test quality, 測試覆蓋, 測試完整性, 七維度。
+source: ../../../../../skills/claude-code/test-coverage-assistant/SKILL.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-01-08
+status: current
+---
+
+# 測試覆蓋助手
+
+> **語言**: [English](../../../../../skills/claude-code/test-coverage-assistant/SKILL.md) | 繁體中文
+
+**版本**: 1.0.0
+**最後更新**: 2025-12-30
+**適用範圍**: Claude Code Skills
+
+---
+
+## 目的
+
+此技能使用 7 維度框架幫助評估和改善測試完整性，確保每個功能都有全面的測試覆蓋。
+
+## 快速參考
+
+### 7 個維度
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│              測試完整性 = 7 個維度                            │
+├─────────────────────────────────────────────────────────────┤
+│  1. 正常路徑        正常預期行為                              │
+│  2. 邊界條件        最小/最大值、限制                         │
+│  3. 錯誤處理        無效輸入、例外狀況                        │
+│  4. 授權驗證        角色存取控制                              │
+│  5. 狀態變更        前後狀態驗證                              │
+│  6. 驗證邏輯        格式、商業規則                            │
+│  7. 整合測試        真實查詢驗證                              │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### 維度摘要表
+
+| # | 維度 | 測試內容 | 關鍵問題 |
+|---|------|----------|----------|
+| 1 | **正常路徑** | 有效輸入 → 預期輸出 | 正常流程是否運作？ |
+| 2 | **邊界條件** | 最小/最大值、限制 | 邊界情況會發生什麼？ |
+| 3 | **錯誤處理** | 無效輸入、找不到資料 | 錯誤如何處理？ |
+| 4 | **授權驗證** | 角色權限 | 誰可以做什麼？ |
+| 5 | **狀態變更** | 前後狀態 | 狀態是否正確變更？ |
+| 6 | **驗證邏輯** | 格式、商業規則 | 輸入是否有驗證？ |
+| 7 | **整合測試** | 真實 DB/API 呼叫 | 查詢真的有效嗎？ |
+
+### 各功能類型需要的維度
+
+| 功能類型 | 需要的維度 |
+|----------|------------|
+| CRUD API | 1, 2, 3, 4, 6, 7 |
+| 查詢/搜尋 | 1, 2, 3, 4, 7 |
+| 狀態機 | 1, 3, 4, 5, 6 |
+| 驗證邏輯 | 1, 2, 3, 6 |
+| 背景作業 | 1, 3, 5 |
+| 外部整合 | 1, 3, 7 |
+
+## 測試設計檢查清單
+
+為每個功能使用此檢查清單：
+
+```
+功能：___________________
+
+□ 正常路徑
+  □ 有效輸入產生預期成功
+  □ 正確的資料被回傳/建立
+  □ 預期的副作用發生
+
+□ 邊界條件
+  □ 最小有效值
+  □ 最大有效值
+  □ 空集合
+  □ 單一項目集合
+  □ 大型集合（如適用）
+
+□ 錯誤處理
+  □ 無效輸入格式
+  □ 缺少必要欄位
+  □ 重複/衝突情況
+  □ 找不到資料情況
+  □ 外部服務失敗（如適用）
+
+□ 授權驗證
+  □ 每個允許的角色已測試
+  □ 每個拒絕的角色已測試
+  □ 未認證存取已測試
+  □ 跨邊界存取已測試
+
+□ 狀態變更
+  □ 初始狀態已驗證
+  □ 最終狀態已驗證
+  □ 所有有效的狀態轉換已測試
+
+□ 驗證邏輯
+  □ 格式驗證（電子郵件、電話等）
+  □ 商業規則驗證
+  □ 跨欄位驗證
+
+□ 整合測試（如 UT 使用萬用字元）
+  □ 查詢述詞已驗證
+  □ 實體關聯已驗證
+  □ 分頁已驗證
+  □ 排序/過濾已驗證
+```
+
+## 詳細指南
+
+完整標準請參考：
+- [測試完整性維度](../../../core/test-completeness-dimensions.md)
+- [測試標準](../../../core/testing-standards.md)
+
+### AI 優化格式（節省 Token）
+
+AI 助手可使用 YAML 格式檔案以減少 Token 使用量：
+- 基礎標準：`ai/standards/test-completeness-dimensions.ai.yaml`
+
+## 範例
+
+### 1. 正常路徑
+
+```csharp
+[Fact]
+public async Task CreateUser_WithValidData_ReturnsSuccess()
+{
+    // Arrange
+    var request = new CreateUserRequest
+    {
+        Username = "newuser",
+        Email = "user@example.com"
+    };
+
+    // Act
+    var result = await _service.CreateUserAsync(request);
+
+    // Assert
+    result.Success.Should().BeTrue();
+    result.Data.Username.Should().Be("newuser");
+}
+```
+
+### 2. 邊界條件
+
+```csharp
+[Theory]
+[InlineData(0, false)]      // 低於最小值
+[InlineData(1, true)]       // 最小有效值
+[InlineData(100, true)]     // 最大有效值
+[InlineData(101, false)]    // 高於最大值
+public void ValidateQuantity_BoundaryValues_ReturnsExpected(
+    int quantity, bool expected)
+{
+    var result = _validator.IsValidQuantity(quantity);
+    result.Should().Be(expected);
+}
+```
+
+### 4. 授權驗證
+
+```csharp
+[Fact]
+public async Task DeleteUser_AsAdmin_Succeeds()
+{
+    var adminContext = CreateContext(role: "Admin");
+    var result = await _service.DeleteUserAsync(userId, adminContext);
+    result.Success.Should().BeTrue();
+}
+
+[Fact]
+public async Task DeleteUser_AsMember_ReturnsForbidden()
+{
+    var memberContext = CreateContext(role: "Member");
+    var result = await _service.DeleteUserAsync(userId, memberContext);
+    result.ErrorCode.Should().Be("FORBIDDEN");
+}
+```
+
+### 5. 狀態變更
+
+```csharp
+[Fact]
+public async Task DisableUser_UpdatesStateCorrectly()
+{
+    // Arrange
+    var user = await CreateEnabledUser();
+    user.IsEnabled.Should().BeTrue();  // 驗證初始狀態
+
+    // Act
+    await _service.DisableUserAsync(user.Id);
+
+    // Assert
+    var updatedUser = await _repository.GetByIdAsync(user.Id);
+    updatedUser.IsEnabled.Should().BeFalse();  // 驗證最終狀態
+}
+```
+
+## 授權矩陣範本
+
+為每個功能建立矩陣：
+
+| 操作 | 管理員 | 經理 | 成員 | 訪客 |
+|------|--------|------|------|------|
+| 建立 | ✅ | ✅ | ❌ | ❌ |
+| 讀取全部 | ✅ | ⚠️ 範圍限制 | ❌ | ❌ |
+| 更新 | ✅ | ⚠️ 僅自己部門 | ❌ | ❌ |
+| 刪除 | ✅ | ❌ | ❌ | ❌ |
+
+每個格子都應該有對應的測試案例。
+
+## 要避免的反模式
+
+- ❌ 只測試正常路徑
+- ❌ 多角色系統缺少授權測試
+- ❌ 沒有驗證狀態變更
+- ❌ 單元測試使用萬用字元但沒有對應的整合測試
+- ❌ 測試資料中 ID 和業務識別碼使用相同值
+- ❌ 測試實作細節而非行為
+
+---
+
+## 設定偵測
+
+此技能支援專案特定設定。
+
+### 偵測順序
+
+1. 檢查 `CONTRIBUTING.md` 中的「測試標準」區段
+2. 檢查程式碼庫中現有的測試模式
+3. 若無找到，**預設使用全部 7 個維度**
+
+### 首次設定
+
+若未找到設定：
+
+1. 建議：「此專案尚未設定測試完整性要求。您要自訂需要哪些維度嗎？」
+2. 建議在 `CONTRIBUTING.md` 中記錄：
+
+```markdown
+## 測試完整性
+
+我們使用 7 維度框架來確保測試覆蓋。
+
+### 各功能類型需要的維度
+- API 端點：全部 7 個維度
+- 工具函式：維度 1, 2, 3, 6
+- 背景作業：維度 1, 3, 5
+```
+
+---
+
+## 相關標準
+
+- [測試完整性維度](../../../core/test-completeness-dimensions.md)
+- [測試標準](../../../core/testing-standards.md)
+- [測試指南](../testing-guide/SKILL.md)
+
+---
+
+## 版本歷史
+
+| 版本 | 日期 | 變更 |
+|------|------|------|
+| 1.0.0 | 2025-12-30 | 初始發布 |
+
+---
+
+## 授權
+
+此技能採用 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授權。
+
+**來源**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)

package/bundled/locales/zh-TW/skills/claude-code/testing-guide/SKILL.md

@@ -0,0 +1,234 @@
+---
+source: skills/claude-code/testing-guide/SKILL.md
+source_version: 1.1.0
+translation_version: 1.1.0
+last_synced: 2025-12-29
+status: current
+name: testing-guide
+description: |
+  Testing pyramid and test writing standards for UT/IT/ST/E2E.
+  Supports ISTQB and Industry Pyramid frameworks.
+  Use when: writing tests, discussing test coverage, test strategy, or test naming.
+  Keywords: test, unit, integration, e2e, coverage, mock, ISTQB, SIT, 測試, 單元, 整合, 端對端.
+---
+
+# 測試指南
+
+> **語言**: [English](../../../../../skills/claude-code/testing-guide/SKILL.md) | 繁體中文
+
+**版本**: 1.1.0
+**最後更新**: 2025-12-29
+**適用範圍**: Claude Code Skills
+
+---
+
+## 目的
+
+本 Skill 提供測試金字塔標準和系統化測試的最佳實踐，支援 ISTQB 和業界通行金字塔框架。
+
+## 框架選擇
+
+| 框架 | 層級 | 適用場景 |
+|-----------|--------|----------|
+| **ISTQB** | UT → IT/SIT → ST → AT/UAT | 企業級、合規性、正式 QA |
+| **業界通行金字塔** | UT (70%) → IT (20%) → E2E (10%) | 敏捷、DevOps、CI/CD |
+
+**整合測試縮寫說明：**
+- **IT** (Integration Testing)：敏捷/DevOps 社群常用
+- **SIT** (System Integration Testing)：企業/ISTQB 環境常用
+- 兩者指的是相同的測試層級
+
+## 快速參考
+
+### 測試金字塔（業界標準）
+
+```
+              ┌─────────┐
+              │   E2E   │  ← 10%（較少、較慢）
+             ─┴─────────┴─
+            ┌─────────────┐
+            │   IT/SIT    │  ← 20%（整合測試）
+           ─┴─────────────┴─
+          ┌─────────────────┐
+          │       UT        │  ← 70%（單元測試）
+          └─────────────────┘
+```
+
+### 測試層級概覽
+
+| 層級 | 範圍 | 速度 | 相依性 |
+|-------|-------|-------|-------------|
+| **UT** | 單一函式/類別 | < 100ms | Mock |
+| **IT/SIT** | 元件互動 | 1-10秒 | 真實資料庫（容器化） |
+| **ST** | 完整系統（ISTQB） | 分鐘級 | 類生產環境 |
+| **E2E** | 使用者旅程 | 30秒+ | 所有真實環境 |
+| **AT/UAT** | 業務驗證（ISTQB） | 視情況 | 所有真實環境 |
+
+### 覆蓋率目標
+
+| 指標 | 最低要求 | 建議值 |
+|--------|---------|-------------|
+| 行覆蓋率 | 70% | 85% |
+| 分支覆蓋率 | 60% | 80% |
+| 函式覆蓋率 | 80% | 90% |
+
+## 詳細指南
+
+完整標準請參考：
+- [測試金字塔](./testing-pyramid.md)
+
+### AI 優化格式（Token 高效）
+
+供 AI 助理使用，請採用 YAML 格式檔案以減少 Token 使用量：
+- 基礎標準：`ai/standards/testing.ai.yaml`
+- 框架選項：
+  - ISTQB 框架：`ai/options/testing/istqb-framework.ai.yaml`
+  - 業界通行金字塔：`ai/options/testing/industry-pyramid.ai.yaml`
+- 測試層級選項：
+  - 單元測試：`ai/options/testing/unit-testing.ai.yaml`
+  - 整合測試：`ai/options/testing/integration-testing.ai.yaml`
+  - 系統測試：`ai/options/testing/system-testing.ai.yaml`
+  - E2E 測試：`ai/options/testing/e2e-testing.ai.yaml`
+
+## 命名慣例
+
+### 檔案命名
+
+```
+[ClassName]Tests.cs       # C#
+[ClassName].test.ts       # TypeScript
+[class_name]_test.py      # Python
+[class_name]_test.go      # Go
+```
+
+### 方法命名
+
+```
+[MethodName]_[Scenario]_[ExpectedResult]()
+should_[behavior]_when_[condition]()
+test_[method]_[scenario]_[expected]()
+```
+
+## 測試替身
+
+| 類型 | 用途 | 使用時機 |
+|------|---------|-------------|
+| **Stub** | 回傳預定義值 | 固定 API 回應 |
+| **Mock** | 驗證互動 | 檢查方法是否被呼叫 |
+| **Fake** | 簡化實作 | 記憶體資料庫 |
+| **Spy** | 記錄呼叫、委派 | 部分 Mock |
+
+### 何時使用
+
+- **UT**: 對所有外部相依使用 mock/stub
+- **IT**: 資料庫使用 fake，外部 API 使用 stub
+- **ST**: 真實元件，僅對外部服務使用 fake
+- **E2E**: 全部使用真實環境
+
+## AAA 模式
+
+```typescript
+test('method_scenario_expected', () => {
+    // Arrange - 設定測試資料
+    const input = createTestInput();
+    const sut = new SystemUnderTest();
+
+    // Act - 執行行為
+    const result = sut.execute(input);
+
+    // Assert - 驗證結果
+    expect(result).toBe(expected);
+});
+```
+
+## FIRST 原則
+
+- **F**ast（快速） - 測試執行快速
+- **I**ndependent（獨立） - 測試之間不互相影響
+- **R**epeatable（可重複） - 每次執行結果相同
+- **S**elf-validating（自我驗證） - 明確的通過/失敗
+- **T**imely（及時） - 與產品代碼一起撰寫
+
+## 應避免的反模式
+
+- ❌ 測試相依（測試必須按順序執行）
+- ❌ 不穩定測試（有時通過、有時失敗）
+- ❌ 測試實作細節
+- ❌ 過度 Mock
+- ❌ 缺少斷言
+- ❌ 魔術數字/字串
+
+---
+
+## 設定偵測
+
+本 Skill 支援專案特定設定。
+
+### 偵測順序
+
+1. 檢查 `CONTRIBUTING.md` 的「停用 Skills」區段
+   - 如果列出此 Skill，則為該專案停用
+2. 檢查 `CONTRIBUTING.md` 的「測試標準」區段
+3. 若未找到，**預設使用標準覆蓋率目標**
+
+### 首次設定
+
+若未找到設定且上下文不清楚時：
+
+1. 詢問使用者：「此專案尚未設定測試標準。您想要自訂覆蓋率目標嗎？」
+2. 使用者選擇後，建議在 `CONTRIBUTING.md` 中記錄：
+
+```markdown
+## Testing Standards
+
+### Coverage Targets
+| Metric | Target |
+|--------|--------|
+| Line | 80% |
+| Branch | 70% |
+| Function | 85% |
+```
+
+### 設定範例
+
+在專案的 `CONTRIBUTING.md` 中：
+
+```markdown
+## Testing Standards
+
+### Coverage Targets
+| Metric | Target |
+|--------|--------|
+| Line | 80% |
+| Branch | 70% |
+| Function | 85% |
+
+### Testing Framework
+- Unit Tests: Jest
+- Integration Tests: Supertest
+- E2E Tests: Playwright
+```
+
+---
+
+## 相關標準
+
+- [測試標準](../../core/testing-standards.md)
+- [程式碼審查檢查清單](../../core/code-review-checklist.md)
+
+---
+
+## 版本歷史
+
+| 版本 | 日期 | 變更內容 |
+|---------|------|---------|
+| 1.1.0 | 2025-12-29 | 新增：框架選擇（ISTQB/業界通行金字塔）、IT/SIT 縮寫說明 |
+| 1.0.0 | 2025-12-24 | 新增：標準區段（目的、相關標準、版本歷史、授權） |
+
+---
+
+## 授權
+
+本 Skill 以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授權發布。
+
+**來源**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)