1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | pytest-skill-lambdatest-agent-skills |
| 作者/维护者 | TestMu AI(原 LambdaTest) |
| 来源链接 | https://github.com/LambdaTest/agent-skills/tree/main/pytest-skill |
| 许可证 | MIT(数据来自 GitHub API) |
| GitHub Stars | 352(数据来自 GitHub API;为整个合集仓库总量,不代表本技能自身热度) |
| Forks | 69(数据来自 GitHub API,同为合集整体口径) |
| 最新版本 | 1.0(SKILL.md front matter 自述,仓库未发布正式 Release) |
| 安装方式 | 见第 10 章 |
2. 功能介绍与亮点
为 pytest(Python 生态最主流的测试框架)生成生产级测试代码的技能:把“断言写法随意、Mock 与 Fixture 用法各写各的”变成“按同一套规范产出可维护的 Python 测试”。
- 核心语法全覆盖:基础断言与异常测试(
pytest.raises)、Fixture(基础/作用域 session·module/工厂模式/autouse/conftest.py共享)、参数化测试(基础/笛卡尔积组合/自定义 ID/间接参数化)、标记系统(自定义 Marker、按标记筛选运行、skip/skipif)、Mock(pytest-mock、unittest.mock.patch、monkeypatch、Spy、异步 Mock)均给出可直接套用的代码示例。 - 反模式对照表:把“能跑但写法差”和“规范写法”并排列出并说明原因(如
self.assertEqual()vsassert x == y、全局状态 vsyieldFixture 清理),帮初学者少踩坑。 - 速查命令表:
pytest -k(按关键词过滤)、-m(按标记过滤)、--lf(只跑上次失败用例)、--cov(覆盖率)、-n auto(并行,需 pytest-xdist)等 10 条常用命令一览。 - 深度 Playbook:配套参考文档含 11 个专题,覆盖生产级配置(
pytest.ini/pyproject.toml含 Marker 声明与覆盖率阈值)、Fixture 深挖(作用域/工厂/autouse/tmp_path)、参数化四种形态、pytest-mock与环境变量 Mock、异步测试(pytest-asyncio)、异常与警告测试、自定义插件与报告头、类组织方式、GitHub Actions CI 矩阵配置、10 项调试排错对照表与 15 条生产最佳实践清单,SKILL.md + 两份参考文档合计约 21.8 KB。 - 纯参考文档形态:子目录仅含 SKILL.md 与两份 Markdown 参考文档,不含任何可执行脚本,也不涉及任何第三方账号或凭据。
3. 适用场景
所属分类:工程效率与代码质量
已掌握 Python 基础、想让 AI 编码助手按统一规范写出 pytest 单元测试(含 Fixture、参数化、Mock、异步测试)的初中级 Python 开发者;也适用于团队想把测试写法(断言选择、Fixture 作用域、Mock 库选型)标准化、减少 Code Review 中反复纠正测试写法成本的场景。不依赖 TestMu AI 云端服务,纯本地可用。
4. 跨 Agent 兼容性
- Claude Code:✅ 原生支持。SKILL.md 采用标准 Agent Skills 格式,仓库 README 给出配套的官方安装工具。
- Codex:❓ 未验证——仓库 README 列出的受支持助手为 “Claude Code, Copilot, Cursor, Gemini CLI”,未点名 Codex。
- OpenClaw:❓ 未验证——已抓取材料未提及。
- Hermes Agent:❓ 未验证——已抓取材料未提及。
5. 推荐理由
一份技能讲全 pytest 从基础断言到 Fixture 深挖、四种参数化形态、标记系统、多种 Mock 手法的规范写法,附反模式对照表、10 项调试排错表与 15 条最佳实践清单帮助少走弯路,核心路径零付费依赖、子目录不含任何脚本,安全面干净。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | TestMu AI(原 LambdaTest)是该领域公认的一线测试云平台:累计融资 1.08 亿美元(8 轮,最近一轮 2024 年 Avataar Venture Partners 领投的 3800 万美元 C 轮),18,000+ 企业客户(含 Microsoft、OpenAI、Nvidia),Forbes 2026-01-12 有专文报道。合集仓库整体 352 stars 属整个合集,不代表本技能自身热度,未查到本技能自身的独立第三方评价 |
| 可用性 | 8 | 核心功能零配置、零付费依赖,复制即用(pytest 为 Python 生态标配工具);文档完整含 11 个专题示例,覆盖生产级配置到 CI 集成与调试排错;子目录最后提交约 5.7 个月前,未见归档或功能性问题 |
| 安全性 | 9 | 子目录不含任何脚本或可执行文件,仅 SKILL.md 与两份 Markdown 参考文档;逐份扫描未见可疑指令或隐藏外发;全文未出现任何第三方账号、API Key 或凭据要求;License(MIT)明确 |
安全检查清单:① Shell 命令——无,不含 scripts/;② 联网外发——纯本地生成测试代码,无任何外发行为;③ 凭据——不涉及,本技能不依赖任何第三方账号或 API Key;④ 可疑指令——未发现;⑤ 作者信誉——TestMu AI,融资/客户量/媒体报道均可查证,良好;⑥ License——MIT,明确;⑦ 最近维护——约 2026-02-23,约 5.7 个月前,未见归档。
7. 跟同类 Skills 相比的优势
| 同类项目 | 定位 | 与本技能的差异 |
|---|---|---|
| python-testing-patterns-wshobson-agents | 通用 Python 测试实践指南,强调测试哲学与进阶集成场景(AAA 结构、测试分类、基于 Hypothesis 的属性测试、SQLAlchemy 数据库测试、freezegun 时间冻结测试) | 更偏“该怎么设计测试策略与集成第三方库”;本技能更偏“pytest 本身的语法与 API 怎么用”(Marker 系统、四种参数化形态、调试排错表、反模式对照表均为本技能独有),两者覆盖面互补,可配合使用 |
| jest-skill-lambdatest-agent-skills | 同池姊妹技能,面向 JavaScript/TypeScript 生态的 Jest | 服务 JS/TS 项目;本技能服务 Python 项目,两者面向不同技术栈,非直接竞争关系 |
| vitest-skill-lambdatest-agent-skills | 同池姊妹技能,面向 Vitest(Vite 原生测试运行器) | 同为 JS/TS 生态,与本技能面向的 Python 生态不重叠 |
| mocha-skill-lambdatest-agent-skills | 同池姊妹技能,面向 Mocha + Chai + Sinon 组合 | 同为 JS/TS 生态,与本技能面向的 Python 生态不重叠 |
核心差异化在“pytest 生态自身的语法广度与排错实用性”:标记系统、间接参数化、pytest-mock 专项用法、10 项调试排错对照表与 15 条生产最佳实践清单是本技能独有内容,配合反模式对照表可以直接纠正常见的“能跑但不规范”写法,对已决定用 pytest 但想把写法规范化的开发者针对性更强。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价;LambdaTest/agent-skills 仓库整体在 GitHub 上有真实的多贡献者协作记录。
9. 其他补充
- 支持语言:Python。
- Mock 一节区分了
pytest-mock(mockerfixture)、标准库unittest.mock.patch、monkeypatch三种手法各自的适用场景,避免混用造成的语义混乱。 - 调试排错表覆盖 fixture 未找到、异步测试挂起、参数化 ID 冲突等 10 个常见报错场景及对应修复方法,对初学者定位问题较有帮助。
10. 安装使用方式
方式一:官方 CLI(仓库推荐)
git clone https://github.com/LambdaTest/agent-skills && cd agent-skills
npx agentskillsforall add https://github.com/LambdaTest/agent-skills.git --skill pytest-skill
方式二:手动复制(本技能不含任何脚本,直接复制目录即可)
git clone https://github.com/LambdaTest/agent-skills
cp -r agent-skills/pytest-skill ~/.claude/skills/
安装后注意事项:复制到位后无需重启、无需注册任何账号,Agent 会在识别到 “pytest”、“conftest”、“@pytest.fixture”、“@pytest.mark” 等触发词时自动读取本技能内容。
11. 注意事项
- 本技能面向“已经决定用 pytest”的 Python 项目;示例中的
pytest-mock、pytest-asyncio、pytest-xdist等均为第三方插件,需按需自行pip install。 - 内容聚焦 pytest 语法与 API 本身,测试策略层面的问题(如该写单元测试还是属性测试、数据库测试该怎么隔离)需要结合 python-testing-patterns 一类的方法论技能。
- 子目录最后提交约在 2026-02-23,约 5.7 个月前,暂未发现功能性问题,但关注长期维护节奏的团队可留意后续更新频率。