К основному содержанию
скилл CX Codex

pytest-code-review — скилл для Claude Code: что делает и установка

Скилл pytest-code-review проверяет тесты pytest на корректность асинхронных вызовов, скоуп фикстур, параметризацию и пути для моков. Помогает находить утечки и ошибки патчинга до запуска CI.

Apache-2.0 239 установок ★ 89 обновлён 2026-09-15

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add existential-birds/beagle --skill pytest-code-review -a claude-code
Открыть на GitHub

Что делает pytest-code-review

Скилл заставляет ИИ-агента анализировать файлы test_*.py и conftest.py по строгому пятиэтапному регламенту. Сначала модель фиксирует список проверяемых файлов, затем проверяет асинхронные тесты и структуру фикстур. Только после прохождения всех предварительных гейтов агент формирует список замечаний с конкретными строками или идентификаторами тестовых узлов.

Инструкция фокусируется на частых ошибках в тестах на Python: подмене AsyncMock на синхронный Mock, забытых операторах await или отсутствии блоков finally в yield-фикстурах. Скилл пресекает дублирование логики вместо @pytest.mark.parametrize. Отдельное правило касается патчинга: агент проверяет путь импорта там, где объект вызывается, а не в месте его объявления.

Агент не выдаёт абстрактную критику. Каждое замечание обязано содержать конкретный файл и строку кода.

Какие задачи решает

  • найти пропущенные await и некорректные вызовы AsyncMock в тестах
  • проверить очистку ресурсов в блоках finally для yield-фикстур
  • устранить дублирование проверок с помощью @pytest.mark.parametrize
  • выявить ошибки в путях patch(), указанных не в месте вызова

Примеры запросов агенту

  • Проверь tests/test_auth.py и найди ошибки в путях вызова patch()
  • Сделай ревью tests/test_billing.py и conftest.py по чеклисту pytest
  • Проанализируй tests/test_api.py на пропущенные await в асинхронных тестах

Как установить pytest-code-review

1Через Skills CLI (Vercel)

npx skills add existential-birds/beagle --skill pytest-code-review -a claude-code

2Вручную: положить файлы

~/.claude/skills/pytest-code-review/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/pytest-code-review/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о pytest-code-review

Как установить pytest-code-review в Claude Code?

Выполните в терминале команду npx skills add existential-birds/beagle --skill pytest-code-review -a claude-code. Файл скилла сохранится по пути ~/.claude/skills/pytest-code-review/SKILL.md.

Что делает скилл pytest-code-review?

Он проводит структурированный аудит тестов pytest по пяти гейтам, проверяя корректность асинхронных вызовов, область видимости фикстур, очистку ресурсов и пути импорта для patch().

Как скилл проверяет использование mock и patch?

Скилл требует подтверждать вызовы через assert_called_once_with, запрещает мокать внутренности вместо внешних зависимостей и следит, чтобы patch() применялся строго по месту вызова символа.

Исходный текст

SKILL.md · Apache-2.0
---
name: pytest-code-review
description: Reviews pytest test code for async patterns, fixtures, parametrize, and mocking. Use when reviewing test_*.py files, checking async test functions, fixture usage, or mock patterns.
---

# Pytest Code Review

## Quick Reference

| Issue Type | Reference |
|------------|-----------|
| async def test_*, AsyncMock, await patterns | [references/async-testing.md](references/async-testing.md) |
| conftest.py, factory fixtures, scope, cleanup | [references/fixtures.md](references/fixtures.md) |
| @pytest.mark.parametrize, DRY patterns | [references/parametrize.md](references/parametrize.md) |
| AsyncMock tracking, patch patterns, when to mock | [references/mocking.md](references/mocking.md) |

## Review gates

Work in order. Do not assert pytest-specific problems until each applicable gate passes.

1. **Scoped files** — **Pass when:** You list every `test_*.py` and any `conftest.py` you will cite; no findings for files outside that list.
2. **Async vs sync** — **Pass when:** Per scoped file, you note whether it uses `async def test_*` / `await`; if yes, open [references/async-testing.md](references/async-testing.md) before criticizing async usage.
3. **Fixtures** — **Pass when:** If shared setup matters, you name the `conftest.py` path(s) or state none; for yield fixtures, confirm cleanup exists before claiming resource leaks.
4. **patch / mocks** — **Pass when:** For any `patch` or mock critique, you give the import path where the symbol is **used** (call site), or mark N/A; open [references/mocking.md](references/mocking.md) when mocking is central to the review.
5. **Findings** — **Pass when:** Each finding includes a file path and line(s) or test node id, not a generic rule restatement.

## Review Checklist

