kld-sdd 2.6.0 → 2.6.2

package/templates/skills/kld-sdd/opsx-tdd-quality/rules/general/no-logic-in-tests.md

@@ -0,0 +1,30 @@
+# 测试中不要放逻辑
+
+> 影响等级：HIGH
+
+## 核心原则
+
+**KISS > DRY** — 在测试中，简单性比避免重复更重要。
+
+## 禁止的模式
+
+- 循环：`for (int i = 0; i < users.size(); i++) { assertThat(...) }`
+- 条件：`if (response.isSuccessful()) { assertThat(...) }`
+- 字符串拼接：`assertThat(result).isEqualTo("Hello, " + userName + "!")`
+- 计算：`assertThat(total).isEqualTo(price * quantity + tax)`
+
+## 正确做法
+
+- 使用字面值——`assertThat(result).isEqualTo("Hello, John!")`
+- 预计算的期望值——`int expectedTotal = 115;`
+- 用 `assertThat(users).extracting(User::isActive).containsOnly(true)` 代替循环
+
+## 逻辑隐藏 Bug 的经典案例
+
+```java
+// 错误：字符串拼接隐藏了 bug（结果为 "//u/0/photos"）
+assertThat(photosPageUrl).isEqualTo(baseUrl + "/u/0/photos");
+
+// 正确：字面值让 bug 显而易见
+assertThat(actualUrl).isEqualTo("http://photos.google.com/u/0/photos");
+```

package/templates/skills/kld-sdd/opsx-tdd-quality/rules/general/one-test-one-scenario.md

@@ -0,0 +1,23 @@
+# 一测一场景
+
+> 影响等级：HIGH
+
+## 核心规则
+
+每个测试只验证一个特定场景。多个场景混在一个测试中会导致失败难以诊断。
+
+## 反模式信号
+
+- 测试名包含 "and"（如 `testDepositAndWithdraw`）
+- 多个 "When" 或 "Act" 段
+- 断言之间有状态变化
+- 难以简洁命名
+- 测试超过 10-15 行
+
+## 多断言何时可以
+
+当验证**同一个行为**的多个属性时可以。例如验证用户创建行为时，同时断言 id 不为 null、email 正确、name 正确、createdAt 不为 null——这些都是验证"用户创建"这一个行为。
+
+## 拆分判断标准
+
+问自己"如果这个测试失败，我能确切知道哪个场景坏了吗？"如果不能，就拆分。

package/templates/skills/kld-sdd/opsx-tdd-quality/rules/general/parameterized-testing.md

@@ -0,0 +1,56 @@
+# 参数化测试指导
+
+> 影响等级：MEDIUM
+> 引用方：opsx-tdd-quality/SKILL.md §7
+
+## 适用场景
+
+参数化测试适用于**同一行为、不同输入组合**的场景，减少重复代码。
+
+## 何时使用
+
+✅ **适合参数化**：
+- 同一方法的多个输入-输出组合（如不同角色的登录测试）
+- 边界值测试（如分页参数 page=0/1/100）
+- 枚举值覆盖（如 status=borrowed/returned）
+
+❌ **不适合参数化**：
+- 不同行为点（如 create 和 list 应分开，不用参数化）
+- 异常路径与正常路径混合（断言类型不同）
+- 测试间有状态依赖
+
+## Java 示例（JUnit 5）
+
+```java
+@ParameterizedTest
+@CsvSource({
+    "admin, admin, true",
+    "user, user, true",
+    "admin, user, false",
+    "user, admin, false"
+})
+void login_roleMatching_returnsCorrectResult(String userRole, String requestRole, boolean shouldSucceed) {
+    // Given
+    User user = new User();
+    user.setRole(userRole);
+    when(userRepository.findByUsername(any())).thenReturn(Optional.of(user));
+    
+    if (shouldSucceed) {
+        // When
+        LoginResponse response = authService.login("test", "Pass1234", requestRole);
+        // Then
+        assertNotNull(response);
+    } else {
+        // When & Then
+        assertThrows(BusinessException.class,
+            () -> authService.login("test", "Pass1234", requestRole));
+    }
+}
+```
+
+## 注意事项
+
+- 参数化测试仍需遵循 Given-When-Then 结构
+- 每个参数组合应能独立理解
+- 参数化测试不替代独立的行为点测试
+- 参数行中避免逻辑（如 `if` 判断应放在测试方法内，不在参数中编码逻辑）

package/templates/skills/kld-sdd/opsx-tdd-quality/rules/general/prefer-public-apis.md

@@ -0,0 +1,17 @@
+# 优先测试公共 API
+
+> 影响等级：HIGH
+
+## 核心规则
+
+测试代码的公共接口。私有方法和实现细节类应通过公共 API 间接测试。
+
+## 何时可以直接测试私有/内部类
+
+1. 被多个公共 API 复用——已成为公共契约的一部分
+2. 足够复杂需要隔离——但考虑是否应该提取为独立类
+3. 第三方集成——包装外部库的适配器
+
+## 重构自由
+
+测试公共 API 意味着重构内部实现时测试不需要改变。

package/templates/skills/kld-sdd/opsx-tdd-quality/rules/general/test-behaviors-not-methods.md

@@ -0,0 +1,26 @@
+# 测试行为而非方法
+
+> 影响等级：HIGH
+
+## 核心思想
+
+围绕行为（系统做什么）组织测试，而非围绕方法（怎么实现）。
+
+## 识别行为
+
+问"这个操作的可观察效果是什么？"
+
+以 `resetPassword()` 为例：
+- 用户密码被清空 → 独立测试
+- 用户收到邮件 → 独立测试
+- 重置计数器递增 → 独立测试
+
+## 一个行为可以有多个断言
+
+验证邮件通知行为时，可以同时断言收件人、标题、正文——都是关于"邮件"这一个行为。
+
+## 命名模式
+
+以行为命名而非方法名：
+- ✅ `resetPassword_clearsPassword`
+- ❌ `testResetPassword`

package/templates/skills/kld-sdd/opsx-tdd-quality/rules/java/argument-matching.md

@@ -0,0 +1,38 @@
+# Mockito 参数匹配
+
+> 影响等级：HIGH
+
+## 核心规则
+
+- **禁止**对 DTO/模型对象使用 `any(...)` 进行 stub 或 verify
+- 必须用 `ArgumentCaptor` 捕获真实参数并断言相关字段
+
+## `any()` 可接受的场景
+
+- 原始类型且精确值不影响测试
+- 简单类型（String、Integer）且焦点在其他行为
+- 仅验证方法被调用（存在性检查）
+
+## ArgumentCaptor 最佳实践
+
+```java
+@Captor
+private ArgumentCaptor<Order> orderCaptor;
+
+@Test
+void create_validInput_savesOrder() {
+    // When
+    orderService.create(orderDTO);
+    // Then
+    verify(repository).save(orderCaptor.capture());
+    Order saved = orderCaptor.getValue();
+    assertThat(saved.getName()).isEqualTo("Test Order");
+}
+```
+
+## 验证多次调用
+
+```java
+verify(repository, times(2)).save(captor.capture());
+List<Order> saved = captor.getAllValues();
+```

package/templates/skills/kld-sdd/opsx-tdd-quality/rules/java/controller-test-rules.md

@@ -0,0 +1,37 @@
+# 控制器测试规则
+
+> 影响等级：HIGH
+
+## 核心规则
+
+使用 `@WebMvcTest` 进行隔离的 web 层测试。**禁止**使用 `@SpringBootTest` 做控制器单元测试。
+
+## 关键注解
+
+| 注解 | 用途 |
+|------|------|
+| `@WebMvcTest(Controller.class)` | 只加载指定控制器的 web 层 |
+| `@MockitoBean` | 创建 Mockito mock 并注册到 Spring 上下文（Spring Boot 3.4+） |
+| `@MockBean` | Spring Boot < 3.4 的替代 |
+| `@Autowired MockMvc` | 注入 MockMvc 实例 |
+
+## 控制器测试范围
+
+1. 请求映射：正确的 URL、HTTP 方法、Content-Type
+2. 请求验证：`@Valid`/`@Validated` 触发验证
+3. 响应状态码：200、201、400、401、403、404 等
+4. 响应体：通过 `jsonPath()` 断言 JSON 结构
+5. 路径变量和查询参数：正确绑定
+6. 异常处理：`@ControllerAdvice`/`@ExceptionHandler` 响应
+
+## 安全注解测试
+
+```java
+@Test
+@WithMockUser(roles = "ADMIN")
+void getUsers_asAdmin_returns200() throws Exception { ... }
+
+@Test
+@WithMockUser(roles = "USER")
+void getUsers_asUser_returns403() throws Exception { ... }
+```

