refinement · ruvnet — субагент для Claude Code: что делает и как установить
Субагент refinement для фазы доработки в методологии SPARC. Организует TDD-цикл: пишет падающие тесты, закрывает их кодом и чистит архитектуру без поломки проверок.
лицензия не указана ★ 850 обновлён 2026-10-26
.claude/agents/refinement.mdЧто делает refinement
refinement отвечает за этап полировки кода в методологии SPARC. Субагент выстраивает разработку по цепочке TDD: сначала готовит падающие тесты под требуемое поведение, затем добавляет минимальный код для зелёных тестов, после чего проводит рефакторинг.
В настройках субагента прописаны хуки жизненного цикла. Перед стартом хук проверяет имеющиеся тесты командой npm test --if-present и фиксирует фазу в памяти. Завершающий хук повторно вызывает npm test и сохраняет отметку об окончании проверки.
Субагент опирается на вызовы npm test. Если тестовый раннер в проекте не настроен, завершающий хук выдаст предупреждение о непройденных проверках.
Какие задачи решает
- написать падающие модульные тесты перед реализацией логики
- провести рефакторинг сервиса с сохранением зелёных тестов
- доработать обработку ошибок и граничные сценарии
- автоматизировать прогон тестов до и после изменений
Примеры запросов агенту
- Запусти субагента refinement для сервиса авторизации и покрой логику тестами
- Проведи рефакторинг AuthenticationService по методологии TDD
- Напиши падающие тесты для блокировки аккаунта и сделай реализацию
Как установить refinement
Вручную: положить файлы
.claude/agents/refinement.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/refinement.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/refinement.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы о refinement
Как установить refinement в Claude Code?
Скопируйте конфигурацию субагента в файл .claude/agents/refinement.md внутри целевого проекта.
Что делает субагент refinement?
Он ведёт доработку кода в рамках методологии SPARC через строгий цикл TDD: красные тесты, минимальная реализация и последующий рефакторинг.
Что требуется для корректной работы хуков refinement?
В проекте должен быть настроен запуск тестов через npm test, поскольку стартовый и финальный хуки агента напрямую вызывают эту команду.
Похожие субагенты
Все субагенты по теме «Тесты и QA» →Сначала — refinement от других авторов.