# debugger

Субагент debugger расследует ошибки и сбои: изучает логи, проверяет гипотезы и ищет первопричину. Запускайте его при падении тестов, регрессии или непонятном поведении приложения.

- субагент · `type=agent` · Claude Code, Codex, Cursor · ★ 267 у репозитория
- Автор: NYCU-Chung
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/NYCU-Chung/my-claude-devteam/tree/HEAD/agents/debugger.md
- Обновлён: 2026-04-18
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/nycu-chung-debugger

## Что делает

debugger собирает сведения об ошибке, сужает область поиска и пытается воспроизвести сбой. Затем он проверяет несколько возможных причин и фиксирует, какие подтвердились, а какие исключены. В отчёте описывает проблему, доказательства, первопричину, исправление и проверку на регрессии.

Для анализа доступны Read, Grep, Glob, Bash, WebSearch и WebFetch. Субагент разбирает логи PM2, Docker, systemd, Nginx и приложений, а для незнакомой ошибки ищет сведения в интернете. Проверка гипотез важна: без воспроизведения и подтверждения причины исправление может убрать лишь симптом.

При сбоях сервиса он ищет, среди прочего, необработанные исключения, нехватку памяти и конфликты портов. Для проблем базы данных использует запросы к PostgreSQL и MySQL, а при ошибках интерфейса проверяет консоль браузера, сетевые ответы и состояние в React/Vue devtools. Для установки в Claude Code нужны обе команды маркетплейса.

## Требования
- Работает с: Docker

## Установка

### Claude Code (родная платформа)

1. **Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin marketplace add NYCU-Chung/my-claude-devteam
```
В чате агента (не в терминале):
```text
/plugin install devteam@my-claude-devteam
```

2. **Вручную: положить файлы**
- Файл: `.claude/agents/debugger.md` — Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

### Codex

**Вручную: положить файлы**
- Файл: `.codex/agents/debugger.toml` — Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/agents/debugger.md` — Cursor понимает и .claude/agents/

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/NYCU-Chung/my-claude-devteam/tree/HEAD/agents/debugger.md

## Когда брать
- найти причину падения сервиса по логам
- воспроизвести ошибку и проверить гипотезы
- разобрать регрессию после недавних изменений
- исследовать нестабильный тест
- проверить исправление на исходном сценарии и регрессии

## Примеры запросов агенту
- Разберись, почему сервис падает, и проверь логи PM2.
- Найди причину ошибки в тесте: воспроизведи её и проверь гипотезы.
- Исследуй регрессию после последних изменений и подготовь отчёт с проверкой исправления.

## Похожие
- [trail](https://affpapa.org/nevibecode/plugins/trail.md) — плагин · ★ 8 у репозитория
- [adk-debugger](https://affpapa.org/nevibecode/skills/adk-debugger.md) — скилл · 1700 установок
- [docker-debugger](https://affpapa.org/nevibecode/skills/docker-debugger.md) — скилл · 314 установок
- [containers](https://affpapa.org/nevibecode/plugins/containers.md) — плагин · ★ 11 у репозитория
- [pod-doctor](https://affpapa.org/nevibecode/skills/pod-doctor.md) — скилл · 3700 установок
- [debug-openshell-cluster](https://affpapa.org/nevibecode/skills/debug-openshell-cluster.md) — скилл · 739 установок

## Другие версии с тем же именем
- [debugger · voltagent](https://affpapa.org/nevibecode/agents/debugger.md) — 13459 установок
- [debugger · voltagent](https://affpapa.org/nevibecode/agents/voltagent-debugger.md) — ★ 6505 у репозитория
- [debugger · rohitg00](https://affpapa.org/nevibecode/agents/rohit-ghumare-debugger.md) — ★ 2966 у репозитория
- [debugger · cloudai-x](https://affpapa.org/nevibecode/agents/cloudai-x-debugger.md) — ★ 1424 у репозитория
- [debugger · qdhenry](https://affpapa.org/nevibecode/agents/qdhenry-debugger.md) — ★ 1357 у репозитория

Из того же набора: [nycu-chung/my-claude-devteam](https://affpapa.org/nevibecode/by/nycu-chung/my-claude-devteam.md) — 13 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
