incremental-coverage

增量代码覆盖率 (Agent Skill)

仅针对当前开发周期（分支、提交范围或工作区）中变更的文件收集、过滤并报告代码覆盖率。 通过将范围限定为增量变更，避免全量覆盖率的成本和噪声。

适用场景

• 功能实现后验证测试覆盖率（TDD 第 7 步）
• 为 Pull Request 或代码评审提供覆盖率证据
• 检查新增/修改代码是否有充分的测试覆盖
• 在 implement 技能完成后或 springboot-verification 中作为质量门禁
• 合并功能分支前验证覆盖率达标

不适用场景

• 为项目搭建初始覆盖率工具链（应使用 cpp-testing、python-testing、golang-testing 或 rust-testing）
• 运行全量项目覆盖率基线（本技能仅关注增量范围）
• 调试失败的测试（应使用对应语言的测试技能）
• 没有测试基础设施的项目

核心概念

• 增量范围：仅与基准引用（默认 origin/master 或 origin/main）相比新增或修改的文件。
• 流水线模型：识别 → 插桩 → 测试 → 提取 → 报告。每步独立，可单独重跑。
• 语言适配器：流水线对所有语言通用，仅工具命令按语言切换。
• 覆盖率阈值：增量文件默认 80% 行覆盖率，可配置。
• 源文件过滤：收集全量运行数据后，过滤仅展示增量源文件（排除测试文件本身）。

流水线步骤

步骤 1：识别增量文件

确定哪些源文件（非测试文件）被新增或修改。

# 确定基准引用
BASE=$(git merge-base HEAD origin/master 2>/dev/null || git merge-base HEAD origin/main 2>/dev/null)

# 收集变更的源文件（排除测试文件和生成文件）
CHANGED_FILES=$(git diff --name-only --diff-filter=AM "$BASE" HEAD | \
  grep -E '\.(cpp|cxx|cc|c|h|hpp|java|py|go|ts|js|tsx|jsx|rs)$' | \
  grep -v -E '(test|spec|_test|_spec|Test|Spec)' | \
  grep -v -E '(vendor|node_modules|build|dist|__pycache__|target|\.generated\.)')

# 同时包含未跟踪的新文件
UNTRACKED=$(git ls-files --others --exclude-standard | \
  grep -E '\.(cpp|cxx|cc|c|h|hpp|java|py|go|ts|js|tsx|jsx|rs)$' | \
  grep -v -E '(test|spec|_test|_spec|Test|Spec)')

# 合并去重
ALL_CHANGED=$(echo -e "${CHANGED_FILES}\n${UNTRACKED}" | sort -u | sed '/^$/d')

echo "增量源文件："
echo "$ALL_CHANGED"
echo "---"
echo "合计：$(echo "$ALL_CHANGED" | wc -l) 个文件"

决策点：若 ALL_CHANGED 为空，输出"未检测到增量源文件，覆盖率检查不适用"并正常退出。

步骤 2：检测语言并选择适配器

检测项目的主要编程语言，选择对应的覆盖率工具。

识别标志	语言	覆盖率工具	插桩方式
CMakeLists.txt 或 *.cmake	C/C++ (GCC)	gcov + lcov	-DENABLE_COVERAGE=ON 或 --coverage
CMakeLists.txt + clang++	C/C++ (Clang)	llvm-cov	-fprofile-instr-generate -fcoverage-mapping
pom.xml 或 build.gradle	Java	JaCoCo	Maven: jacoco-maven-plugin；Gradle: jacoco 插件
setup.py、pyproject.toml、requirements.txt	Python	pytest-cov	pytest --cov
go.mod	Go	go test -coverprofile	go test -coverprofile=coverage.out
package.json（含 jest 或 vitest）	JS/TS	Jest/Vitest --coverage	--coverage --coverageReporters=text
Cargo.toml	Rust	cargo-llvm-cov	cargo llvm-cov