Codecov 覆盖率分析工具
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_3c6cb52e/codecov-coverage-report-analyzer。
技能介绍
解决什么问题
覆盖率流程里最常见的问题,不是“没有测试覆盖”,而是报告格式分散、上传步骤不一致、发布或合并请求前缺少可执行的覆盖率判断。人工查看 lcov、cobertura、jacoco 的差异,也容易漏掉关键变化。这个技能面向这些工程化场景,把覆盖率上传、差异分析和阈值检查放进同一套围绕 Codecov 的工作流中。
核心能力
- 集成 Codecov API v2 与
codecov-cli:既能通过 API 处理覆盖率相关任务,也能在命令行环境中使用。 - 支持常见格式:覆盖
lcov、cobertura、jacoco三类覆盖率报告。 - 分析覆盖率差异:关注本次提交相对基线或上一版本的覆盖变化,便于定位新增代码是否被测试覆盖。
- 强制执行最低阈值:在流程中检查覆盖率是否达到设定下限,并用明确结果阻止不达标变更继续推进。
适用边界与注意点
它依赖 Codecov 服务、codecov-cli 和上游项目的实际配置。使用前需要满足上游要求:项目使用 Python 的代码覆盖率,测试通过 Docker 运行。如果你是 GitHub 用户,还必须为所在组织安装 Codecov GitHub 应用程序;没有该应用,Codecov 无法运行。该技能不替代账号、仓库权限、CI 配置或 Codecov 服务端规则,只负责把已有覆盖率数据接入分析和门槛检查流程。
使用场景
- 多语言项目的 CI 跑完后要把覆盖率上传到 Codecov,并让流水线按阈值自动拦截不达标构建
- 团队使用 lcov 生成覆盖率报告,需要在提交合并请求前分析新增代码的覆盖率差异
- Java 项目使用 jacoco 生成 cobertura 格式报告,要在发布前检查覆盖率是否达到设定下限
- 维护 Python 项目时需要把覆盖率上传到 Codecov,并处理 Docker 测试环境产生的报告
适合人员
- 负责 CI 流水线的 DevOps 工程师,需要让覆盖率门槛在构建阶段自动生效
- 编写 Python 服务并使用 Docker 测试的研发工程师,需要把覆盖率接入 Codecov
- 使用 jacoco 或 cobertura 的 Java 项目技术负责人,需要在发布前判断覆盖率是否达标
- 维护开源项目并使用 GitHub 仓库的开发者,需要配置 Codecov App 后分析提交差异