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

package/bundled/locales/zh-CN/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-CN/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)