关于 test-coverage-improver
Test Coverage Improver 是一项依据当前覆盖率证据查找测试缺口的开发技能,并可在获准后实施限定范围的改进。它优先关注调用方可见行为,并要求最终测量覆盖率和验证。
主要功能
- 01评估当前覆盖率证据
- 02查找调用方可见行为的缺口
- 03获准后添加限定范围测试
- 04执行最终覆盖率测量与验证
适用场景
- 01调查覆盖率回退
- 02识别缺失的行为测试
- 03实施已批准的测试改进
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ openai/ openai-agents-python --skill test-coverage-improver安装后在 Claude Code 中输入/test-coverage-improver确认已加载。
附带文件agents/openai.yaml
详细介绍
测试覆盖率改进器
利用当前的覆盖率证据,找出缺失的、面向调用方可见行为的测试。当需要进行覆盖率测量、覆盖率指标回归,或从覆盖率产物中查找缺口时,请选择此工作流。如果用户已经明确指定了要测试的行为,则使用常规的实现/审查工作流,除非同时明确要求进行测量,否则不做覆盖率测量。仅添加测试本身不会触发此技能,也不会触发最后的 make coverage 步骤。
范围与授权
对于评估或仅提案类请求,应报告缺口和建议的测试,但不做编辑。当用户要求改进测试或已批准计划时,应实现范围内的测试,并完成审查与验证,无需再次询问。仅当需要新的契约决策、扩大范围或额外授权时才提出询问。覆盖率工作不授权进行实时 API 调用,也不授权更广泛的沙箱访问。
工作流
- 检查当前的
.coverage、coverage.xml以及已记录的命令/环境证据。仅当它们代表相关的源码和测试状态时才复用。如果缺失或已过时,则在仓库的验证沙箱和凭证策略下运行make coverage;此初始测量先于实现审查。在进行大范围测量前,请遵守主机容量相关的指引。 - 在请求的范围内识别未覆盖的行为。优先关注公共行为,以及有意义的错误、取消和生命周期路径,而不是仅以百分比为目标。使用
uv run coverage report -m或coverage.xml定位缺口。 - 对于评估任务,报告证据和拟定的测试场景。对于已授权的实现任务,应选择具有独立预期结果、位于可控的最高调用方边界上的测试。不要添加仅重复辅助逻辑或枚举不受支持排列组合的测试。
- 实现测试,运行受影响的检查,并完成
$implementation-final-review。迭代验证应保持聚焦;在审查未完成时,不要反复运行完整的覆盖率测量。 - 审查通过后,运行
make coverage进行最终测量,并运行$code-change-verification以通过所需的 SDK 门禁。两者目的不同;若已有有效的最终测量结果,则应复用,而不是重复执行。报告覆盖率变化、已验证的行为以及仍然存在的重大缺口。
报告
说明覆盖率证据的范围和时效,每个新增测试所保护的行为,验证结果以及尚未解决的缺口。注释和代码保持英文。不要仅凭覆盖率百分比来证明代码的正确性。
评论
支持 Markdown