GitHub PR 覆盖率预览：把 AI 改代码接入覆盖率门禁

这篇解决什么

AI coding agent 很擅长快速改代码，但如果没有覆盖率反馈，团队很难判断它是不是只修了表面路径，漏掉了新增分支和边界条件。

适合谁

适合正在把 Agent 生成代码接入 GitHub Actions、PR review 和 CI 门禁的开发团队。

操作步骤

1. 先确认项目测试框架能输出 Cobertura XML 或兼容覆盖率报告
2. 在 GitHub Actions 中生成并上传覆盖率文件
3. 把覆盖率摘要显示到 PR，和单元测试结果放在一起看
4. 要求 AI 改动涉及新逻辑时补对应测试
5. 对覆盖率下降设置人工解释或阻塞条件
6. 定期清理无效测试，避免覆盖率数字虚高

可复制模板

测试框架：
覆盖率格式：Cobertura XML
上传步骤：
最低阈值：
下降解释：
阻塞条件：

验收清单

• CI 能生成覆盖率报告
• PR 能看到覆盖率摘要
• AI 改动补了测试
• 覆盖率下降有解释
• 数字没有替代人工评审

常见错误

• 只收藏产品更新，没有改成自己的任务卡、权限表和验收证据。
• 直接在生产账号、生产仓库或公开页面试新功能，没有先跑低风险样本。
• 只看工具能力，不记录成本、失败率、人工接管次数和恢复动作。
• 把外部链接当正文主体，读者离开页面后才知道怎么做。

30 分钟小样本

前 5 分钟写清输入、目标和风险边界；中间 15 分钟按步骤跑一个低风险样本；最后 10 分钟记录输出、失败点、人工修改量和下一次复用条件。样本不通过时，只修失败点，不扩大范围。

发布建议

第一次执行时把它当成个人操作卡；第二次复用时沉淀为团队模板；第三次仍然稳定后，再升级为固定 SOP、Skill 或工具导航页。涉及账号、发布、删除、付费、生产代码和客户数据的动作，必须保留人工确认点。

资料依据

• GitHub Docs / Setting up code coverage for your repository / 2026-05

标签