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

run-tests — команда для Claude Code: что делает и как установить

Команда run-tests прогоняет тесты проекта в три этапа: сначала только затронутые правками, потом весь юнит-набор, затем интеграционные.

MIT ★ 1 424 обновлён 2026-10-06

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

Что делает run-tests

Команда сначала выясняет, чем в проекте гоняются тесты: ищет jest, vitest, mocha, ava или tap в package.json, файлы pytest.ini, pyproject.toml и setup.cfg, *_test.go или Cargo.toml. Дальше смотрит git diff --name-only HEAD~1, по соглашению об именах находит тесты для изменённых файлов и запускает их первыми.

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

Если тесты красные, она берётся за исходный код и повторяет прогон до трёх раз. Диф строится от HEAD~1, поэтому в репозитории без истории коммитов затронутые тесты так не найти.

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

  • прогнать только те тесты, которые задевает правка
  • найти тестовый файл для изменённого foo.ts
  • отличить реальное падение от флейка после повторного прогона
  • получить разбор упавшей проверки с вероятной причиной
  • довести красный набор до зелёного, не гоняя всё подряд

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

  • Прогони /project-starter:run-tests, начни с тестов, которые задевает моя правка.
  • Упали тесты после рефакторинга в src/api/users.ts. Запусти /project-starter:run-tests и поправь код, если дело в нём.
  • Запусти /project-starter:run-tests и скажи, что из падений флейкует.

Как установить run-tests

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

.claude/commands/run-tests.md

Вызов — /run-tests. Для всех проектов — ~/.claude/commands/

Вопросы о run-tests

Как установить run-tests в Claude Code?

Положите файл команды по пути .claude/commands/run-tests.md в проекте. Вызывается она с пространством имён: /project-starter:run-tests.

Что делает run-tests?

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

Почему команда находит не все затронутые тесты?

Список изменённых файлов берётся из git diff --name-only HEAD~1, то есть из последнего коммита. Без истории коммитов первому уровню не от чего оттолкнуться, и он пойдёт по полному набору.

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

run-tests.md · MIT
---
description: Runs project tests intelligently. Identifies affected tests from changes and runs them first, then full suite.
---

# Run Tests

Run tests efficiently with tiered approach: affected tests first, then full suite.

## Phase 1: Detect Test Framework

Identify testing setup:

```bash
# Node.js
cat package.json | grep -E '"(jest|vitest|mocha|ava|tap)"'

# Python
ls pytest.ini pyproject.toml setup.cfg 2>/dev/null | head -1

# Go
ls *_test.go 2>/dev/null | head -1

# Rust
ls Cargo.toml 2>/dev/null
```

## Phase 2: Identify Affected Tests

Based on git diff, find related tests:

```bash
# Get changed files
git diff --name-only HEAD~1

# Find corresponding test files
# Convention: foo.ts -> foo.test.ts or foo.spec.ts
```

## Phase 3: Run Tests (Tiered Approach)

### Tier 1: Affected Tests Only (Fast)

```bash
# Node.js with Jest/Vitest
npm test -- --findRelatedTests [changed files]
npx vitest run --changed

# Python with pytest
pytest [specific test files] -x --tb=short

# Go
go test -run [TestName] ./...
```

### Tier 2: Full Unit Test Suite

If Tier 1 passes:

```bash
npm test
pytest tests/unit/
go test ./...
cargo test
```

### Tier 3: Integration Tests

If Tier 2 passes:

```bash
npm run test:integration
pytest tests/integration/
go test -tags=integration ./...
```

## Phase 4: Analyze Failures

For each failure:

1. Parse error message
2. Identify failing assertion
3. Trace to source code
4. Suggest fix

## Output Format