package/templates/skills/kld-sdd/opsx-tdd-quality/rules/java/domain-service-rules.md

@@ -0,0 +1,33 @@
+# 领域/服务单元测试规则
+
+> 影响等级：HIGH
+
+## 核心规则
+
+- 使用 `@ExtendWith(MockitoExtension.class)` 管理协作者
+- **禁止**为单元测试启动框架或容器
+- Mock 外部依赖，**不 mock 被测系统**
+- **绝不 mock 简单值对象**
+
+## Mock 边界
+
+| 应该 Mock | 用真实对象 |
+|-----------|-----------|
+| Repository / DAO | DTO / 值对象 |
+| 外部服务客户端 | 领域实体（大多数情况） |
+| 消息生产者 | 工具类 |
+| 缓存服务 | Mapper（通常） |
+| 任何 I/O 操作 | |
+
+## 验证模式
+
+```java
+// 验证未调用
+verify(service, never()).send(any());
+
+// 验证调用次数
+verify(repository, times(2)).findById(anyString());
+
+// 验证无更多交互
+verifyNoMoreInteractions(paymentService);
+```

package/templates/skills/kld-sdd/opsx-tdd-quality/rules/java/java-test-template.md

@@ -0,0 +1,42 @@
+# Java 测试模板
+
+> 影响等级：HIGH
+
+## 技术栈
+
+JUnit 5 + Mockito + AssertJ
+
+## 禁止
+
+**禁止**在单元测试中使用 `@SpringBootTest`（除非特定测试类型模板明确要求）
+
+## 标准模板
+
+```java
+@ExtendWith(MockitoExtension.class)
+class CalculatorServiceTest {
+    @Mock
+    private DependencyService dependencyService;
+    @InjectMocks
+    private CalculatorService calculatorService;
+
+    @Test
+    void calculate_validInput_returnsResult() {
+        // Given
+        when(dependencyService.getValue()).thenReturn(10);
+        // When
+        int actualResult = calculatorService.calculate(5);
+        // Then
+        int expectedResult = 15;
+        assertThat(actualResult).isEqualTo(expectedResult);
+    }
+}
+```
+
+## 关键点
+
+1. 测试类与 SUT 放在同一包中
+2. 用 `@ExtendWith(MockitoExtension.class)` mock 依赖
+3. `@Mock` 标注依赖，`@InjectMocks` 标注 SUT
+4. 遵循 Given-When-Then 模式并加注释
+5. 使用 AssertJ 断言（`assertThat()`）

package/templates/skills/kld-sdd/opsx-tdd-quality/rules/java/json-serialization.md

@@ -0,0 +1,34 @@
+# JSON 序列化
+
+> 影响等级：HIGH
+
+## 核心规则
+
+- **禁止**在测试中调用运行时序列化器（`objectMapper.writeValueAsString`、`gson.toJson` 等）
+- **必须**使用显式 JSON 字符串字面量
+
+## 正例
+
+```java
+String requestJson = """
+        {
+            "name": "John",
+            "email": "john@test.com"
+        }
+        """;
+```
+
+## 断言方式
+
+用 `jsonPath()` 验证响应 JSON 的具体字段，而非比较整个序列化字符串：
+
+```java
+.andExpect(jsonPath("$.name").value("John"))
+```
+
+## 好处
+
+- 可读性（期望数据直接可见）
+- 确定性（不依赖序列化器配置）
+- 可调试性
+- 可维护性

package/templates/skills/kld-sdd/opsx-tdd-quality/rules/java/logging-rules.md

@@ -0,0 +1,35 @@
+# 日志输出验证
+
+> 影响等级：MEDIUM
+
+## 核心规则
+
+使用 `@ExtendWith(OutputCaptureExtension.class)` 捕获和验证日志输出。
+
+## 反模式
+
+手动 `System.setOut(new PrintStream(...))` — 脆弱且容易忘记重置。
+
+## 正确模式
+
+```java
+@ExtendWith(OutputCaptureExtension.class)
+class OrderServiceTest {
+    @Test
+    void processOrder_success_logsOrderId(CapturedOutput output) {
+        var order = new Order("order-123", "product-1");
+        orderService.processOrder(order);
+        assertThat(output.getOut()).contains("Processing order: order-123");
+    }
+}
+```
+
+## CapturedOutput 方法
+
+- `getOut()` — stdout
+- `getErr()` — stderr
+- `getAll()` — 全部
+
+## 重要说明
+
+`OutputCaptureExtension` 来自 `spring-boot-test` 依赖，但**不启动 Spring 上下文**——只捕获 `System.out`/`System.err`，完全兼容单元测试。

package/templates/skills/kld-sdd/opsx-tdd-quality/rules/post-generation/compilation-verification.md

@@ -0,0 +1,25 @@
+# 编译验证
+
+> 影响等级：HIGH
+
+## 编译命令
+
+- Maven：`mvn test-compile -q`
+- Gradle：`gradle testClasses -q`
+- npm/yarn：`npm run build` 或 `npx tsc --noEmit`
+- Python：`python -m py_compile <test_file>`
+
+## 流程
+
+创建文件 → 运行编译 → 失败则修复（缺导入、缺依赖、语法错误、包路径错误、类型不匹配）→ 重试（**最多 5 次**）
+
+## 常见问题
+
+- 缺少 import
+- 缺少 Maven/Gradle 依赖
+- 包声明与目录不匹配
+- 类型不匹配（如 Long vs String）
+
+## 铁律
+
+绝不交付无法编译的测试。

package/templates/skills/kld-sdd/opsx-tdd-quality/rules/post-generation/execution-verification.md

@@ -0,0 +1,28 @@
+# 执行验证
+
+> 影响等级：HIGH
+
+## 执行命令
+
+只运行生成的测试类，不跑全套：
+- Maven：`mvn test -Dtest={TestClassName} -q`
+- Gradle：`gradle test --tests "{fully.qualified.TestClassName}" -q`
+
+## 失败处理流程
+
+1. 仔细阅读失败输出
+2. 识别根因（错误期望值、mock setup 不正确、缺少 stubbing、方法行为假设错误）
+3. **修复测试——绝不修改生产代码**
+4. 重试验证（**每个失败测试最多 3 次修复尝试**）
+5. 3 次后仍失败：删除该测试方法，加 `// TODO:` 注释说明，告知用户
+
+## 常见失败原因
+
+- 期望值错误 → 读生产代码理解实际返回值
+- 缺少 mock stubbing → 只 stub 实际调用的方法
+- Mockito 严格 stub 违规（`UnnecessaryStubbingException`）→ 删除不必要的 stub，**不要用 `lenient()`**
+- NPE → 检查 mock 是否默认返回 null，添加正确 stubbing
+
+## 铁律
+
+绝不交付失败的测试。如果生产代码有 bug，测试应记录**当前行为**并加注释标注疑似 bug。

package/templates/skills/kld-sdd/opsx-tdd-quality/rules/python/py-test-template.md

@@ -0,0 +1,40 @@
+# Python 测试模板
+
+> 影响等级：HIGH
+
+## 技术栈
+
+pytest + unittest.mock
+
+## 禁止
+
+**禁止**在单元测试中使用全量集成框架（除非特定测试类型模板明确要求）
+
+## 标准模板
+
+```python
+import pytest
+from unittest.mock import Mock
+from services.user_service import UserService
+
+class TestUserService:
+    def setup_method(self):
+        self.mock_repo = Mock()
+        self.service = UserService(self.mock_repo)
+
+    def test_create_user_valid_input_returns_user_id(self):
+        # Given
+        self.mock_repo.save.return_value = Mock(id='user-001')
+        # When
+        result = self.service.create_user('test', 'Pass1234', 'user')
+        # Then
+        assert result == 'user-001'
+```
+
+## 关键点
+
+1. 使用 `pytest` + `unittest.mock.Mock` 管理协作者
+2. Mock 外部依赖，**不 mock 被测系统**
+3. 遵循 Given-When-Then 模式
+4. 测试方法名遵循 `test_{method}_{state}_{outcome}` 格式
+5. 使用 `assert` 断言

package/templates/skills/kld-sdd/opsx-tdd-quality/rules/typescript/ts-test-template.md

