1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | pytest-coverage-github-awesome-copilot(SKILL.md 内 name 为 pytest-coverage) |
| 作者/维护者 | GitHub awesome-copilot 合集;子技能由社区贡献者 pamelafox 于 2025-11-15 以提示词形式提交(PR #396),后转换为 SKILL.md |
| 来源链接 | https://github.com/github/awesome-copilot/tree/main/skills/pytest-coverage |
| 许可证 | MIT(合集仓库 LICENSE,版权人 GitHub, Inc.;数据来自 GitHub API) |
| GitHub Stars / Forks | 所属合集仓库整体 39,715 / 5,060(GitHub API);该数字属整个合集,不代表本技能自身热度 |
| 第三方装机量 | skills.sh 显示约 12.8K 次安装(网页抓取) |
| 最新变更 | 2026-02-24(子目录最近一次提交) |
| 安装方式 | npx skills add https://github.com/github/awesome-copilot --skill pytest-coverage,或复制子目录到 skills 目录 |
2. 功能介绍与亮点
一份约 1.1KB 的“把 pytest 覆盖率补到 100%“技能:让 agent 跑覆盖率、找出没被测到的行、补测试,循环直到全部覆盖。
- 用带标注的报告定位漏测行:用
pytest --cov --cov-report=annotate:cov_annotate生成逐文件标注源码,行首为!的就是未覆盖行 - 按模块或按测试文件缩小范围:给出了整库、单模块(
--cov=模块名)、单个测试文件三种命令写法 - 只读有缺口的文件:覆盖率已 100% 的文件直接跳过,agent 只打开仍有
!的文件 - 闭环迭代:补一轮测试、再跑一轮,直到所有行覆盖
- 纯提示词技能:只有一个 SKILL.md,无脚本、无附带文件
3. 适用场景
所属分类:工程效率与代码质量。
- 已有 pytest 测试、但覆盖率不高的 Python 项目,想让 agent 系统性补漏
- 合并前被 CI 的覆盖率门槛卡住,需要快速补齐缺口
- 接手遗留 Python 代码,想先摸清哪些行完全没测过
- 初中级用户:不熟悉
pytest-cov报告怎么读、该从哪里下手补
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 标准 SKILL.md(name / description),放入 skills 目录即可;需要能在项目里执行 shell 命令 |
| Codex | 需适配 | 同为 SKILL.md 格式,但 Codex 不自动发现该目录,需手动引用 |
| OpenClaw | 未验证 | 格式兼容,未实测 |
| Hermes Agent | 未验证 | 格式兼容,未实测 |
5. 推荐理由
补覆盖率是最机械、也最耗时的测试工作:跑报告、找漏行、写用例、再跑。这个技能把这套循环压成几条命令和一个明确的收敛目标,agent 能自己跑完整个闭环,用户只需审阅新增的测试。它在 skills.sh 上累计装机约 12.8K 次,不需要账号或密钥,适合已经在用 pytest、想快速把覆盖率拉上去的初中级 Python 开发者。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | skills.sh 累计约 12.8K 次安装;所属合集约 3.97 万 stars,但属整个合集;具名第三方评价未找到 |
| 可用性 | 7 | 命令现成、复制即用;但正文只有约 1.1KB,没有示例输出,没提示需先安装 pytest-cov,且子目录最近一次变更为 2026-02-24,已超过 6 个月 |
| 安全性 | 8 | 会在项目里执行 pytest(即运行你自己的测试代码),范围明确、可审计;无联网、无凭据;MIT;skills.sh 上三项独立安全审计均通过 |
综合 = 三项均值 = 7.33。
安全检查清单:① 执行 shell 命令:仅限 pytest 及其覆盖率选项,范围明确(扣 1 分:测试代码本身会被运行) ② 不外发数据 ✅ ③ 不要求凭据 ✅ ④ SKILL.md 无可疑指令、无夹带推广 ✅ ⑤ 贡献者为个人开发者账号,合集由 GitHub 官方仓库托管 ✅ ⑥ MIT 明确 ✅ ⑦ 合集仓库近期仍在更新,本子目录自 2026-02 起未再变动,属小幅扣分项。
7. 跟同类 Skills 相比的优势
| 技能 | 定位 | 与本技能的差异 |
|---|---|---|
wshobson/agents 的 python-testing-patterns |
pytest 基础到异步、Mock、属性测试的实战模式指南 | 讲“怎么写好测试”;本技能讲“怎么用覆盖率报告系统性补漏” |
LambdaTest 的 pytest-skill |
pytest 生产级速查手册(fixture、参数化、Mock、调试排错),偏云测试平台生态 | 是写法速查;本技能是围绕覆盖率的闭环工作流 |
Trail of Bits 的 coverage-analysis |
面向模糊测试 harness 的覆盖率分析方法论 | 面向安全工程与 LLVM/GCC/Rust 工具链;本技能面向日常 Python 单元测试 |
直接用 pytest-cov + CI 门槛 |
只报数字、拦截不达标的提交 | 不会自己补用例;本技能让 agent 读标注报告并补测试 |
核心差异:目标单一(补覆盖率到 100%),命令现成,闭环自洽。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价。可核实的第三方信号是 skills.sh 累计约 12.8K 次安装,以及三项独立安全审计全部通过。
9. 其他补充
- 所属合集 github/awesome-copilot 为 GitHub 官方维护的社区合集,技能由社区贡献者提交
- 该技能最初是 2025-11 提交的 Copilot 提示词,2026-02 随合集统一转为 SKILL.md 格式,内容本体未变
10. 安装使用方式
npx skills add https://github.com/github/awesome-copilot --skill pytest-coverage
或把 skills/pytest-coverage 目录复制到 ~/.claude/skills/pytest-coverage。项目需先装好 pytest 与 pytest-cov(pip install pytest pytest-cov)。装好后对 agent 说“把这个项目的 pytest 覆盖率补到 100%“即可触发。
11. 注意事项
- 技能没有说明依赖,需自行安装
pytest-cov;没有现成测试的项目需先有可运行的 pytest 用例 - 100% 行覆盖不等于测试质量高,agent 补出的用例可能只是“走一遍代码”,建议人工审阅断言是否有意义
- 会生成
cov_annotate目录,建议加入.gitignore - 子目录自 2026-02-24 起未更新;pytest 覆盖率用法稳定,时效风险较低
- Codex 需手动引用该目录,不会自动发现