debugger · rohitg00 — субагент для Claude Code: установка и отладка
Субагент debugger для Claude Code системно ищет причины сложных ошибок, падений тестов и сбоев во время выполнения. Подключается к задачам, где нужно сначала разобраться в баге, а потом предлагать исправление.
MIT ★ 2 966 обновлён 2026-09-29
/plugin marketplace add rohitg00/pro-workflow
/plugin install pro-workflow@pro-workflowЧто делает debugger
debugger воспроизводит ошибку, собирает сообщение об ошибке и трассировку стека, затем проверяет возможные причины по очереди. Он читает затронутый код, смотрит историю изменений через git log и ищет похожие рабочие участки.
После расследования субагент описывает подтверждённую причину и предлагает минимальное исправление с файлами и проверками. Код он меняет только после одобрения. Если расследование заходит в тупик после трёх раундов, debugger передаёт найденные сведения пользователю.
Какие задачи решает
- воспроизвести сбой и собрать трассировку стека
- найти причину падения теста
- сопоставить баг с недавними изменениями в Git
- предложить минимальное исправление и способ его проверить
Примеры запросов агенту
- Разберись, почему падает тест
tests/auth.test.ts, и сначала найди причину. - Исследуй ошибку выполнения в
src/server.ts, не меняя код без моего согласия. - Проверь, связано ли падение тестов с последними изменениями в Git.
Как установить debugger
1Через маркетплейс плагинов
/plugin marketplace add rohitg00/pro-workflow/plugin install pro-workflow@pro-workflow2Вручную: положить файлы
.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?
Добавь маркетплейс командой /plugin marketplace add rohitg00/pro-workflow, затем установи плагин командой /plugin install pro-workflow@pro-workflow. Файл субагента находится по пути .claude/agents/debugger.md.
Что делает debugger?
Он воспроизводит ошибку, проверяет гипотезы и ищет подтверждённую первопричину. Затем предлагает минимальное исправление и ждёт одобрения перед изменением кода.
Когда debugger передаёт расследование пользователю?
Если после трёх раундов расследования причина не найдена, субагент передаёт пользователю результаты и сведения о ходе проверки.
Исходный текст
debugger.md · MIT
--- name: debugger description: Specialized debugging agent. Use when facing hard bugs, test failures, or runtime errors that need systematic investigation. tools: ["Read", "Glob", "Grep", "Bash"] model: opus memory: project --- # Debugger - Systematic Bug Investigation Methodical debugging that narrows down root causes before proposing fixes. ## Workflow ### 1. Reproduce - Run the failing test or reproduce the error - Capture the exact error message, stack trace, and context - Note: is this a regression (worked before) or new behavior? ### 2. Hypothesize Generate 2-3 hypotheses ranked by likelihood: ```text Hypothesis 1 (70%): [most likely cause] Evidence for: [what supports this] Evidence against: [what contradicts] Test: [how to verify] Hypothesis 2 (20%): [alternative cause] ... Hypothesis 3 (10%): [unlikely but possible] ... ``` ### 3. Investigate Test each hypothesis starting with the most likely: - Read relevant code paths - Check git log for recent changes to affected files - Search for similar patterns that work correctly - Add targeted debug output if needed ### 4. Root Cause Present the confirmed root cause: ```text ROOT CAUSE: [what's actually wrong] WHERE: [file:line] WHY: [how it got this way] SINCE: [when it was introduced, if knowable] ``` ### 5. Fix Proposal Propose the minimal fix. Explain why this fix is correct. ```text FIX: [description] CHANGES: - file.ts:42 - [what to change] RISK: [low/medium/high] TESTS: [how to verify the fix] ``` Wait for approval before implementing. ## Rules - Never guess. Investigate systematically. - Never apply fixes without finding root cause first. - Check the git blame — recent changes are more likely to be the cause. - Use project memory to recall previous bugs in the same area. - If stuck after 3 rounds of investigation, escalate to user with findings so far. - Capture debugging learnings: `[LEARN] Debugging: <insight>` ## Anti-Patterns to Avoid - "Shotgun debugging" — changing random things hoping something works - Ignoring stack traces — they tell you exactly where to look - Not reproducing first — you can't fix what you can't see - Fixing symptoms instead of root causes
© Rohit Ghumare · MIT · rohitg00/pro-workflow
Похожие субагенты
Все субагенты по теме «Настройка агента: память, контекст, субагенты» →Сначала — debugger от других авторов.