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

testing-patterns — правило для Claude Code: тесты на Vitest

Правило testing-patterns для Claude Code задаёт соглашения по Vitest: расположение тестов, работу с моками LLM и запуск одного теста.

MIT ★ 1 319 обновлён 2026-09-24

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

Что делает testing-patterns

Правило задаёт агенту порядок работы с тестами на Vitest. Настройки читаются из vitest.config.ts, общий сетап лежит в src/test/setup.ts и подгружается сам. Весь набор идёт через npm run test, одиночный файл запускается как npx vitest run src/scoring/__tests__/accuracy.test.ts.

Главное ограничение касается моков LLM. Вызовы @anthropic-ai/sdk, openai и @anthropic-ai/vertex-sdk уже замоканы глобально в сетапе, и в отдельном тесте их трогать нельзя. Для fs и child_process предписано vi.mock(), для проверки типов берите vi.mocked(). Переменные окружения сохраняют из process.env в beforeEach и возвращают в afterEach.

Файлы правило берёт только из src/**/__tests__/**. Тест в другой папке оно просто не увидит, поэтому соседство с исходником здесь не пожелание, а условие. Покрытие считается через npm run test:coverage, провайдер v8, пороги — в vitest.config.ts.

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

  • Разложить тесты по папкам __tests__ рядом с исходниками
  • Не дублировать моки LLM в каждом отдельном тесте
  • Прогнать один упавший файл вместо всего набора
  • Вернуть process.env в исходное состояние после теста
  • Сверить покрытие с порогами из конфига

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

  • Напиши тест на src/llm/config.ts, положи его в src/llm/__tests__/config.test.ts и замокай fs через vi.mock()
  • Прогони только npx vitest run src/scoring/__tests__/accuracy.test.ts и покажи, какая проверка падает
  • Проверь покрытие через npm run test:coverage; моки openai в тесте не трогай

Как установить testing-patterns

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

.claude/rules/testing-patterns.md

Поле paths во frontmatter ограничивает файлы

По шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать

Вопросы о testing-patterns

Как установить testing-patterns в Claude Code?

Скопируйте файл правила в .claude/rules/testing-patterns.md внутри проекта.

Что делает testing-patterns?

Описывает агенту, как писать и запускать тесты на Vitest: структура файлов, моки зависимостей, одиночный прогон и покрытие.

На какие файлы действует правило?

Только на пути по маске src/**/__tests__/**, она стоит в шапке правила.

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

testing-patterns.md · MIT
---
paths:
  - src/**/__tests__/**
---

# Testing Patterns

- Config: `vitest.config.ts` · Setup: `src/test/setup.ts` (auto-loaded)
- Run all: `npm run test` · Single: `npx vitest run src/scoring/__tests__/accuracy.test.ts`
- LLM calls globally mocked in `src/test/setup.ts` — never mock `@anthropic-ai/sdk`, `openai`, `@anthropic-ai/vertex-sdk` in individual tests
- Use `vi.mock()` for `fs`, `child_process` · `vi.mocked()` for type-safe assertions
- Colocated: `src/llm/__tests__/config.test.ts` tests `src/llm/config.ts`
- Pattern: `describe` → `beforeEach(vi.clearAllMocks)` → `it` with `expect`
- Env vars: save `process.env` in `beforeEach`, restore in `afterEach`
- Coverage: `npm run test:coverage` (v8 provider, thresholds in `vitest.config.ts`)

© caliber-ai-org · MIT · caliber-ai-org/ai-setup

Похожие правила IDE

Все правила IDE по теме «Тесты и QA» →
vitest-testing-patterns curiositech Скилл vitest-testing-patterns задаёт шаблоны для написания тестов на Vitest и React Testing Library. Помогает генерировать проверки компонентов, роутов и мокировать внешние сервисы. CX Codex +1 373установок gjalla-test-audit gjalla Скилл gjalla-test-audit инспектирует тестовую базу на ложную надёжность. Он выявляет тесты с избыточными моками, фиктивными проверками и логикой, которая маскирует ошибки исходного кода. CX Codex +1 888установок mock-to-internals-migration ZaxbyHub Скилл mock-to-internals-migration для Claude Code помогает переносить моки с Vitest на Bun и проверять переход на seam _internals. Подключается к задачам миграции моков и изменения тестовой структуры. CX Codex +1 ★ 539звёзд репо javascript-testing-patterns Seth Hobson Скилл javascript-testing-patterns подсказывает, как писать unit-, интеграционные и end-to-end-тесты для JavaScript и TypeScript. Пригодится при настройке тестовой инфраструктуры и работе по TDD. CX Codex +1 20 472установок testing Mindrally Скилл testing задаёт правила тестирования для ИИ-агента: от табличных проверок до изоляции состояния и структуры каталогов. CX Codex +1 888установок testing-boss Pedro Nauck Скилл testing-boss задаёт правила создания тестов и эвалов для LLM-агентов: помогает выбрать уровень проверок, починить нестабильные тесты в CI и убрать лишние моки. CX Codex +1 274установок

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

Весь набор →
caliber-onboarding Правило caliber-onboarding для Claude Code и Codex, которое при запуске сессии проверяет, синхронизированы ли конфиги Caliber. Если синхронизация не установлена, предлагает запустить /setup-caliber одной командой. CX Codex +1 ★ 1 319звёзд репо llm-layer Правило llm-layer для Claude Code задаёт соглашения для кода провайдеров моделей в src/llm/**: интерфейс LLMProvider, конфиг, seat-based режим и учёт использования. CX Codex +1 ★ 1 319звёзд репо testing Правило testing задаёт паттерны написания тестов на Vitest, изоляцию вызовов LLM и структуру тестовых файлов в проекте Caliber. CX Codex +1 ★ 1 319звёзд репо caliber-conventions Правило caliber-conventions задаёт соглашения для разработки CLI-проектов Caliber на TypeScript. Оно пригодится, чтобы агент учитывал требования проекта при работе с кодом и тестами. CX Codex +1 ★ 1 319звёзд репо scoring-patterns Правило scoring-patterns задаёт архитектурные правила для проверок скоринга в src/scoring/**. Помогает писать детерминированные тесты без сетевых вызовов и случайных значений. CX Codex +1 ★ 1 319звёзд репо llm-patterns Правило llm-patterns задаёт соглашения для LLM-провайдеров в коде проекта. Оно пригодится при работе с моделями, конфигурацией, потоками и ошибками CLI. CX Codex +1 ★ 1 319звёзд репо caliber-pre-commit Правило caliber-pre-commit на каждый коммит: проверяет хук Caliber и, если хука нет, синхронизирует конфиги агентов и добавляет их в индекс. CX Codex +1 ★ 1 319звёзд репо find-skills Скилл find-skills ищет готовые скиллы сообщества через реестр Caliber и подключает их прямо во время диалога с агентом. CX Codex +1 ★ 1 319звёзд репо

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

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