- [ ] Test functions are `async def test_*` for async code under test
- [ ] AsyncMock used for async dependencies, not Mock
- [ ] All async mocks and coroutines are awaited
- [ ] Fixtures in conftest.py for shared setup
- [ ] Fixture scope appropriate (function, class, module, session)
- [ ] Yield fixtures have proper cleanup in finally block
- [ ] @pytest.mark.parametrize for similar test cases
- [ ] No duplicated test logic across multiple test functions
- [ ] Mocks track calls properly (assert_called_once_with)
- [ ] patch() targets correct location (where used, not defined)
- [ ] No mocking of internals that should be tested
- [ ] Test isolation (no shared mutable state between tests)

## When to Load References

- Reviewing async test functions → async-testing.md
- Reviewing fixtures or conftest.py → fixtures.md
- Reviewing similar test cases → parametrize.md
- Reviewing mocks and patches → mocking.md

## Review Questions

1. Are all async functions tested with async def test_*?
2. Are fixtures properly scoped with appropriate cleanup?
3. Can similar test cases be parametrized to reduce duplication?
4. Are mocks tracking calls and used at the right locations?

© existential-birds · Apache-2.0 · existential-birds/beagle

Похожие скиллы

Все скиллы по теме «Тесты и QA» →
pytest Claude MPM Team Скилл pytest для Claude Code, Codex, Cursor и других платформ. Добавляет фикстуры, параметризацию, маркеры, поддержку async и интеграцию с FastAPI, Django, Flask. CX Codex +1 1 300установок pytest-patterns manutej Скилл pytest-patterns для Claude Code задаёт шаблоны и практики тестирования Python с pytest: фикстуры, параметризацию и структуру тестов. CX Codex +1 870установок Pytest Testing pluginagentmarketplace Скилл Pytest Testing для Claude Code: фикстуры, моки, покрытие и запуск в CI на pytest. Наводит порядок в тестах Python-проекта. CX Codex +1 555установок pytest-skill TestMu AI Пишет тесты pytest — фикстуры, parametrize, маркеры, мокинг и conftest. Покрывает Python-код тестами без ручной возни. CX Codex +1 442установок pytest-advanced laurigates Скилл pytest-advanced для Claude Code помогает настраивать тестовую инфраструктуру, писать фикстуры и запускать тесты с покрытием. Активируется при работе с pytest и асинхронными тестами. CX Codex +1 388установок python-expert 0xfurai Субагент python-expert настраивает Claude Code на написание идиоматичного кода на Python по PEP 8, покрытие тестами через pytest и проверку типов с mypy. CX Codex ★ 1 029звёзд репо

Из того же набора68

Весь набор →
dagre-react-flow Скилл dagre-react-flow настраивает автоматическую раскладку направленных графов в React Flow с помощью dagre. Помогает строить иерархические деревья и выравнивать узлы по направлениям. CX Codex +1 257установок adr-writing Скилл adr-writing для Claude Code, который оформляет архитектурные решения в документы ADR по шаблону MADR и проверяет их полноту по чек-листу E.C.A.D.R. Работает также в Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode. CX Codex +1 254установок swift-code-review Скилл swift-code-review для Claude Code проверяет Swift-код на ошибки конкурентности, обработки ошибок и управления памятью. Подключается при ревью файлов .swift, в том числе с async/await, actors и Sendable. CX Codex +1 253установок review-verification-protocol Скилл review-verification-protocol обязывает проверить каждую находку перед тем, как внести её в отчёт — читать исходный код, искать контекст, отличать баги от стиля. Снижает ложные срабатывания в ревью. CX Codex +1 252установок sqlalchemy-code-review Скилл sqlalchemy-code-review проверяет SQLAlchemy-код на ошибки в сессиях, связях, запросах и миграциях. Нужен при ревью проектов на SQLAlchemy 2.0 и Alembic. CX Codex +1 228установок pydantic-ai-common-pitfalls Скилл pydantic-ai-common-pitfalls разбирает типичные ошибки в агентах на PydanticAI и подсказывает, что править: декораторы инструментов, зависимости, схемы вывода, стриминг. CX Codex +1 221установок agent-architecture-analysis Скилл agent-architecture-analysis проверяет кодовую базу ИИ-агента по методике 12-Factor Agents и выдаёт отчёт с оценкой каждого фактора и ссылками на файлы. CX Codex +1 220установок pydantic-ai-agent-creation Скилл pydantic-ai-agent-creation помогает создавать типобезопасных агентов на PydanticAI: со структурированным выводом, зависимостями и настройками модели. Нужен при сборке AI-агентов и чат-систем. CX Codex +1 219установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой