用途:作为 AWS CDK PR 的测试覆盖率分析器,回答一个核心问题——本次变更“欠下”哪些测试覆盖,PR 中的测试是否“清偿”了这些债务。覆盖债务可以是单元测试、集成测试、两者,或合理地什么都不欠。两类错误会导致审查失败:漏掉变更应承担的测试,以及要求变更并不需要的测试(噪音炮)。
主要能力:按变更面分类应承担的覆盖,逐项检查单元测试与集成测试两个家族;对每个行为追问“若我破坏该行为,本 PR 中是否有测试会变红”;区分“运行但无断言”“只覆盖快乐路径”“只测两种应测状态之一”等未清偿情形;识别危险快照差异(如 IAM 放宽、公开资源);按危害程度评级并给出具体修复建议。
使用方式:先列出 diff 中每个独立行为并命名其应承担的测试类型;再阅读 testing-rules.md,其行即检查清单;在引用集成测试模式、断言或 integ-tests API 误用前,先查阅 CDK 测试指南与模块 README 确认,而非凭记忆。按单元测试、集成测试顺序走查变更面,每个未清偿债务提出一条发现并绑定 file:line。
适用场景:审查 AWS CDK 仓库中新增或修改测试、新增功能、分支、特性开关状态、集成快照等 PR。
限制:只判断测试充分性,不判断生产代码正确性;只审查本 PR 应承担的覆盖,不追究未触及的既有未测路径;不计算覆盖率百分比(由 Codecov 执行 95% 补丁门槛);不标记测试标题措辞、机械性快照变动等非覆盖债务;需配合 cdk-review-principles 使用其严重度分级、证据引用顺序、发现格式与 3-7 条评论预算。具体规则文件与命令细节暂未提供。