jsharness 1.12.4 → 1.12.5

package/.harness/agents/code-reviewer/contract.yaml

@@ -40,10 +40,10 @@ responsibilities:
 
 review_dimensions:
   - name: "A. 代码质量"
-    weight: 30
+    weight: 25
     items: [命名, 复杂度, 类型, 错误处理, DRY]
   - name: "B. 规范遵循"
-    weight: 15
+    weight: 10
     items: [Commit, 分支, PR描述, 文档]
   - name: "C. 安全与风险"
     weight: 25
@@ -52,8 +52,19 @@ review_dimensions:
     weight: 10
     items: [N+1, 内存, 体积]
   - name: "E. 测试覆盖"
-    weight: 20
-    items: [存在性, 覆盖率, 质量]
+    weight: 30
+    items: [单元测试, 覆盖率, 测试质量, 测试用例文档, 前端组件测试, 后端Service测试]
+
+fail_fast_conditions:
+  - code: "E4-NO-TEST-CASES"
+    condition: "缺少测试用例文档（.harness/doc/test-cases/ 下无 feature-points.md）"
+    action: "直接 FAIL"
+  - code: "E5-NO-VUE-TEST"
+    condition: "新增/修改的 Vue 组件缺少对应测试文件"
+    action: "直接 FAIL"
+  - code: "E5-NO-JAVA-TEST"
+    condition: "新增/修改的 Service 类缺少对应测试类"
+    action: "直接 FAIL"
 
 constraints:
   - 不改代码（只评论）

package/.harness/agents/developer/contract.yaml

@@ -41,6 +41,9 @@ dependencies:
 responsibilities:
   - 按设计文档编写代码
   - 编写/更新对应单元测试
+  - 前端组件必须有 .test.ts/.spec.ts 文件（Vitest/Jest）
+  - 后端 Service 必须有对应 Test 类（JUnit5+Mockito）
+  - 生成测试用例文档（test-case-designer Skill → .harness/doc/test-cases/）
   - 运行 Build/Test/Lint 三步自检
   - 更新 dev-map（如有结构性变化）
   - 规范 Commit（Conventional Commits + 关联 Issue）
@@ -57,3 +60,6 @@ quality_redlines:
   - 裸any类型（无注释说明）
   - console.log/debugger残留
   - 跳过任意一步自检流程
+  - 前端组件无测试文件
+  - 后端 Service 无测试类
+  - 缺少测试用例文档

package/.harness/agents/developer/prompt.md

@@ -51,18 +51,23 @@ dependencies:
 1. 阅读设计文档 + dev-map 相关部分
 2. 实现核心逻辑
 3. 编写/更新对应单元测试
-4. 运行 Build Skill → 编译通过？
-5. 运行 Test Unit Skill → 测试通过 + 覆盖率达标？
-6. 运行 Lint Check Skill → 零 warning？
-7. 更新 dev-map（如有结构性变化）
-8. 规范 Commit（Conventional Commits + 关联 Issue）
-9. 创建 PR/MR
+   - **前端**: 每个 .vue 组件必须有 .test.ts/.spec.ts 文件（Vitest/Jest）
+   - **后端**: 每个 Service/ServiceImpl 必须有对应 Test 类（JUnit5+Mockito）
+4. 生成测试用例文档（test-case-designer Skill）
+5. 运行 Build Skill → 编译通过？
+6. 运行 Test Unit Skill → 测试通过 + 覆盖率达标？
+7. 运行 Lint Check Skill → 零 warning？
+8. 更新 dev-map（如有结构性变化）
+9. 规范 Commit（Conventional Commits + 关联 Issue）
+10. 创建 PR/MR
 
 ## 质量红线（触碰即打回）
 - 硬编码密钥/token
 - 裸 `any` 类型（无注释说明）
 - console.log / debugger 残留
 - 跳过任意一步自检流程
+- **缺少单元测试文件**（前端组件无 .test.ts / 后端 Service 无 Test 类）
+- **缺少测试用例文档**（.harness/doc/test-cases/ 下无对应 feature-points.md）
 
 ## 你的约束
 - ❌ 不改需求和设计文档

