run-tests — команда для Claude Code: что делает и как установить
Команда run-tests прогоняет тесты проекта в три этапа: сначала только затронутые правками, потом весь юнит-набор, затем интеграционные.
MIT ★ 1 424 обновлён 2026-10-06
.claude/commands/run-tests.mdЧто делает 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/
Вручную: положить файлы
~/.codex/prompts/run-tests.mdВызов — /prompts:run-tests. В Codex этот формат помечен устаревшим, замена — скиллы
Вручную: положить файлы
.github/prompts/run-tests.prompt.mdВручную: положить файлы
.gemini/commands/run-tests.tomlGemini хранит команды в TOML: текст запроса — в поле prompt
Вопросы о 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