К основному содержанию
субагент CX Codex

debugger · rohitg00 — субагент для Claude Code: установка и отладка

Субагент debugger для Claude Code системно ищет причины сложных ошибок, падений тестов и сбоев во время выполнения. Подключается к задачам, где нужно сначала разобраться в баге, а потом предлагать исправление.

MIT ★ 2 966 обновлён 2026-09-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add rohitg00/pro-workflow
/plugin install pro-workflow@pro-workflow
Открыть на GitHub

Что делает 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-workflow

2Вручную: положить файлы

.claude/agents/debugger.md

Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

По шагам, с командами для каждой платформы: Субагенты 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 от других авторов.

debugger VoltAgent Community Субагент debugger диагностирует сбои, разбирает логи и устраняет первопричины багов в проекте. Пригодится при падениях сервиса или плавающих ошибках. CX Codex 13 459установок debugger VoltAgent Субагент debugger изолирует баги по трассировкам стека, упавшим тестам и рантайм-логам. Находит причину сбоя и предлагает минимальное исправление. CX Codex ★ 6 505звёзд репо debugger CloudAI-X Субагент debugger ищет первопричину падений тестов, утечек памяти и сбоев в коде. Субагент проверяет гипотезы через воспроизведение и логирование, избегая слепых правок. CX Codex ★ 1 424звёзд репо debugger qdhenry Субагент debugger отладки для Claude Code: ищет первопричины сбоев, разбирает упавшие тесты и готовит минимальный патч. CX Codex ★ 1 357звёзд репо debugger justxor Субагент debugger в Claude Code воспроизводит ошибки и падающие тесты, ищет первопричину и проверяет исправление. Разбирает стектрейсы и неожиданные результаты. CX Codex ★ 353звёзд репо diagnose LegendApp Скилл diagnose для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode — запускает структурированное расследование бага по явному вызову. CX Codex +1 429установок scout simota Скилл scout для Claude Code, который расследует баги и находит первопричину сбоя. Запускается при отчётах об инцидентах, падениях тестов и регрессиях без написания правок в коде. CX Codex +1 101установок investigate-bug rerun-build Скилл investigate-bug для Claude Code, который собирает факты о баге и ищет его первопричину до исправления. Запускается на сообщения об инциденте, жалобе или просьбе воспроизвести ошибку. CX Codex +1 ★ 1 120звёзд репо argent-metro-debugger software-mansion Скилл argent-metro-debugger для отладки React Native через Metro и CDP: подключается к рантайму, читает консоль, инспектирует компоненты и выполняет JavaScript. Работает с iOS, Android, Fire TV и Chromium. CX Codex +1 32 400установок mcp-debugger debugmcp Сервер mcp-debugger пошаговой отладки через протокол DAP для ИИ-агентов. Позволяет ставить точки останова, читать переменные и управлять выполнением программ без графической IDE. CX Codex +1 ★ 194звёзд репо node-inspect-debugger openclaw Скилл node-inspect-debugger для Claude Code отлаживает Node.js через node inspect: брейкпоинты, зависания async-кода, CPU-профили и heap snapshot. Разбирает причины, не видимые по логам. CX Codex +1 299установок

Из того же набора83

Весь набор →
session-handoff Скилл session-handoff формирует структурированный отчёт о сессии с текущим состоянием репозитория, решениями и готовой командой для следующего запуска. CX Codex +1 ★ 2 966звёзд репо replay-learnings Скилл replay-learnings ищет в файлах проекта прошлые исправления и похожие сессии, а затем показывает релевантные уроки. Запустите его перед новой задачей, чтобы учесть прежние ошибки. CX Codex +1 ★ 2 966звёзд репо skill-optimize Команда skill-optimize запускает офлайн-оптимизацию описания скилла (SKILL.md) на основе накопленных примеров. Предлагает и проверяет улучшения, перезаписывает файл только если новая версия работает лучше. CX Codex +1 ★ 2 966звёзд репо orchestrate Скилл orchestrate разбивает разработку сложных фич на фазы исследования, планирования, реализации и код-ревью с валидацией на каждом шаге. CX Codex +1 ★ 2 966звёзд репо auto-setup Скилл auto-setup для Claude Code детектирует тип проекта и настраивает линтеры, проверку типов, тесты и форматирование. Закрывает первый день в незнакомом репозитории. CX Codex +1 ★ 2 966звёзд репо wiki-query Скилл wiki-query находит релевантные фрагменты в локальных вики через полнотекстовый поиск SQLite FTS5 с ранжированием BM25. Пригодится перед созданием новых заметок, чтобы избежать дубликатов. CX Codex +1 ★ 2 966звёзд репо orchestrator Субагент orchestrator для Claude Code, который разбивает сложную разработку на три фазы: исследование, планирование и реализацию. CX Codex ★ 2 966звёзд репо learn-rule Скилл learn-rule захватывает исправления и уроки в постоянную память с категорией, ошибкой и решением. Сохраняет правила между сеансами, чтобы не повторять одни и те же ошибки. CX Codex +1 ★ 2 966звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой