test-runner — субагент для Claude Code: что делает и как установить
Субагент запускает тесты проекта, находит корень ошибок и предлагает правки. Он не меняет код сам, отдавая готовый диагноз для исправления.
npx claude-code-templates@latest --agent development-team/test-runnerЧто делает test-runner
Агент распознаёт тестовые фреймворки в репозитории — от Jest до Pytest. Он запускает проверки через консоль, опираясь на код возврата процесса. При сбоях субагент сопоставляет текст ошибки с реализацией. Это позволяет быстро выяснить, где закралась проблема: в коде приложения или в конфигурации окружения.
У помощника нет инструментов Write и Edit. Из-за этого ограничения он физически не может менять файлы проекта или ослаблять проверки ради зелёного статуса. Для нестабильных тестов заложено отдельное правило. Субагент перезапускает их изолированно дважды или трижды, чтобы выявить случайные сбои. В отчёте вы получите точные строки с ошибками и готовый фрагмент кода для ручного применения.
Какие задачи решает
- локализовать причину падения локальных тестов или сборки в CI
- проверить стабильность флакующих тестов через серию изолированных запусков
- получить готовый вариант исправления без риска случайного удаления проверок
- отделить ошибки в бизнес-логике от проблем в тестовых моках и окружении
Примеры запросов агенту
- Запусти тестовый набор и разберись, почему упал
test_payment_retry - Проверь тестами новую логику скидок и найди причину ошибок
- Разбери лог упавшего CI и проверь подозрительный тест на нестабильность
Как установить test-runner
1Через claude-code-templates
npx claude-code-templates@latest --agent development-team/test-runner2Вручную: положить файлы
.claude/agents/test-runner.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/test-runner.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/test-runner.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы о test-runner
Как установить test-runner в Claude Code?
Запустите команду npx claude-code-templates@latest --agent development-team/test-runner либо сохраните файл агента по пути .claude/agents/test-runner.md.
Что делает субагент test-runner?
Он определяет конфигурацию тестов, исполняет команды запуска и анализирует сбои. На выходе формируется структурированный отчёт с причинами ошибок и готовыми правками.
Почему test-runner не исправляет код сам?
В его конфигурации нет инструментов Write и Edit. Такое ограничение гарантирует, что агент не удалит упавшие тесты и не ослабит ассерты ради успешного прохождения проверки.
