用途:test-standards 用于在 QA 流程中校验测试质量,识别“看似通过但实际未验证行为”的测试反模式,适合在评审测试文件改动、Action Agent 修改测试后、批准合并前,以及创建或维护测试时使用。
主要能力:自动扫描可检测无断言、同义反复断言(如 expect(true).toBe(true))、空洞属性检查、仅验证 mock 调用、缺少 expect.assertions(n) 的异步保护、吞错 catch 块、断言密度过低、happy-path 偏置等。扫描输出 JSON,包含文件数、测试数、按严重级别分类的发现项与测试统计。严重级别中 CRITICAL 包括无断言与同义反复断言,应立即阻止合并;HIGH 包括空洞检查、仅 mock 验证、吞错,需修复;MEDIUM 包括 happy-path 偏置、缺少断言计数、低密度,需审查说明;LOW 为可选修复。
使用方式:先运行确定性脚本,再结合 LLM 启发式判断。扫描指定文件:python scripts/test_quality_scanner.py tests/auth.test.ts tests/api.test.ts --format json;扫描目录:python scripts/test_quality_scanner.py ./tests --format json;保存报告:python scripts/test_quality_scanner.py ./tests --output test-quality-report.json;排除模式:python scripts/test_quality_scanner.py ./tests --exclude node_modules .snapshots --format json。随后解析 JSON,按严重级别评估,并用启发式审查断言弱化、范围对齐与覆盖缺口,最后生成含 file:line 引用的验证报告,给出 APPROVED、CHANGES REQUIRED 或 BLOCKED 结论。
适用场景与限制:适用于 QA 变更评审与测试维护,CRITICAL 发现必须阻止合并,合理例外需在测试注释中说明。详细模式与示例见 references/test-quality-patterns.md。资料未提供安装方式、收费、平台支持与效果数据。