@@ -0,0 +1,45 @@
+# TypeScript 测试模板
+
+> 影响等级：HIGH
+
+## 技术栈
+
+Vitest / Jest + @testing-library
+
+## 禁止
+
+**禁止**在单元测试中使用全量集成框架（除非特定测试类型模板明确要求）
+
+## 标准模板
+
+```typescript
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { UserService } from './UserService';
+
+describe('UserService', () => {
+  let userService: UserService;
+  let mockRepo: any;
+
+  beforeEach(() => {
+    mockRepo = { findById: vi.fn(), save: vi.fn() };
+    userService = new UserService(mockRepo);
+  });
+
+  it('createUser_validInput_returnsUserId', async () => {
+    // Given
+    mockRepo.save.mockResolvedValue({ id: 'user-001', name: 'test' });
+    // When
+    const result = await userService.createUser('test', 'Pass1234', 'user');
+    // Then
+    expect(result).toBe('user-001');
+  });
+});
+```
+
+## 关键点
+
+1. 使用 `describe` + `it` 组织测试
+2. `vi.fn()` mock 外部依赖，不 mock 被测系统
+3. 遵循 Given-When-Then 模式
+4. 使用 `expect` 断言
+5. 测试方法名遵循 `{method}_{state}_{outcome}` 格式

package/templates/skills/kld-sdd/opsx-tdd-review/SKILL.md

@@ -0,0 +1,66 @@
+---
+name: opsx-tdd-review
+description: "测试审查层 — 从审查者角度检测'测试通过但没测到关键点'。8 项质量检查 + 缺失测试检测 + 测试异味检测。当审查测试代码时引用本技能。"
+---
+
+# opsx-tdd-review — 测试审查层
+
+> **定位**：从审查者角度检测"测试通过但没测到关键点"。
+> **参考来源**：code-reviewer Phase 5 + tdd-guide 测试质量审查
+
+---
+
+## §1 审查目标
+
+区分"覆盖率"和"测试质量" — **测试通过 ≠ 测试正确**。
+
+## §2 覆盖率审查
+
+| 指标 | 阈值 | 说明 |
+|------|------|------|
+| 行覆盖率 | >80% | 基础要求 |
+| 分支覆盖率 | >75% | 仅行覆盖率不够 |
+| 函数覆盖率 | >90% | |
+| 关键路径覆盖率 | 100% | |
+
+> 覆盖率不是唯一指标——100% 覆盖率不等于测试有意义。
+
+## §3 测试质量审查（8 项）
+
+- [ ] 测试是否真正断言了有意义的行为（而非仅 mock 存在）
+- [ ] 测试是否独立隔离（无测试间依赖）
+- [ ] 测试名称是否清晰描述被测内容
+- [ ] mock 和 stub 是否正确使用（Mock 边界，不 Mock 行为）
+- [ ] 无测试间依赖
+- [ ] 无 sleep 或任意等待
+- [ ] 测试了正常路径 + 错误条件 + 边界值 + 空输入
+- [ ] AAA 模式（Arrange-Act-Assert）
+
+## §4 缺失测试检测
+
+- [ ] 未测试的错误路径
+- [ ] 缺失的负面测试用例
+- [ ] 未覆盖的边界条件
+- [ ] bug 修复无回归测试
+
+## §5 测试异味检测
+
+> 完整检测信号见 `opsx-tdd-metrics/SKILL.md` §3，此处仅保留快速参考。
+
+| 异味 | 检测信号 | 严重程度 |
+|------|---------|---------|
+| 断言轮盘赌 | 单测试 >5 个断言 | 中 |
+| 缺失断言 | 测试代码中无 `assert` 或 `expect` | 高 |
+| sleep 测试 | 检测 `sleep`/`wait` 使用 | 高 |
+| 条件测试逻辑 | 测试中的 `if` 语句 | 中 |
+| 弱断言 | 只检查 truthy（`assertNotNull` 但不检查值） | 中 |
+
+## §6 评分标准
+
+| 评级 | 标准 |
+|------|------|
+| PASS | 需明确证据且证据反映真实任务完成 |
+| FAIL | 包括：无证据、证据矛盾、证据表面化、巧合满足 |
+| 不确定 | 举证责任在期望方（默认 FAIL） |
+
+> 不给予部分分数。每个断言要么通过要么失败。

package/templates/skills/kld-sdd/opsx-tdd-review/checklist.md