```
## Test Results: [PASS/FAIL]

### Summary
- Total: X tests
- Passed: Y
- Failed: Z
- Skipped: W
- Duration: [time]

### Failed Tests
1. **test_name** - `file:line`
   - Expected: [value]
   - Actual: [value]
   - Likely cause: [analysis]
   - Suggested fix: [fix]

### Flaky Test Detection
- [Any tests that passed on retry]

### Coverage (if available)
- Lines: X%
- Branches: Y%
- Functions: Z%

### Recommendation
[SAFE TO COMMIT / FIX REQUIRED / INVESTIGATE FLAKY]
```

## Continue Until Green

If tests fail:

1. Report the failure clearly
2. Attempt to fix the failing code (not just the test)
3. Re-run tests
4. Repeat until green or max 3 attempts

## Usage

This command ships with the project-starter plugin. Invoke with: `/project-starter:run-tests`

© CloudAI-X · MIT · CloudAI-X/claude-workflow-v2

Похожие слэш-команды

Все слэш-команды по теме «Тесты и QA» →
run-smoke-tests cursor Скилл run-smoke-tests прогоняет смоук-тесты Playwright, разбирает падения и проверяет, что правка их закрыла. Нужен перед релизом или после крупного изменения. CX Codex +1 2 300установок run-tests-after-changes davila7 Хук run-tests-after-changes запускает быстрые тесты через npm run test:quick сразу после того, как Claude Code редактирует файл в проекте. Помогает поймать поломки до коммита. 1 967установок generate-tests davila7 Команда generate-tests создаёт готовый файл тестов для указанного компонента или файла. Команда определяет тестовый фреймворк проекта и генерирует проверки по паттерну AAA. CX Codex +1 12 378установок run-failing-tests-immediately-after-test-gate-failure ZaxbyHub Скилл run-failing-tests-immediately-after-test-gate-failure для Claude Code заставляет агента сразу прогнать упавшие тесты после сбоя test_gate и починить корневую причину, а не отчитываться о готовности. CX Codex +1 ★ 539звёзд репо run-relevant-tests-after-logic-changes ZaxbyHub Скилл run-relevant-tests-after-logic-changes требует запускать релевантные тесты после правок логики и запрещает закрывать задачу без подтверждения их успешного прохождения. CX Codex +1 ★ 539звёзд репо run-acceptance-tests hashicorp Скилл run-acceptance-tests для Claude Code и Codex: запускает acceptance-тесты Terraform-провайдера, диагностирует сбои тестов, настраивает переменные окружения и проверяет корректность работы. CX Codex +1 3 900установок

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

Весь набор →
validate-build Команда validate-build определяет систему сборки и запускает подходящую проверку для Node.js, Python, Go или Rust. Вызывайте её после изменений, до коммита. CX Codex +1 ★ 1 424звёзд репо mentor Команда mentor включает режим наставника: ассистент объясняет, зачем нужен каждый блок кода, разбирает его по шагам и предлагает, что попробовать дальше. CX Codex +1 ★ 1 424звёзд репо review Команда review включает строгий режим код-ревью с градацией замечаний: от критических уязвимостей до правок стиля и итогового вердикта. CX Codex +1 ★ 1 424звёзд репо lint-check Команда lint-check прогоняет линтеры проекта, раскладывает замечания по важности и предлагает автоисправление стиля. Пригодится перед коммитом, чтобы не ловить это в CI. CX Codex +1 ★ 1 424звёзд репо parallel-review Команда parallel-review запускает проверку кода в нескольких папках или файлах одновременно — по субагенту на каждую цель. CX Codex +1 ★ 1 424звёзд репо code-simplifier Команда code-simplifier разбирает недавние изменения и предлагает упростить код без смены поведения. Пригодится после реализации новой функции или рефакторинга. CX Codex +1 ★ 1 424звёзд репо security-scan Команда security-scan прогоняет репозиторий на захардкоженные секреты, уязвимые зависимости, инъекции и слабые настройки конфигурации. Удобно запускать перед коммитом или пул-реквестом. CX Codex +1 ★ 1 424звёзд репо verify-changes Команда verify-changes запускает параллельную проверку свежих правок через субагентов и состязательный фильтр ложных срабатываний. CX Codex +1 ★ 1 424звёзд репо

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

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