"这个 PR 的测试够不够?"是最难回答的评审问题之一——行覆盖率 90% 可能全是测了 getter,关键错误分支一条没碰。pr-review-toolkit 插件里的 pr-test-analyzer Agent 把这个问题工程化了:专审 PR 的测试覆盖质量,聚焦行为覆盖而非行覆盖,对每个缺口给出 1~10 关键度评分——同时明确反对"100% 覆盖的学究式追求"。本文按"定位 → 覆盖分析框架 → 评分体系 → 提示词工艺 → 总结"拆解这份官方 Agent 定义。
1、定位:务实的测试覆盖分析师
提示词开篇定义人设:"expert test coverage analyst specializing in pull request review",核心职责一句话说清——确保 PR 对关键功能有足够测试覆盖,同时对 100% 覆盖率不做学究式强求。这个"既要严格又反学院派"的双重定位贯穿全文,是这个 Agent 最鲜明的性格。
frontmatter 照例是 model: inherit 加 color: cyan,description 列了三类触发时机:新 PR 开出后检查测试是否充分、PR 更新新增逻辑后做覆盖分析、标记 ready 前的最后一道覆盖复核。三类场景对应开发流程的三个节点,宿主模型据此自动派活。
内嵌的三个代表性场景(When to invoke)也很具体:新 PR 彻底性检查、PR 新增校验 / 解析 / 业务逻辑后的分支覆盖检查、pre-ready 终审——与 comment-analyzer 的场景化触发手法一致。
2、四维分析框架
核心职责被组织成四块,从"看什么"到"怎么判"层层递进。
- 分析测试覆盖质量——聚焦行为覆盖而非行覆盖:识别必须测试才能防回归的关键代码路径、边界条件与错误条件。这句"行为优先"是整个框架的定盘星,直接否定了拿行覆盖率当目标的做法
- 识别关键缺口——五类高价值猎物:可能导致静默失败的未测错误处理路径、边界条件的缺口、未覆盖的关键业务分支、校验逻辑缺失的反向用例、相关的并发或异步行为缺测
- 评估测试质量——四个判断:测的是行为与契约还是实现细节、未来代码变更时能否抓住有意义的回归、对合理重构是否有韧性、是否遵循 DAMP 原则(Descriptive and Meaningful Phrases,描述性且有意义的表述)
- 优先级排序——每个建议的测试都要给:它能抓住的具体失败示例、1~10 关键度评分、它防住的具体回归或 bug、现有测试是否已覆盖该场景
3、十级评分体系
这个 Agent 最具辨识度的设计是把"测试缺口"量化成十级量表:
| 评分 | 定级 | 判定内容 |
|---|---|---|
| 9-10 | 关键 | 可能导致数据丢失、安全问题或系统故障的功能 |
| 7-8 | 重要 | 可能造成用户可见错误的关键业务逻辑 |
| 5-6 | 边缘 | 可能引起困惑或小问题的边界情况 |
| 3-4 | 锦上添花 | 完整性补充 |
| 1-2 | 可选 | 次要改进 |
输出格式与评分挂钩:Critical Gaps 只收录 8~10 分的必加测试,Important Improvements 收 5~7 分的建议项,另设 Test Quality Issues 板块点名"脆测"(与实现过耦合、重构即碎),最后是 Positive Observations 树立好测试标杆——分级呈现加正面示范,与同插件的 comment-analyzer 输出契约同构。
评分体系的价值在于把评审争议变成量表对话:说"测试不够"是主观的,说"这个缺口 9 分因为它防数据丢失"是可以讨论的。团队可以据此约定阈值——比如"合并前所有 8+ 缺口必须清零"——把 Agent 报告直接接入 CI 门禁。
4、务实倾向与提示词工艺
提示词的"Important Considerations"一节集中体现了反学院派立场,值得逐条看:
- 聚焦防真实 bug 的测试,而非学术完整性
- 项目测试标准从 CLAUDE.md 读取(如有)
- 部分路径可能已被既有集成测试覆盖——不要重复建议
- 无逻辑的简单 getter/setter 不建议测试
- 每个建议考虑成本收益
- 说清每个测试该验证什么、为什么重要
- 点名"在测实现而非行为"的测试
结尾的定调句尤其好:"good tests are those that fail when behavior changes unexpectedly, not when implementation details change"——好测试在行为意外变化时失败,而不是在实现细节变化时失败。一句话把整个 Agent 的价值观收拢。
提示词工艺上,这个定义展示了"量表化"手法:把模糊的质量判断拆成可操作的十级评分加每级判例,让模型的输出天然结构化、可比较、可门禁化。相比让模型自由发挥的"评估测试质量",量表把输出方差压到最低——这是高质量评审类 Agent 提示词的共同特征,值得自建 Agent 时借鉴。
5、总结
pr-test-analyzer 是官方 pr-review-toolkit 插件的测试覆盖审计 Agent:以行为覆盖为核心框架,五类关键缺口为猎物清单,十级评分量化每个建议,输出按评分分档(Critical / Important / Quality Issues / Positive);贯穿始终的务实立场——反对 100% 覆盖迷信、考虑成本收益、拒绝测实现细节的脆测——让它更像一位资深测试负责人而非覆盖率工具。
它适合接入 PR 流程的三个节点:新 PR 初审、逻辑更新后的增量检查、ready 前终审。用法上装好插件后自然语言触发即可("看看这个 PR 的测试够不够")。边界方面:评分是模型主观判断,重要项目建议人工复核 8+ 分项的定性理由;它分析测试但不写测试——补测试的活儿留给宿主或专门的测试生成工具;并发与异步覆盖的判断依赖代码可见性,跨仓库的集成测试盲区它无法感知。对"测试到底够不够"这个评审高频难题,这份官方提示词提供的答案是:用量化评分替代拍脑袋,用行为覆盖替代行覆盖率。


