К основному содержанию
субагент CX Codex

vitest-expert — субагент для Claude Code: тесты на Vitest и установка

Субагент vitest-expert для Claude Code пишет юнит-тесты на Vitest для JavaScript и TypeScript: моки, хуки, снапшоты и конфиг для CI. Наращивает покрытие без ручной рутины.

MIT ★ 1 029 обновлён 2025-10-15

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/agents/vitest-expert.md
Открыть на GitHub

Что делает vitest-expert

Субагент берёт на себя юнит-тесты на Vitest: пишет их для JavaScript и TypeScript, разбирается с асинхронными проверками, моками и шпионами, готовит beforeEach и afterEach. На выходе — тестовые файлы, отчёт с покрытием и обновлённые снапшоты.

Внутри обычный markdown с четырьмя блоками: зоны ответственности, подход, чек-лист качества и ожидаемый результат. Скриптов и внешних инструментов нет, только правила, которых агент держится при генерации и правке тестов.

Конфиг автор советует держать в отдельном vitest.config.js, а не в общем файле сборки. Забытый .only в коммите оставит от прогона один тест вместо всего файла — диффы перед пушем всё равно читать вам.

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

  • Написать юнит-тесты на Vitest для модуля на TypeScript
  • Замокать внешнюю зависимость и не тащить её в тест
  • Разложить разросшийся тестовый файл по describe-блокам
  • Вынести конфигурацию тестов в отдельный vitest.config.js
  • Починить тест, который падает через раз

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

  • Напиши тесты на Vitest для src/utils/parseDate.ts и замокай модуль fs
  • Разложи checkout.test.ts по describe-блокам и вынеси общую подготовку в beforeEach
  • Почему снапшот-тест падает в CI? Проверь конфиг Vitest и поправь

Как установить vitest-expert

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

.claude/agents/vitest-expert.md

Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

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

Вопросы о vitest-expert

Как установить vitest-expert в Claude Code?

Положите файл субагента по пути .claude/agents/vitest-expert.md. Из этой папки Claude его и подхватит.

Что делает vitest-expert?

Пишет и приводит в порядок юнит-тесты на Vitest: группирует кейсы, настраивает моки и хуки, обновляет снапшоты. В конце отдаёт набор тестов и отчёт с покрытием.

Подойдёт ли он проекту на чистом JavaScript без TypeScript?

Да, в зоне ответственности субагента тесты и для JavaScript, и для TypeScript. Отдельно оговорена работа с асинхронным кодом через async/await.

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

vitest-expert.md · MIT
---
name: vitest-expert
description: Create organized, comprehensive, and efficient unit tests with Vitest, ensuring high code quality and stability.
model: claude-sonnet-4-20250514
---

## Focus Areas

- Mastery of Vitest API and configuration
- Writing unit tests for JavaScript and TypeScript
- Asynchronous test handling and assertions
- Mocking and spying on modules and functions
- Test setup and teardown with hooks
- Grouping and organizing related tests
- Handling test environments and global variables
- Configuring Vitest for different environments
- Integrating Vitest with CI/CD pipelines
- Debugging tests effectively within Vitest

## Approach

- Use `describe` blocks to group related tests logically
- Prefer `async/await` for handling asynchronous code
- Use `beforeEach` and `afterEach` hooks for setup/teardown
- Mock external dependencies to isolate test subjects
- Utilize Vitest's snapshot testing for UI components
- Leverage Vitest's built-in assertions for clarity
- Configure Vitest to run specific test files or directories
- Use `.only` and `.skip` to focus on specific tests
- Integrate Vitest seamlessly with version control hooks
- Maintain a separate vitest.config.js for test-specific configuration

## Quality Checklist

- All tests should be deterministic and stable
- Ensure high coverage with meaningful tests
- Avoid testing implementation details; focus on behavior
- Provide clear and descriptive test names
- Regularly refactor tests to remove duplication
- Continuously review and update mocks and stubs
- Optimize test run times without sacrificing coverage
- Consistently review and prune outdated tests
- Ensure compatibility with multiple Node.js versions
- Document test rationale and methodology clearly

