universal-dev-standards 4.2.0 → 5.0.0-beta.10

package/bundled/locales/zh-CN/core/test-completeness-dimensions.md

@@ -1,8 +1,8 @@
 ---
 source: ../../../core/test-completeness-dimensions.md
-source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2025-12-30
+source_version: 1.1.0
+translation_version: 1.1.0
+last_synced: 2026-01-24
 status: current
 ---
 
@@ -22,22 +22,23 @@ status: current
 
 ---
 
-## 七个维度
+## 八个维度
 
-完整的测试套件应为每个功能涵盖以下 7 个维度：
+完整的测试套件应为每个功能涵盖以下 8 个维度：
 
 ```
-┌─────────────────────────────────────────────────────────────┐
-│                    测试完整性 = 7 个维度                      │
-├─────────────────────────────────────────────────────────────┤
-│  1. 正向路径          正常预期行为                            │
-│  2. 边界条件          最小/最大值、限制                       │
-│  3. 错误处理          无效输入、例外状况                       │
-│  4. 权限验证          角色存取控制                            │
-│  5. 状态转换          前后验证                                │
-│  6. 验证逻辑          格式、业务规则                          │
-│  7. 集成验证          实际查询验证                            │
-└─────────────────────────────────────────────────────────────┘
+┌──────────────────────────────────────────────────────────────────┐
+│                    测试完整性 = 8 个维度                           │
+├──────────────────────────────────────────────────────────────────┤
+│  1. 正向路径          正常预期行为                                 │
+│  2. 边界条件          最小/最大值、限制                            │
+│  3. 错误处理          无效输入、异常状况                           │
+│  4. 权限验证          角色访问控制                                 │
+│  5. 状态转换          前后验证                                     │
+│  6. 验证逻辑          格式、业务规则                               │
+│  7. 集成验证          实际查询验证                                 │
+│  8. AI 生成质量       AI 测试的有效性评估                          │
+└──────────────────────────────────────────────────────────────────┘
 ```
 
 ---
@@ -415,6 +416,114 @@ public async Task GetActiveUsers_RealDatabase_ReturnsOnlyActiveUsers()
 
 ---
 
+### 8. AI 生成质量
+
+评估 AI 生成测试的有效性和可维护性。
+
+**何时需要**:
+
+当使用 AI 工具（GitHub Copilot、Claude、ChatGPT）生成测试时，需评估其质量。
+
+**评估标准**:
+
+| 标准 | 说明 | 通过条件 |
+|------|------|---------|
+| **意图清晰** | 测试目的明确 | 测试名称描述行为 |
+| **独立性** | 测试互不依赖 | 可单独执行通过 |
+| **断言有效** | 断言验证正确行为 | 非仅检查 "not null" |
+| **边界覆盖** | 含边界案例 | 最小/最大值已测试 |
+| **可读性** | 代码易理解 | 无需注释即可理解 |
+
+**评估范例**:
+
+```csharp
+// ❌ 差：AI 生成的低质量测试
+[Fact]
+public void Test1()
+{
+    var result = _service.Process(null);
+    Assert.NotNull(result);  // 仅检查非空
+}
+
+// ✅ 好：AI 生成的高质量测试
+[Fact]
+public void Process_WithEmptyInput_ReturnsEmptyResult()
+{
+    // Arrange
+    var input = Array.Empty<Item>();
+
+    // Act
+    var result = _service.Process(input);
+
+    // Assert
+    result.Should().BeEmpty();
+    result.ProcessedAt.Should().BeCloseTo(DateTime.UtcNow, TimeSpan.FromSeconds(1));
+}
+```
+
+**AI 测试反模式**:
+
+| 反模式 | 问题 | 修正 |
+|--------|------|------|
+| 仅检查非空 | 无实际验证 | 断言具体值 |
+| 硬编码魔术值 | 难以维护 | 使用常量或工厂 |
+| 测试名称如 `Test1` | 无法理解意图 | 使用描述性名称 |
+| 无边界案例 | 覆盖不完整 | 加入边界测试 |
+
+---
+
+## Mutation Testing
+
+### 概念
+
+Mutation Testing 通过在代码中引入小变异（mutations）来评估测试质量。如果测试套件未能检测到变异，表示测试不够强健。
+
+### 变异操作符
+
+| 操作符 | 原始 | 变异 |
+|--------|------|------|
+| 关系运算符 | `>` | `>=`, `<`, `==` |
+| 算术运算符 | `+` | `-`, `*` |
+| 逻辑运算符 | `&&` | `\|\|` |
+| 返回值 | `return x` | `return null` |
+| 条件边界 | `i < 10` | `i <= 10` |
+
+### 工具推荐
+
+| 语言 | 工具 | 链接 |
+|------|------|------|
+| JavaScript/TypeScript | Stryker | stryker-mutator.io |
+| Java | PIT | pitest.org |
+| C# | Stryker.NET | stryker-mutator.io/docs/stryker-net |
+| Python | mutmut | github.com/boxed/mutmut |
+
+### 结果解读
+
+| 指标 | 意义 | 目标 |
+|------|------|------|
+| 杀死的变异 | 测试检测到变异 | 越高越好 |
+| 存活的变异 | 测试未检测到 | 需要加强测试 |
+| 变异分数 | 杀死数 / 总数 | > 80% |
+
+### 范例配置 (Stryker)
+
+```json
+{
+  "stryker": {
+    "mutate": ["src/**/*.ts", "!src/**/*.spec.ts"],
+    "testRunner": "jest",
+    "reporters": ["html", "clear-text"],
+    "thresholds": {
+      "high": 80,
+      "low": 60,
+      "break": 50
+    }
+  }
+}
+```
+
+---
+
 ## 测试案例设计清单
 
 使用此清单检核每个功能的完整性：
@@ -462,6 +571,12 @@ public async Task GetActiveUsers_RealDatabase_ReturnsOnlyActiveUsers()
   □ 实体关联已验证
   □ 分页已验证
   □ 排序/筛选已验证
+
+□ AI 生成质量（如使用 AI 生成测试）
+  □ 测试意图清晰
+  □ 断言验证具体值
+  □ 包含边界案例
+  □ 测试名称描述行为
 ```
 
 ---
@@ -489,12 +604,14 @@ public async Task GetActiveUsers_RealDatabase_ReturnsOnlyActiveUsers()
 
 | 功能类型 | 必需维度 |
 |---------|---------|
-| 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 |
+| CRUD API | 1, 2, 3, 4, 6, 7, 8* |
+| 查询/搜索 | 1, 2, 3, 4, 7, 8* |
+| 状态机 | 1, 3, 4, 5, 6, 8* |
+| 验证 | 1, 2, 3, 6, 8* |
+| 后台任务 | 1, 3, 5, 8* |
+| 外部集成 | 1, 3, 7, 8* |
+
+*维度 8 仅在使用 AI 生成测试时适用
 
 ---
 
@@ -511,9 +628,13 @@ public async Task GetActiveUsers_RealDatabase_ReturnsOnlyActiveUsers()
 
 ❌ 单元测试使用万用匹配器但无对应集成测试
 
-❌ 测试资料的 ID 与业务识别码使用相同值
+❌ 测试数据的 ID 与业务标识码使用相同值
 
-❌ 测试实作细节而非行为
+❌ 测试实现细节而非行为
+
+❌ 盲目信任 AI 生成的测试而不审查
+
+❌ AI 测试仅检查非空而无具体断言
 ```
 
 ---
@@ -531,10 +652,20 @@ public async Task GetActiveUsers_RealDatabase_ReturnsOnlyActiveUsers()
 
 | 版本 | 日期 | 变更 |
 |------|------|------|
+| 1.1.0 | 2026-01-24 | 新增：第 8 维度 AI 生成质量、Mutation Testing 章节 |
 | 1.0.0 | 2025-12-24 | 初始发布，包含 7 维度框架 |
 
 ---
 
