debugger · justxor — субагент для Claude Code: отладка и установка
Субагент debugger в Claude Code воспроизводит ошибки и падающие тесты, ищет первопричину и проверяет исправление. Разбирает стектрейсы и неожиданные результаты.
MIT ★ 353 обновлён 2026-10-01
.claude/agents/debugger.mdЧто делает debugger
debugger начинает с фиксации симптома: сообщения об ошибке, стектрейса или шагов воспроизведения. Затем запускает команду или тест, выдвигает гипотезы и проверяет их, при необходимости добавляя временное логирование. В работе ему доступны Read, Edit, Grep, Glob и Bash.
После поиска первопричины субагент вносит минимальное исправление, убирает временные логи и повторно запускает проверку. В отчёте он указывает причину, подтверждающие её данные, внесённое изменение и способ предотвратить повторение ошибки. Модель наследуется от основной конфигурации Claude Code, поэтому отдельную модель этот файл не задаёт.
Какие задачи решает
- воспроизвести ошибку по стектрейсу
- проверить гипотезы о причине сбоя теста
- найти источник неожиданного поведения
- исправить дефект и повторно запустить проверку
Примеры запросов агенту
- Разбери этот стектрейс, воспроизведи ошибку и найди её первопричину.
- Проверь, почему падает тест, исправь проблему и запусти тест повторно.
- Найди причину неожиданного поведения и расскажи, как предотвратить повтор ошибки.
Как установить debugger
Вручную: положить файлы
.claude/agents/debugger.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/debugger.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/debugger.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы о debugger
Как установить debugger в Claude Code?
Добавьте файл субагента по пути .claude/agents/debugger.md.
Что делает debugger?
Он воспроизводит ошибки и падения тестов, проверяет гипотезы о первопричине и вносит минимальное исправление. Затем повторно запускает проверку и описывает результат.
Какие инструменты использует debugger?
Ему доступны Read, Edit, Grep, Glob и Bash. Модель наследуется от основной конфигурации Claude Code.
Исходный текст
debugger.md · MIT
--- name: debugger description: Специалист по отладке ошибок, падающих тестов и неожиданного поведения. Используй при любой ошибке или стектрейсе. tools: Read, Edit, Grep, Glob, Bash model: inherit --- Ты эксперт по отладке. Работай методично: 1. Зафиксируй симптом: сообщение об ошибке, стектрейс, шаги воспроизведения. 2. Воспроизведи проблему (команда/тест). 3. Сформулируй 2–3 гипотезы, проверяй от наиболее вероятной. Добавляй временное логирование при необходимости. 4. Найди первопричину, а не симптом. 5. Сделай минимальное исправление, убери временное логирование. 6. Подтверди исправление запуском теста/команды. Отчёт: первопричина, доказательства, исправление, как предотвратить в будущем.
© justxor · MIT · justxor/claude-code-pro-course
Похожие субагенты
Все субагенты по теме «Тесты и QA» →Сначала — debugger от других авторов.