package/.harness/agents/tester/contract.yaml

@@ -40,6 +40,9 @@ outputFormat: .harness/doc/test-report/test-report-{task-id}.md
 
 responsibilities:
   - 制定测试策略和计划
+  - 验证测试用例文档完整性（.harness/doc/test-cases/ 下有 feature-points.md）
+  - 验证前端组件测试覆盖（每个 .vue 有对应 .test.ts/.spec.ts）
+  - 验证后端 Service 测试覆盖（每个 Service 有对应 Test 类）
   - 设计和执行各类测试
   - 记录和跟踪缺陷
   - 输出完整的测试报告

package/.harness/agents/tester/prompt.md

@@ -50,7 +50,9 @@ outputFormat: .harness/doc/test-report/test-report-{task-id}.md
 ## 测试覆盖矩阵
 | 测试类型 | 执行时机 | 负责人 | 必须? | 引用Skill |
 |----------|----------|--------|-------|-----------|
+| 测试用例验证 | 测试开始前 | Tester | ✅ 必须 | test-case-designer |
 | 单元测试 | 开发时 | Developer | ✅ 必须 | test-unit |
+| 前端组件测试 | 开发时 | Developer | ✅ 必须 | test-unit |
 | 静态检查 | 每次 commit | Dev/CI | ✅ 必须 | lint-check |
 | API 集成测试 | PR 前 | Tester | ✅ 必须 | test-api |
 | E2E 关键路径 | 预发布前 | Tester | ✅ 必须 | test-e2e |
@@ -73,6 +75,15 @@ outputFormat: .harness/doc/test-report/test-report-{task-id}.md
 - 核心 E2E 路径全部通过
 - API 契约无破坏性变更
 - 测试覆盖率不低于基线
+- **测试用例文档存在且与验收标准对齐**（.harness/doc/test-cases/ 下有 feature-points.md）
+- **前端组件测试覆盖 ≥80%**（每个 .vue 有对应 .test.ts/.spec.ts）
+
+## 测试执行前置检查
+在正式执行测试前，必须验证以下前置条件：
+1. **测试用例文档检查** — 确认 `.harness/doc/test-cases/{需求名称}/feature-points.md` 存在
+2. **前端测试文件存在性** — 扫描 src/ 下 .vue 文件，确认每个组件有对应测试文件
+3. **后端测试类存在性** — 扫描 Service/ServiceImpl 类，确认有对应 Test 类
+4. 任何前置条件不满足 → 记录为 P1 缺陷并要求开发补充
 
 ## 你的约束
 - ❌ 不改被测代码

package/.harness/gate/checks/build-gates-frontend.js

@@ -134,6 +134,66 @@ async function run(options = {}) {
     );
   }
 