## Output

- A comprehensive suite of tests covering all critical paths
- Structured test files with logical organization
- Detailed test reports with coverage metrics
- Maintained and updated vitest snapshots
- Clean test directory with no orphan or obsolete files
- Documented test cases with clear descriptions
- Efficient execution with minimal global side effects
- Configuration files for customizing test environments
- Established CI/CD workflows for automated testing
- Secure and isolated testing environments for reliability

© 0xfurai · MIT · 0xfurai/claude-code-subagents

Похожие субагенты

Все субагенты по теме «Тесты и QA» →
vitest-testing existential-birds Скилл vitest-testing для Claude Code: подсказывает, как писать тесты на Vitest — ассерты, моки, асинхронность, конфиг. Работает в проектах с уже установленным Vitest. CX Codex +1 473установок vitest Anthony Fu Скилл vitest для Claude Code помогает писать тесты и настраивать Vitest. Включается при работе с моками, покрытием, фильтрами и фикстурами. CX Codex +1 48 600установок vitest-skill TestMu AI Генерирует юнит-тесты на Vitest для JavaScript и TypeScript проектов. Помогает настроить моки через vi и протестировать компоненты React. CX Codex +1 506установок vitest-unit-testing-cursorrules-prompt-file PatrickJS Правило vitest-unit-testing-cursorrules-prompt-file для Cursor настраивает ИИ писать юнит-тесты на Vitest с TypeScript или JavaScript. Оно запускается на файлах проекта, мокает зависимости до импортов и группирует тесты в describe-блоки. CX Codex +1 ★ 41 178звёзд репо vitest-testing-patterns curiositech Скилл vitest-testing-patterns задаёт шаблоны для написания тестов на Vitest и React Testing Library. Помогает генерировать проверки компонентов, роутов и мокировать внешние сервисы. CX Codex +1 373установок testing-best-practices agent-skills Скилл testing-best-practices для Claude Code: 34 правила по юнит- и интеграционным тестам и TDD в 7 категориях на TypeScript с Jest и Vitest. Покрывает написание и разбор чужих тестов. CX Codex +1 975установок

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

Весь набор →
playwright-expert Субагент playwright-expert помогает проектировать и отлаживать тесты Playwright для веб-приложений. Он пригодится для браузерных сценариев, CI/CD и сложных взаимодействий со страницей. CX Codex ★ 1 029звёзд репо trpc-expert Субагент trpc-expert для Claude Code пишет бэкенд на tRPC: собирает роутеры, типы и middleware. Работает с расхождениями типов сервера и клиента. CX Codex ★ 1 029звёзд репо testcafe-expert Субагент testcafe-expert для написания и оптимизации UI-тестов на TestCafe. Помогает проектировать page model, настраивать селекторы, роли пользователей и прогоны в CI/CD. CX Codex ★ 1 029звёзд репо elk-expert Субагент elk-expert помогает настраивать Elasticsearch, Logstash и Kibana: от обработки логов до мониторинга кластера. Подключайте его к задачам по ELK в Claude Code. CX Codex ★ 1 029звёзд репо mongoose-expert Субагент mongoose-expert проектирует схемы Mongoose, оптимизирует выборки в MongoDB и настраивает валидацию данных. Пригодится при разработке бэкенда. CX Codex ★ 1 029звёзд репо rust-expert rust-expert — субагент для Claude Code, который пишет идиоматический Rust и проверяет безопасность кода. Подключается к задачам по оптимизации, многопоточности и работе с системой типов. CX Codex ★ 1 029звёзд репо knex-expert Субагент knex-expert для Claude, который берёт на себя сборку SQL-запросов через Knex.js, миграции, сиды и транзакции в проектах на Node.js. CX Codex ★ 1 029звёзд репо flask-expert Субагент flask-expert помогает разрабатывать, рефакторить и тестировать веб-приложения на Flask. Пригодится при настройке маршрутизации, разделении кода на Blueprints и подготовке тестов. CX Codex ★ 1 029звёзд репо

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

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