用途:检查并配置测试框架的代码覆盖率阈值与报告,适用 Vitest、Jest、pytest 和 Rust。命令为 /configure:coverage,可解析参数 --check-only(仅报告合规状态)、--fix(自动修复)、--threshold <percentage>(设置阈值,默认 80%,覆盖行、分支、函数、语句)。
主要能力:检测测试框架与覆盖率工具;分析配置完整性,覆盖项包括 provider、reporters(text、json、html、lcov)、输出目录、排除项;检查阈值设置;检查 CI/CD 覆盖率上传与产物存储;生成格式化的合规报告。支持框架及工具:Vitest 使用 @vitest/coverage-v8 或 @vitest/coverage-istanbul,Jest 使用内置 --coverage,pytest 使用 pytest-cov,Rust 使用 cargo-llvm-cov 或 cargo-tarpaulin。
使用方式:在项目根目录执行 /configure:coverage;加 --check-only 仅检查不修改,加 --fix 自动应用修复,加 --threshold 90 设置自定义阈值。修复时会安装覆盖率 provider、更新配置文件(阈值、reporters、排除项)、添加脚本、配置 CI/CD 的 Codecov 上传和产物存储,并更新 .project-standards.yaml 记录(含 standards_version、last_configured、coverage_threshold、coverage_provider、coverage_reporters、coverage_ci)。
适用场景:为 Vitest/Jest/pytest/Rust 设置覆盖率阈值;配置 text、JSON、HTML、lcov 报告;为 CI/CD 添加 Codecov 或 Coveralls 集成;审计项目覆盖率配置合规性;调整覆盖率阈值百分比。
限制与注意:不适用于配置测试框架本身(应使用 /configure:tests)、运行测试(/test:coverage)、分析测试失败或编写单个测试用例、配置通用 CI/CD 工作流(/configure:workflows)。错误处理:未检测到测试框架时建议先运行 /configure:tests;缺少覆盖率 provider 时提示安装;阈值小于 0 或大于 100 会被拒绝;缺少 CI token 时会警告 Codecov/Coveralls 配置。详细配置模板见 REFERENCE.md,Codecov 文档 https://docs.codecov.com,pytest-cov 文档 https://pytest-cov.readthedocs.io。