+  // === F-B6: 前端单元测试执行 ===
+  if (pkgJson?.scripts?.test || pkgJson?.scripts?.['test:unit'] || pkgJson?.scripts?.['test:coverage']) {
+    const testCmd = pkgJson.scripts['test:coverage'] || pkgJson.scripts['test:unit'] || pkgJson.scripts.test;
+    await runCheck(
+      '前端单元测试 (npm run test)',
+      `${pm} run test 2>&1`,
+      { timeout: 180000, blocking: true, suggestion: '前端项目必须有单元测试且全部通过。使用 Vitest 或 Jest 编写组件测试。参考 skills/test-unit/SKILL.md' }
+    );
+  } else {
+    // 无测试脚本 → 严重问题
+    issues.push({
+      code: 'F-B6',
+      severity: 'error',
+      message: '前端项目缺少测试脚本 (package.json 中无 test/test:unit/test:coverage 脚本)',
+      suggestion: '必须添加测试脚本。推荐配置: "test": "vitest run", "test:coverage": "vitest run --coverage"'
+    });
+    checks.push({ name: '前端单元测试', status: 'fail', duration_ms: 0, error: '无测试脚本' });
+  }
+
+  // === F-B7: 前端组件测试文件存在性检查 ===
+  const srcDir = path.join(process.cwd(), 'src');
+  if (fs.existsSync(srcDir)) {
+    const vueFiles = findVueFiles(srcDir);
+    const testFileNames = new Set(
+      findTestFiles(srcDir).map(f => {
+        const base = path.basename(f);
+        return base.replace(/\.(test|spec)\.(ts|js)$/, '.vue');
+      })
+    );
+    
+    const untestedVue = vueFiles.filter(vf => {
+      const base = path.basename(vf);
+      return !testFileNames.has(base);
+    }).map(vf => vf.replace(srcDir + path.sep, ''));
+    
+    if (untestedVue.length > 0 && vueFiles.length > 0) {
+      const coveragePercent = ((vueFiles.length - untestedVue.length) / vueFiles.length * 100).toFixed(1);
+      if (parseFloat(coveragePercent) < 80) {
+        issues.push({
+          code: 'F-B7',
+          severity: 'error',
+          message: `前端组件测试覆盖不足: ${coveragePercent}% — ${untestedVue.length} 个组件缺少测试文件`,
+          details: untestedVue.slice(0, 10),
+          suggestion: '每个 .vue 组件必须有对应的 .test.ts 或 .spec.ts 文件。这是 Gate 强制检查项。'
+        });
+      } else {
+        issues.push({
+          code: 'F-B7',
+          severity: 'warning',
+          message: `前端组件测试覆盖 ${coveragePercent}%，${untestedVue.length} 个组件缺少测试`,
+          details: untestedVue.slice(0, 5),
+          suggestion: '建议为所有组件补充测试'
+        });
+      }
+      checks.push({ name: '前端组件测试覆盖', status: parseFloat(coveragePercent) < 80 ? 'fail' : 'pass', duration_ms: 0 });
+    } else if (vueFiles.length > 0) {
+      checks.push({ name: '前端组件测试覆盖', status: 'pass', duration_ms: 0 });
+    }
+  }
+
   // 计算结果
   const passed = checks.filter(c => c.status === 'pass').length;
   const failed = checks.filter(c => c.status === 'fail').length;
@@ -150,3 +210,37 @@ async function run(options = {}) {
 }
 
 module.exports = run;
+
+/**
+ * 递归查找 .vue 文件
+ */
+function findVueFiles(dir, results = []) {
+  if (!fs.existsSync(dir)) return results;
+  const entries = fs.readdirSync(dir, { withFileTypes: true });
+  for (const entry of entries) {
+    const fullPath = path.join(dir, entry.name);
+    if (entry.isDirectory() && !['node_modules', '.git', 'dist', 'coverage'].includes(entry.name)) {
+      findVueFiles(fullPath, results);
+    } else if (entry.name.endsWith('.vue')) {
+      results.push(fullPath);
+    }
+  }
+  return results;
+}
+
+/**
+ * 递归查找测试文件 (.test.ts / .spec.ts / .test.js / .spec.js)
+ */
+function findTestFiles(dir, results = []) {
+  if (!fs.existsSync(dir)) return results;
+  const entries = fs.readdirSync(dir, { withFileTypes: true });
+  for (const entry of entries) {
+    const fullPath = path.join(dir, entry.name);
+    if (entry.isDirectory() && !['node_modules', '.git', 'dist', 'coverage'].includes(entry.name)) {
+      findTestFiles(fullPath, results);
+    } else if (/\.(test|spec)\.(ts|js)$/.test(entry.name)) {
+      results.push(fullPath);
+    }
+  }
+  return results;
+}

package/.harness/gate/checks/test-compliance.js

@@ -2,13 +2,16 @@
  * Gate Check Category C: 测试合规 (test-compliance)
  * 
  * 检查项：