@@ -0,0 +1,39 @@
+---
+description: "opsx-tdd-review 自检清单 — 测试质量审查 8 项 + 缺失测试检测 + 测试异味检测。仅在审查测试代码时读取。"
+---
+
+# opsx-tdd-review — 自检清单
+
+> 仅在审查测试代码时读取。日常流程见 `SKILL.md`。
+
+## §A 测试质量审查（8 项）
+
+- [ ] 测试是否真正断言了有意义的行为（而非仅 mock 存在）
+- [ ] 测试是否独立隔离（无测试间依赖）
+- [ ] 测试名称是否清晰描述被测内容（符合 `{method}_{state}_{outcome}`）
+- [ ] mock 和 stub 是否正确使用（Mock 边界，不 Mock 行为，见 `opsx-tdd-quality/SKILL.md` §2）
+- [ ] 无测试间依赖
+- [ ] 无 sleep 或任意等待
+- [ ] 测试了正常路径 + 错误条件 + 边界值 + 空输入
+- [ ] AAA 模式（Arrange-Act-Assert）/ Given-When-Then 结构
+
+## §B 缺失测试检测
+
+- [ ] 未测试的错误路径（每个 orElseThrow/边界检查有对应测试，见 `opsx-tdd-rules/rules/exception-path-coverage.md`）
+- [ ] 缺失的负面测试用例
+- [ ] 未覆盖的边界条件
+- [ ] bug 修复无回归测试
+
+## §C 测试异味检测
+
+| 异味 | 检测信号 | 严重程度 |
+|------|---------|---------|
+| 断言轮盘赌 | 单测试 >5 个断言 | 中 |
+| 缺失断言 | 测试代码中无 `assert` 或 `expect` | 高 |
+| sleep 测试 | 检测 `sleep`/`wait` 使用 | 高 |
+| 条件测试逻辑 | 测试中的 `if` 语句 | 中 |
+| 弱断言 | 只检查 truthy（`assertNotNull` 但不检查值） | 中 |
+
+## §D 反模式检测
+
+- [ ] 已检查 `opsx-tdd-anti-patterns/SKILL.md` §3-§4 的 15 种反模式

package/templates/skills/kld-sdd/opsx-tdd-rules/SKILL.md

@@ -0,0 +1,29 @@
+---
+name: opsx-tdd-rules
+description: "TDD 规则库 — DAG 生成规则、Controller 策略、任务类型定义、telemetry 模板等独立规则文件。当需要具体 TDD 规则文件时引用本技能。"
+---
+
+# opsx-tdd-rules — 规则库
+
+> **定位**：TDD 相关的规则文件集合，供其他技能按需引用。
+> **参考来源**：unit-tests-skills rules/ 目录模式
+
+---
+
+## 规则索引
+
+| 规则文件 | 摘要 | 影响等级 | 引用方 |
+|---------|------|---------|--------|
+| `rules/tdd-strategy-selection.md` | TDD 策略选择文案（tdd/impl-first/none 三选一） | HIGH | opsx-task |
+| `rules/dag-generation-rules.md` | DAG 生成规则表（三种策略的 DAG 规则对照） | HIGH | opsx-task |
+| `rules/task-type-definitions.md` | RED/GREEN/REFACTOR/VERIFY 任务类型定义 | HIGH | opsx-task |
+| `rules/non-tdd-modules.md` | 非 TDD 模块排除规则（前端/配置/SQL DDL） | MEDIUM | opsx-task |
+| `rules/controller-strategy.md` | Controller 层策略 A/B | HIGH | opsx-task |
+| `rules/test-skeleton-telemetry.md` | test-skeleton telemetry 命令模板 | MEDIUM | opsx-apply |
+| `rules/test-execution-gate.md` | 测试执行门禁策略（tdd=强制/impl-first=警告/none=跳过） | HIGH | opsx-apply |
+| `rules/green-yagni-fence.md` | GREEN 任务 YAGNI 围栏自动注入规则 | HIGH | opsx-task |
+| `rules/green-scope-declaration.md` | GREEN 任务 Scope 声明步骤（断言清单→流程标记→仅实现属于的步骤） | HIGH | opsx-apply |
+| `rules/des-step-annotation.md` | DES 元素步骤级标注规则（TDD 模式下标注 [GREEN-N] 归属） | MEDIUM | opsx-design |
+| `rules/multi-validation-split.md` | 多校验条件拆分规则（每个校验条件须有独立 AC 场景） | MEDIUM | opsx-spec |
+| `rules/exception-path-coverage.md` | 异常路径测试覆盖门禁（每个 orElseThrow/边界检查须有对应 RED 测试） | HIGH | opsx-task, opsx-apply, opsx-check |
+| `rules/refactor-checklist.md` | REFACTOR 阶段检查点（public API 不变、行为保持、重构质量评估） | HIGH | opsx-apply, opsx-tdd-core |