kld-sdd 2.6.15 → 2.6.16

package/templates/skills/kld-sdd/tdd-rules/rules/tdd-rhythm-enforcement.md

@@ -0,0 +1,101 @@
+# TDD 节奏强制规则
+
+> 影响等级：CRITICAL
+>
+> 本规则由 `sdd-tdd-rhythm-gate.cjs` hook 自动强制执行，不可绕过。
+
+## 1. 硬阻断规则（由 hook 强制执行）
+
+### 1.1 批量更新阻断
+
+禁止单次文件写入中修改 >3 个任务的状态（`[ ]` → `[x]`）。
+每个任务必须通过 `task_update` → `check-task` 流程逐个更新。
+
+**例外**：如果所有任务都有对应的 `task_update` 遥测事件，说明是 `check-task` 的合法批量更新，放行。
+
+### 1.2 RED 证据阻断
+
+RED 任务标记完成前，必须存在对应的 `test_result` 遥测事件：
+- `type=test_result`
+- `result=failure`
+- `tdd_phase=red`
+- `task_id` 匹配
+
+### 1.3 GREEN 证据阻断
+
+GREEN 任务标记完成前，必须存在对应的 `test_result` 遥测事件：
+- `type=test_result`
+- `result=success`
+- `tdd_phase=green`
+- `task_id` 匹配
+
+### 1.4 节奏间隔阻断
+
+GREEN 任务的 `test_result` 与其配对 RED 任务的 `test_result` 之间，
+时间间隔必须 >60 秒。间隔过短视为批量执行信号。
+
+### 1.5 REFACTOR 证据阻断
+
+REFACTOR 任务标记完成前，必须存在对应的 `test_result` 遥测事件：
+- `type=test_result`
+- `result=success`
+- `tdd_phase=refactor`
+- `task_id` 匹配
+
+## 2. 安全网（防止误阻断）
+
+### 2.1 非 TDD 模式放行
+
+`proposal.md` 的 `test-strategy` 为 `none` 或 `impl-first` 时，跳过全部 TDD 节奏检查。
+
+### 2.2 post-tool 失败降级
+
+如果 telemetry 中无任何 `test_result` 事件（说明 `sdd-post-tool.cjs` 可能未正常工作），
+降级为警告模式，不阻断。
+
+### 2.3 unknown 类型降级
+
+任务类型无法识别时（旧格式 tasks.md 或手动创建），降级为警告，不阻断。
+
+### 2.4 非 apply 阶段放行
+
+仅在 apply 阶段活跃时触发检查。propose/spec/design/task/check/archive 阶段全部放行。
+
+## 3. 软警告规则（由 hook 记录但不阻断）
+
+### 3.1 时间异常警告
+
+如果 apply 阶段 N 个 TDD 任务的每任务平均耗时 <120 秒，
+记录 `telemetry_warning(tdd_timing_anomaly)`。
+
+### 3.2 RED 缺失警告
+
+如果 TDD 策略下 apply 阶段无任何失败的 `test_result`，
+记录 `telemetry_warning(tdd_red_missing)`。
+
+### 3.3 测试结果复用警告
+
+如果多个 `task_update` 引用同一个 `test_result` 指纹，
+记录 `telemetry_warning(task_update_reuse)`。
+
+## 4. 中途检查点规则
+
+每完成 10 个 TDD 任务后，强制执行检查点：
+- 对比 `task_update` 事件数与 tasks.md `[x]` 数量
+- 对比 `test_result` 事件数与 TDD 对数 × 2
+- 不一致则输出警告
+
+## 5. 上下文刷新规则
+
+每个新 Layer 开始时，agent 必须重新读取 TDD 红绿节奏规则（§S2），
+并显式声明将继续遵循严格 RED→GREEN 串行循环。
+
+## 6. 任务类型识别
+
+| tasks.md 中的类型值 | hook 返回 | 处理 |
+|---------------------|----------|------|
+| `测试-RED` | `red` | 检查 test_result(fail) |
+| `实现-GREEN` | `green` | 检查 test_result(pass) + RED前置 + 间隔>60s |
+| `重构-REFACTOR` | `refactor` | 检查 test_result(pass)，不检查 RED 前置 |
+| `配置`/`数据层`/`接口层`/`接口测试` | `non-tdd` | 放行 |
+| 无法识别 | `unknown` | 警告放行 |