- * - 单元测试执行与覆盖率收集
- * - E2E 关键路径测试（可选）
- * - API 集成测试（可选）
- * - 测试数量对比（基线模式）
+ * - C1: 单元测试执行与覆盖率收集
+ * - C2: 测试数量趋势（如果有基线）
+ * - C3: 测试用例文档完整性（.harness/doc/test-cases/）
+ * - C4: 前端组件测试覆盖（每个 .vue 有对应 .test.ts/.spec.ts）
+ * - C5: 后端 Service 测试覆盖（每个 Service 有对应 Test 类）
  */
 
 const { execSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
 
 async function run(options = {}) {
   const issues = [];
@@ -100,6 +103,151 @@ async function run(options = {}) {
     testResults.test_count = testResults.unit.total;
   }
 
+  // C3: 测试用例文档完整性检查
+  const cwd = process.cwd();
+  const testCasesDir = path.join(cwd, '.harness', 'doc', 'test-cases');
+  let testCaseStatus = { exists: false, files: [] };
+  
+  if (fs.existsSync(testCasesDir)) {
+    const entries = fs.readdirSync(testCasesDir, { withFileTypes: true });
+    const requirementDirs = entries.filter(e => e.isDirectory());
+    
+    for (const dir of requirementDirs) {
+      const dirPath = path.join(testCasesDir, dir.name);
+      const files = fs.readdirSync(dirPath);
+      const hasFeaturePoints = files.some(f => f === 'feature-points.md');
+      const hasCyclePlan = files.some(f => f === 'cycle-plan.md');
+      const hasSpecialPlan = files.some(f => f === 'special-plan.md');
+      
+      testCaseStatus.files.push({
+        requirement: dir.name,
+        feature_points: hasFeaturePoints,
+        cycle_plan: hasCyclePlan,
+        special_plan: hasSpecialPlan
+      });
+      
+      if (!hasFeaturePoints) {
+        issues.push({
+          code: 'C3',
+          severity: 'error',
+          message: `需求 "${dir.name}" 缺少功能点测试用例文档 (feature-points.md)`,
+          suggestion: '使用 test-case-designer Skill 生成标准化测试用例文档'
+        });
+      }
+    }
+    
+    testCaseStatus.exists = requirementDirs.length > 0;
+    
+    if (requirementDirs.length === 0) {
+      issues.push({
+        code: 'C3',
+        severity: 'warning',
+        message: '测试用例文档目录为空，没有找到任何需求的测试用例',
+        suggestion: '在开发阶段应使用 test-case-designer Skill 生成测试用例文档'
+      });
+    }
+  } else {
+    issues.push({
+      code: 'C3',
+      severity: 'error',
+      message: '测试用例文档目录不存在 (.harness/doc/test-cases/)',
+      suggestion: '开发阶段必须使用 test-case-designer Skill 生成测试用例文档。这是 Gate C3 强制检查项。'
+    });
+  }
+  testResults.test_cases = testCaseStatus;
+
+  // C4: 前端组件测试覆盖检查
+  const srcDir = path.join(cwd, 'src');
+  if (fs.existsSync(srcDir)) {
+    const vueFiles = findFiles(srcDir, '.vue');
+    const testFiles = new Set(findFiles(srcDir, '.test.ts')
+      .concat(findFiles(srcDir, '.spec.ts'))
+      .concat(findFiles(srcDir, '.test.js'))
+      .concat(findFiles(srcDir, '.spec.js'))
+      .map(f => path.basename(f, path.extname(f)).replace(/\.(test|spec)$/, '')));
+    
+    const untestedVueComponents = [];
+    for (const vueFile of vueFiles) {
+      const componentName = path.basename(vueFile, '.vue');
+      // 检查是否有对应的测试文件（同名或含组件名的测试文件）
+      const hasTest = testFiles.has(componentName) || 
+                      Array.from(testFiles).some(t => t.includes(componentName));
+      if (!hasTest) {
+        untestedVueComponents.push(vueFile.replace(srcDir + path.sep, ''));
+      }
+    }
+    
+    testResults.frontend_coverage = {
+      total_components: vueFiles.length,
+      tested_components: vueFiles.length - untestedVueComponents.length,
+      untested: untestedVueComponents
+    };
+    
+    if (untestedVueComponents.length > 0 && vueFiles.length > 0) {
+      const coveragePercent = ((vueFiles.length - untestedVueComponents.length) / vueFiles.length * 100).toFixed(1);
+      
+      if (parseFloat(coveragePercent) < 80) {
+        issues.push({
+          code: 'C4',
+          severity: 'error',
+          message: `前端组件测试覆盖不足: ${coveragePercent}% (${vueFiles.length - untestedVueComponents.length}/${vueFiles.length}) — ${untestedVueComponents.length} 个组件缺少测试`,
+          details: untestedVueComponents.slice(0, 10),
+          suggestion: '每个 Vue 组件必须有对应的 .test.ts 或 .spec.ts 文件。请使用 Vitest/Jest 编写组件测试。'
+        });
+      } else {
+        issues.push({
+          code: 'C4',
+          severity: 'warning',
+          message: `前端组件测试覆盖 ${coveragePercent}%，${untestedVueComponents.length} 个组件缺少测试`,
+          details: untestedVueComponents.slice(0, 5),
+          suggestion: '建议为所有组件补充测试文件'
+        });
+      }
+    }
+  }
+
+  // C5: 后端 Service 测试覆盖检查
+  const javaSrcDir = path.join(cwd, 'src', 'main', 'java');
+  if (fs.existsSync(javaSrcDir)) {
+    const serviceFiles = findFiles(javaSrcDir, 'ServiceImpl.java')
+      .concat(findFiles(javaSrcDir, 'Service.java').filter(f => !f.includes('Impl')));
+    const testSrcDir = path.join(cwd, 'src', 'test', 'java');
+    
+    let testClassNames = new Set();
+    if (fs.existsSync(testSrcDir)) {
+      const testJavaFiles = findFiles(testSrcDir, 'Test.java')
+        .concat(findFiles(testSrcDir, 'Tests.java'));
+      testClassNames = new Set(testJavaFiles.map(f => path.basename(f)));
+    }
+    
+    const untestedServices = [];
+    for (const svcFile of serviceFiles) {
+      const svcName = path.basename(svcFile, '.java');
+      const expectedTestName = `${svcName}Test.java`;
+      const expectedTestNameAlt = `${svcName}Tests.java`;
+      const hasTest = testClassNames.has(expectedTestName) || testClassNames.has(expectedTestNameAlt);
+      if (!hasTest) {
+        untestedServices.push(svcFile.replace(javaSrcDir + path.sep, ''));
+      }
+    }
+    
+    testResults.backend_coverage = {
+      total_services: serviceFiles.length,
+      tested_services: serviceFiles.length - untestedServices.length,
+      untested: untestedServices
+    };
+    
+    if (untestedServices.length > 0 && serviceFiles.length > 0) {
+      issues.push({
+        code: 'C5',
+        severity: 'error',
+        message: `后端 Service 测试覆盖不足: ${serviceFiles.length - untestedServices.length}/${serviceFiles.length} — ${untestedServices.length} 个 Service 缺少测试类`,
+        details: untestedServices.slice(0, 10),
+        suggestion: '每个 Service/ServiceImpl 必须有对应的 Test 类（JUnit5+Mockito）。参考 skills/test-unit/SKILL.md'
+      });
+    }
+  }
+
   // 计算状态
   const hasError = issues.some(i => i.severity === 'error');
   
@@ -111,4 +259,22 @@ async function run(options = {}) {
   };
 }
 
+/**
+ * 递归查找指定扩展名的文件
+ */
+function findFiles(dir, extension, results = []) {
+  if (!fs.existsSync(dir)) return results;
+  
+  const entries = fs.readdirSync(dir, { withFileTypes: true });
+  for (const entry of entries) {
+    const fullPath = path.join(dir, entry.name);
+    if (entry.isDirectory() && !['node_modules', '.git', 'dist', 'target', 'coverage'].includes(entry.name)) {
+      findFiles(fullPath, extension, results);
+    } else if (entry.name.endsWith(extension)) {
+      results.push(fullPath);
+    }
+  }
+  return results;
+}
+
 module.exports = run;

package/.harness/skills/code-review/SKILL.md

@@ -61,6 +61,16 @@ enabled: true
 | E1 | **单元测试** | 新增/修改代码有对应单测 | ⭐⭐⭐ |
 | E2 | **覆盖率** | 新代码覆盖率 ≥ 85% | ⭐⭐⭐ |
 | E3 | **测试质量** | 测试有意义（非假断言）| ⭐⭐ |
+| E4 | **测试用例文档** | `.harness/doc/test-cases/` 下有 feature-points.md | ⭐⭐⭐ |
+| E5 | **前端组件测试** | 每个 .vue 文件有对应 .test.ts/.spec.ts | ⭐⭐⭐ |
+| E5 | **后端 Service 测试** | 每个 Service/ServiceImpl 有对应 Test 类 | ⭐⭐⭐ |
+
+### E 类一票否决条件
+
+以下情况直接 FAIL，无需计算总分：
+- **E4-NO-TEST-CASES**: 缺少测试用例文档（.harness/doc/test-cases/ 下无 feature-points.md）
+- **E5-NO-VUE-TEST**: 新增/修改的 Vue 组件缺少对应测试文件
+- **E5-NO-JAVA-TEST**: 新增/修改的 Service 类缺少对应测试类
 
 ---
 

package/.harness/workflow/definition.yaml

@@ -291,8 +291,16 @@ workflow:
           required: true
         - name: "单元测试"
           format: "source code (.test.*)"
-          location: "src/"
+          location: "src/ 或 test/"
+          required: true
+          validation:
+            frontend: "每个 Vue 组件必须有对应 .test.ts/.spec.ts 文件（Vitest/Jest）"
+            backend: "每个 Service 类必须有对应 Test 类（JUnit5+Mockito），覆盖率 ≥80%"
+        - name: "测试用例"
+          format: "markdown (.harness/doc/test-cases/{需求名称}/)"
           required: true
+          description: "基于 test-case-designer Skill 生成的标准化测试用例文档"
+          validation: "必须包含功能点测试用例（feature-points.md），可选拓展周期计划和专项计划"
         - name: "Git Commit 历史"
           source: "git_log"
           required: true
@@ -315,18 +323,22 @@ workflow:
           action: "实现核心逻辑"
           skill: null
         - step: 3
-          action: "编写/更新单元测试"
+          action: "编写/更新单元测试（前端 Vitest/Jest + 后端 JUnit5/Mockito）"
           skill: "test-unit"
+          gate: "无测试文件 → 阻断提交，必须补充后再继续"
+        - step: 3.5
+          action: "验证测试用例文档完整性"
+          skill: "test-case-designer"
+          gate: "缺少测试用例文档 → 阻断提交，必须生成 feature-points.md 后再继续"
         - step: 4
           action: "运行构建 Skill（按技术栈选择）"
           # 条件引用：检测 pom.xml → java-build；检测 package.json → vue-frontend-build
-          # 详见 skills/build.md（已废弃，保留为路由参考）
           skill: "java-build | vue-frontend-build"
           gate: "编译失败 → 返回 Step 2"
         - step: 5
-          action: "运行 Test Unit Skill"
+          action: "运行 Test Unit Skill（前端 Vitest + 后端 JUnit5）"
           skill: "test-unit"
-          gate: "测试失败 → 返回 Step 2/3"
+          gate: "测试失败 → 返回 Step 2/3 | 前端无测试 → FAIL | 后端覆盖率 <80% → WARNING"
         - step: 6
           action: "运行 Lint Check Skill"
           skill: "lint-check"
@@ -406,11 +418,11 @@ workflow:
       review_dimensions:
         - id: quality
           name: "代码质量"
-          weight: 30
+          weight: 25
           checks: ["A1-A6"]
         - id: compliance
           name: "规范遵循"
-          weight: 15
+          weight: 10
           checks: ["B1-B5"]
         - id: security
           name: "安全与风险"
@@ -422,8 +434,21 @@ workflow:
           checks: ["D1-D4"]
         - id: testing
           name: "测试覆盖"
-          weight: 20
-          checks: ["E1-E3"]
+          weight: 30
+          checks: ["E1-E5"]
+          # E4: 测试用例文档完整性（.harness/doc/test-cases/ 下有对应文件）
+          # E5: 前端组件测试存在性（每个 .vue 文件有对应 .test.ts/.spec.ts）
+      
+      fail_fast_conditions:
+        - condition: "新增/修改的 Vue 组件缺少对应测试文件"
+          action: "FAIL — 前端组件必须有单元测试"
+          code: "E5-NO-VUE-TEST"
+        - condition: "新增/修改的 Service 类缺少对应测试类"
+          action: "FAIL — 后端 Service 必须有单元测试"
+          code: "E5-NO-JAVA-TEST"
+        - condition: "缺少测试用例文档（.harness/doc/test-cases/）"
+          action: "FAIL — 必须有标准化测试用例文档"
+          code: "E4-NO-TEST-CASES"
 
     - id: testing
       name: "测试验证"
@@ -448,6 +473,10 @@ workflow:
         - name: "审查报告"
           from: "code_review"
           required: true
+        - name: "测试用例文档"
+          from: "development"
+          required: true
+          path: ".harness/doc/test-cases/{需求名称}/"
         - name: "Skill 测试动作集"
           source: "skills/test-*.md"
           required: true
@@ -476,6 +505,26 @@ workflow:
           required: true
           # 前端: Vitest/Jest + coverage ≥80% | 后端: JUnit5/Mockito + JaCoCo ≥80%
           threshold: "coverage >= baseline (前端 Vitest / 后端 JaCoCo)"
+          frontend_specific:
+            framework: "Vitest 或 Jest"
+            component_test: "每个 .vue 组件必须有对应 .test.ts/.spec.ts 文件"
+            coverage_threshold: "branches ≥80%, functions ≥80%, lines ≥80%"
+            blocking: "无测试文件 → Gate FAIL"
+          backend_specific:
+            framework: "JUnit5 + Mockito"
+            service_test: "每个 Service 类必须有对应 Test 类"
+            coverage_threshold: "JaCoCo 行覆盖率 ≥80%, 分支覆盖率 ≥80%"
+            blocking: "无测试类 → Gate FAIL"
+        - name: "test_case_validation"
+          skill: "test-case-designer"
+          executor: "tester_agent"
+          required: true
+          # 验证开发阶段产出的测试用例文档与代码实现的覆盖对齐
+          threshold: "功能点测试用例覆盖 ≥ 90% 的验收标准"
+          validation_checks:
+            - "feature-points.md 文件存在且非空"
+            - "功能点测试用例与验收标准对齐"
+            - "代码中的单元测试覆盖测试用例中的关键场景"
         - name: "api_integration"
           skill: "test-api"
           executor: "tester_agent"

package/lib/index.mjs

@@ -3,6 +3,7 @@
  *
  * 多适配器架构：检测 AI 工具 → 转换规则格式 → 注入到对应位置
  *
+ * v1.12.5: 强制测试用例和前端单元测试验证 — workflow definition 增加 step 3.5 测试用例检查、E4/E5 审查项、fail_fast_conditions；Gate C3 测试用例文档检查、C4 前端组件测试覆盖、C5 后端 Service 测试覆盖；build-gates-frontend 增加 F-B6 前端单元测试执行、F-B7 组件测试文件检查
  * v1.12.4: 修复 Qoder commands 输出路径从扁平结构改为 commands/js/ 二级目录，与 codebuddy/cursor/trae 保持一致
  * v1.12.3: 新增 test-case-designer Skill（功能点/周期计划/专项计划三种测试用例模板）；修改 DDB-02 规则细化测试执行方案与测试用例设计边界；tester Agent 增加设计阶段测试用例编写职责
  * v1.12.1: 操作手册新增 8 张 Mermaid 可视化图表（三层约束架构图、jsspec三步流程图、标准流程总览图、Agent协作时序图、门禁检查流程图、init注入流程图、Agent调度架构图、交付物流转图）

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jsharness",
-  "version": "1.12.4",
+  "version": "1.12.5",
   "description": "Harness Engineering - AI 编程行为工程化管控系统。将 rules/skills/commands/agents 四桶一键注入到 CodeBuddy、Cursor、Copilot、Claude Code 等 AI 工具中。",
   "main": "lib/index.mjs",
   "bin": {