+## 参考资料
+
+- [ISTQB AI Testing Guidelines](https://www.istqb.org/) - 软件测试认证
+- [Stryker Mutator](https://stryker-mutator.io/) - JavaScript/TypeScript Mutation Testing
+- [PIT Mutation Testing](https://pitest.org/) - Java Mutation Testing
+- [Mutation Testing 概念](https://en.wikipedia.org/wiki/Mutation_testing) - Wikipedia
+
+---
+
 ## 授权
 
 本标准以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授权发布。

package/bundled/locales/zh-CN/core/test-driven-development.md

@@ -1,18 +1,19 @@
 ---
 source: ../../../core/test-driven-development.md
-source_version: 1.1.0
-translation_version: 1.1.0
-last_synced: 2026-01-12
+source_version: 1.2.0
+translation_version: 1.2.0
+last_synced: 2026-01-25
 status: current
 ---
 
 # 测试驱动开发 (TDD) 标准
 
-**版本**: 1.1.0
-**最后更新**: 2026-01-12
-**适用范围**: 所有采用测试驱动开发的专案
+**版本**: 1.2.0
+**最后更新**: 2026-01-25
+**适用范围**: 所有采用测试驱动开发的项目
+**范围**: universal
 
-> **语言**: [English](../../../core/test-driven-development.md) | 繁体中文
+> **语言**: [English](../../../core/test-driven-development.md) | [繁體中文](../../zh-TW/core/test-driven-development.md)
 
 ---
 
@@ -29,6 +30,58 @@ status: current
 
 ---
 
+## 方法论分类
+
+> **分类**: 传统开发方法论 (1999-2011)
+
+TDD 是**传统测试驱动开发家族**的一部分，源自极限编程 (XP) 和敏捷实践。它不同于 **AI 时代 SDD (规格驱动开发)** 方法论。
+
+### 历史背景
+
+| 方法论 | 时代 | 起源 | 关注点 |
+|-------------|-----|--------|-------|
+| **TDD** | 1999 | Kent Beck, XP | 测试驱动代码设计 |
+| **BDD** | 2006 | Dan North | 行为驱动测试 |
+| **ATDD** | 2003-2006 | GOOS, Gojko Adzic | 验收驱动开发 |
+| **SDD** | 2025+ | Thoughtworks, Martin Fowler | 规格驱动生成 (AI 时代) |
+
+### 与 SDD 的关系
+
+TDD 可以**在 SDD 实施阶段内**使用，但不是 SDD 方法论本身的一部分：
+
+```
+┌──────────────────────────────────────────────────────────────┐
+│                    方法论关系                                   │
+├──────────────────────────────────────────────────────────────┤
+│                                                              │
+│   SDD 工作流程:                                              │
+│   提案 → 审查 → [实施] → 验证        │
+│                             ↑                                │
+│                     TDD 可在此处使用                     │
+│                     (可选，非必需)                 │
+│                                                              │
+│   传统双循环 TDD (GOOS):                        │
+│   BDD (外层) → TDD (内层)                                  │
+│                                                              │
+│   SDD 通过正向推导生成测试工件,                        │
+│   TDD 然后可用作起点。                  │
+│                                                              │
+└──────────────────────────────────────────────────────────────┘
+```
+
+### 何时使用 TDD
+
+| 上下文 | 建议 |
+|---------|----------------|
+| **SDD 项目** | 在实施阶段使用 TDD (可选) |
+| **遗留项目** | 对新功能和错误修复使用 TDD |
+| **非 AI 开发** | 将 TDD 作为主要方法论 |
+| **性能关键代码** | 使用 TDD 确保算法正确性 |
+
+**参考**: [规格驱动开发标准](spec-driven-development.md)
+
+---
+
 ## 目录
 
 1. [TDD 核心循环](#tdd-核心循环)
@@ -272,6 +325,9 @@ Robert C. Martin (Uncle Bob) 用三条严格的规则定义 TDD：
 │   需求层       ATDD - 验收测试驱动开发                           │
 │               （接收业务验收标准）                                │
 │                        ↓                                        │
+│   规格层       SDD - 规格驱动开发                                │
+│               （正式规格、验收条件）                              │
+│                        ↓                                        │
 │   功能层       BDD - 行为驱动开发                                │
 │               （场景 → Step Definitions）                        │
 │                        ↓                                        │
@@ -280,7 +336,7 @@ Robert C. Martin (Uncle Bob) 用三条严格的规则定义 TDD：
 │                        ↓                                        │
 │   集成层       集成与系统测试                                     │
 │                                                                 │
-│   关键：ATDD → BDD → TDD → 集成测试（自上而下流程）              │
+│   关键：ATDD → SDD → BDD → TDD → 集成测试（自上而下）            │
 │                                                                 │
 └─────────────────────────────────────────────────────────────────┘
 ```
@@ -613,15 +669,9 @@ test('should reject password exceeding max length', () => {
 
 ### 测试边界情况
 
-确保测试涵盖 [测试完整性维度](test-completeness-dimensions.md) 的所有七个维度：
+确保测试涵盖 [测试完整性维度](test-completeness-dimensions.md) 定义的所有八个维度。这些维度包括：快乐路径、边界条件、错误处理、授权、状态变化、验证、集成，以及 AI 生成质量（适用时）。
 
-1. **快乐路径** - 正常预期行为
-2. **边界条件** - 最小/最大值、限制
-3. **错误处理** - 无效输入、例外
-4. **授权** - 角色为基础的存取控制
-5. **状态变化** - 前后验证
-6. **验证** - 格式、业务规则
-7. **集成** - 真实查询验证
+请使用该文件中的检查清单来验证每个功能的覆盖率。
 
 ---
 
@@ -885,7 +935,7 @@ test('should send confirmation email after successful payment', async () => {
 ## 语言/框架实践
 
 详细的语言特定 TDD 范例，请参阅 TDD Assistant skill：
-- [语言范例](../skills/claude-code/tdd-assistant/language-examples.md)
+- [语言范例](../skills/tdd-assistant/language-examples.md)
 
 ### 依语言快速参考
 
@@ -955,7 +1005,7 @@ test('should send confirmation email after successful payment', async () => {
 ## 相关标准
 
 - [测试标准](testing-standards.md) - 核心测试标准（UT/IT/ST/E2E）（或使用 `/testing-guide` 技能）
-- [测试完整性维度](test-completeness-dimensions.md) - 7 维度框架
+- [测试完整性维度](test-completeness-dimensions.md) - 8 维度框架
 - [规格驱动开发](spec-driven-development.md) - SDD 工作流程
 - [程序码入库标准](checkin-standards.md) - 入库要求
 - [程序码审查检查清单](code-review-checklist.md) - 审查指南
@@ -988,8 +1038,9 @@ test('should send confirmation email after successful payment', async () => {
 
 ## 版本历史
 
-| 版本 | 日期 | 变更 |
-|------|------|------|
+| 版本 | 日期 | 变更内容 |
+|------|------|----------|
+| 1.2.0 | 2026-01-25 | 新增：方法论分类章节，明确 TDD 与 SDD 的关系、历史背景、使用上下文 |
 | 1.1.0 | 2026-01-12 | 新增：完整代码异味目录（22+ 种异味分 5 类，基于 Martin Fowler《Refactoring》第二版）、代码异味检测检查清单 |
 | 1.0.0 | 2026-01-07 | 初始 TDD 标准定义 |
 

package/bundled/locales/zh-CN/core/testing-standards.md

@@ -1,8 +1,8 @@
 ---
 source: ../../../core/testing-standards.md
-source_version: 2.2.0
-translation_version: 2.2.0
-last_synced: 2026-01-20
+source_version: 3.0.0
+translation_version: 3.0.0
+last_synced: 2026-02-10
 status: current
 ---
 
@@ -249,7 +249,7 @@ tests/
 
 ## 相关标准
 
-- [代码审查指南](code-review-guide.md)
+- [代码审查指南](code-review-checklist.md)
 - [测试完整性维度](test-completeness-dimensions.md)
 
 ---

package/bundled/locales/zh-CN/core/versioning.md

@@ -6,7 +6,7 @@ last_synced: 2026-01-08
 status: current
 ---
 
-> **语言**: [English](../../../core/versioning.md) | [简体中文](../zh-TW/core/versioning.md) | 简体中文
+> **语言**: [English](../../../core/versioning.md) | [简体中文](../../zh-TW/core/versioning.md) | 简体中文
 
 # 语义化版本标准