pytest + uv 现代 Python 测试技能 — abdullahmalik17-pytest-mastery

技能简介

abdullahmalik17-pytest-mastery 是一款面向 Python 团队的测试工程技能，让 Claude、Codex、Claude Code 在写测试、跑测试、查覆盖率时遵循统一且现代的工作流——pytest 负责测试框架，uv 负责极速的环境与包管理。很多 AI 生成的 Python 测试存在同样的毛病：命令跑法不统一、fixture 乱用、FastAPI 接口测试缺依赖覆盖、把慢集成塞进单元测试。这个技能把 pytest 的发现规则、fixture 体系、参数化、FastAPI 测试模式以及 uv 命令行完整沉淀下来，还附带一个覆盖快速 / 全量 / 覆盖率 / 失败重跑 / 观察模式的辅助脚本，让 Agent 产出的测试从第一天起就符合工程规范。Skillstore 质量评分 80 分（silver 档），riskLevel 为 safe，MIT 许可，页面浏览 214 次、安装 26 次、收藏 1 次，是本批候选中热度最高的技能之一。

核心能力

• uv + pytest 命令体系：给出全量跑、单文件跑、单用例跑、按表达式过滤、生成覆盖率报告等场景的标准命令，全部基于 uv 执行。
• 测试发现规则讲解：解释 pytest 如何发现测试文件、测试函数、测试类与类方法，减少"写了但没被收集"的困惑。
• fixture 体系示范：覆盖 setup / teardown、fixture 作用域、多测试共享的 conftest.py 组织方式。
• 参数化测试：对同一行为跨多组输入的断言给出参数化写法，避免复制粘贴式测试。
• FastAPI 测试模式：包含 TestClient、异步客户端、数据库 fixture、依赖覆盖（dependency overrides）与认证测试的完整套路。
• 辅助脚本：内置常用模式一键切换——quick、full、coverage、failed、watch 式过滤，团队成员执行口径一致。

安装配置

1. 环境前置：Python 项目已引入 uv（未引入可先安装 uv），并准备 Claude、Codex 或 Claude Code 任一客户端。
2. 一键安装：执行 npx skillstore add abdullahmalik17/pytest-mastery，技能会写入本地 .claude/skills/ 或对应客户端的技能目录。
3. 项目挂载：在目标 Python 仓库根目录使用技能，使其能结合实际目录结构给出建议。
4. pytest 配置对齐：按技能指引检查 pyproject.toml 中的 pytest 选项（测试路径、markers、覆盖率配置），与团队口径保持一致。

使用步骤

1. 先跑起来：用"Run my pytest suite"模板让 AI 以 uv 运行标准的 verbose 命令，失败时用通俗语言解释原因。
2. 为模块补测试：套用"Write tests for a module"模板，产出测试文件与必要 fixture，并给出只跑新增测试的 uv 命令。
3. 测 FastAPI 接口：用"Test a FastAPI endpoint"模板生成 TestClient 或异步测试，含依赖覆盖与成功 / 校验错误两类断言。
4. 制定完整测试计划：用"Design a complete test plan"模板，让 AI 输出覆盖 fixture、参数化、异步测试、数据库准备、覆盖率目标与 pytest 配置的方案。
5. 小步验证：按"最小相关目标优先"原则先跑新增测试，任务收尾前再跑全量套件。
6. 对照反模式自查：检查是否滥用 skip / xfail、是否在单元测试里塞了慢集成、是否把覆盖率数字当成质量证明。

适用场景

• 新功能补测试：为 Python 新代码快速生成 pytest 文件、fixture 与参数化用例。
• FastAPI 接口验证：验证接口的成功响应、参数校验、认证与错误分支。
• 测试基建改造：把散落的测试命令统一为 uv + pytest 标准流程。
• CI 测试提速：利用 uv 的快速解析安装与定向测试命令，缩短流水线时长。
• 测试规范培训：把 fixture / 参数化 / 反模式清单作为团队测试规范教材。

适用人群

• Python 后端开发者：日常写测试、跑测试的主力人群。
• FastAPI 项目维护者：需要系统化接口测试的团队。
• 测试 / 质量工程师：负责测试规范与覆盖率治理。
• Tech Lead：希望统一团队测试口径与 CI 命令。
• AI 编程代理重度用户：让 Claude / Codex 生成的测试直接符合工程标准。

工作原理

技能是一份结构化的测试知识库 + 提示词模板 + 辅助脚本组合，不修改你的业务代码。当 AI 代理接到测试任务时，按技能定义的路径工作：先用 uv 定向运行相关测试建立基线，再依据 pytest 的发现规则生成可被收集的测试文件；写 fixture 时遵循"多测试真正共享的 setup 才抽成 fixture"原则；同一行为的多组输入用参数化展开；FastAPI 场景走 TestClient / 异步客户端 + 依赖覆盖的标准模式。产出后对照反模式清单自检，最后给出覆盖率报告但明确标注"覆盖率不等于测试充分"。技能同时声明了自己的边界：只覆盖 pytest 与 uv（不含 unittest、tox、nox），FastAPI 示例用简化数据、生产认证与数据库层需要自行适配。

官方链接

• Skillstore 详情页：
• GitHub 仓库：
• 一键安装：npx skillstore add abdullahmalik17/pytest-mastery
• Manifest：