# general-debugger

Субагент general-debugger ведёт баг от симптома до строки, где всё ломается: читает стектрейс, проходит путь выполнения назад и предлагает точечную правку.

- субагент · `type=agent` · Claude Code, Codex, Cursor · ★ 372 у репозитория
- Автор: Giuseppe Trisciuoglio
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/giuseppe-trisciuoglio/developer-kit/tree/HEAD/plugins/developer-kit-core/agents/general-debugger.md
- Обновлён: 2026-09-10
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/general-debugger

## Что делает

Субагент для Claude, который разбирает падение, упавший тест или странное поведение до корневой причины. Читает сообщение об ошибке, стектрейс и код вокруг, потом идёт по пути выполнения назад, пока не упрётся в нарушенное допущение.

Внутри четыре шага: понять проблему, собрать улики, найти причину, предложить правку. Ответ приходит готовым отчётом — описание проблемы, цепочка вызовов, причина с файлом и строкой, рекомендованное изменение с оценкой риска и план проверки. Есть заготовки под частые случаи: null-ссылки, ошибки на единицу, гонки, утечки ресурсов, несовпадение версий зависимостей.

В конфиге у него `Read`, `Write`, `Edit`, `Glob`, `Grep` и `Bash`, модель зафиксирована как `sonnet`. То есть файлы он правит и команды запускает сам, а не только рассказывает. Дайте ему команду воспроизведения и падающий тест: на просьбу «почини приложение» трассировать нечего.

## Установка

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

1. **Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin marketplace add giuseppe-trisciuoglio/developer-kit
```
В чате агента (не в терминале):
```text
/plugin install developer-kit@developer-kit
```

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

### Codex

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

### Cursor

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/giuseppe-trisciuoglio/developer-kit/tree/HEAD/plugins/developer-kit-core/agents/general-debugger.md

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

## Примеры запросов агенту
- Тест `test_checkout.py` падает через раз — найди корневую причину и покажи отчёт.
- Почему `GET /orders` отдаёт 500 у только что созданных пользователей? Разбери стектрейс и предложи минимальную правку.
- Пройди по цепочке вызовов в `UserService.enrichProfile` и объясни, откуда там null.

## Похожие
- [debugging-toolkit-debugger](https://affpapa.org/nevibecode/agents/debugging-toolkit-debugger.md) — субагент · ★ 42780 у репозитория
- [debugger](https://affpapa.org/nevibecode/agents/qdhenry-debugger.md) — субагент · ★ 1357 у репозитория
- [systematic-debugging](https://affpapa.org/nevibecode/skills/systematic-debugging.md) — скилл · 306118 установок
- [sentry-fix-stack-traces](https://affpapa.org/nevibecode/skills/sentry-fix-stack-traces.md) — скилл · 1800 установок
- [monitoring-terminal-errors](https://affpapa.org/nevibecode/skills/monitoring-terminal-errors.md) — скилл · 493 установки
- [principle-attack-the-premise](https://affpapa.org/nevibecode/skills/principle-attack-the-premise.md) — скилл · 10100 установок

Из того же набора: [giuseppe-trisciuoglio/developer-kit](https://affpapa.org/nevibecode/by/giuseppe-trisciuoglio/developer-kit.md) — 191 карточка

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

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