debugging-toolkit-debugger — субагент для Claude Code
Субагент разбирает ошибки, падения тестов и неожиданное поведение: ищет первопричину, предлагает небольшой фикс и проверяет результат.
/plugin marketplace add wshobson/agents
/plugin install debugging-toolkit@claude-code-workflowsЧто делает debugging-toolkit-debugger
debugging-toolkit-debugger специализируется на поиске первопричины. Он собирает сообщение об ошибке и stack trace, уточняет шаги воспроизведения, локализует сбой и предлагает минимальное исправление. Затем проверяет, что решение работает, а не маскирует симптом.
В процессе субагент анализирует логи, смотрит последние изменения в коде, проверяет гипотезы и при необходимости добавляет отладочные записи. В разборе он даёт объяснение причины, подтверждающие признаки, конкретный фикс, способ тестирования и рекомендации для профилактики. В конфигурации указан sonnet.
Субагент доступен для Claude Code, Codex и Cursor. Для Claude Code нужен файл .claude/agents/debugger.md; без него агент не подключится. Для Codex используется .codex/agents/debugger.toml, для Cursor — .cursor/agents/debugger.md.
Какие задачи решает
- найти причину ошибки по stack trace и логам
- разобрать падение теста
- локализовать место сбоя
- проверить гипотезу по недавним изменениям
- составить фикс и план проверки
Примеры запросов агенту
- Разбери эту ошибку по stack trace и найди первопричину.
- Проверь, почему тест падает после последних изменений в коде.
- Изолируй место сбоя, предложи минимальный фикс и способ его проверить.
Как установить debugging-toolkit-debugger
1Через маркетплейс плагинов
/plugin marketplace add wshobson/agents/plugin install debugging-toolkit@claude-code-workflows2Вручную: положить файлы
.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: как создать, вызвать и не утопить контекст
Вопросы о debugging-toolkit-debugger
Как установить debugging-toolkit-debugger в Claude Code?
Добавьте маркетплейс командой /plugin marketplace add wshobson/agents, установите плагин через /plugin install debugging-toolkit@claude-code-workflows, затем подключите файл .claude/agents/debugger.md.
Что делает debugging-toolkit-debugger?
Субагент анализирует ошибки, логи и падения тестов, локализует сбой и ищет первопричину. Он также предлагает фикс, проверку решения и меры профилактики.
С какими платформами работает debugging-toolkit-debugger?
Он рассчитан на Claude Code, Codex и Cursor. Для каждой платформы используется свой файл агента: .claude/agents/debugger.md, .codex/agents/debugger.toml или .cursor/agents/debugger.md.
Исходный текст
debugger.md · MIT
--- name: debugging-toolkit-debugger description: Debugging specialist for errors, test failures, and unexpected behavior. Use proactively when encountering any issues. model: sonnet --- You are an expert debugger specializing in root cause analysis. When invoked: 1. Capture error message and stack trace 2. Identify reproduction steps 3. Isolate the failure location 4. Implement minimal fix 5. Verify solution works Debugging process: - Analyze error messages and logs - Check recent code changes - Form and test hypotheses - Add strategic debug logging - Inspect variable states For each issue, provide: - Root cause explanation - Evidence supporting the diagnosis - Specific code fix - Testing approach - Prevention recommendations Focus on fixing the underlying issue, not just symptoms.
© Seth Hobson · MIT · wshobson/agents
