# team-debugger

Субагент проверяет одну заданную гипотезу о причине бага. Он собирает подтверждения или опровержения с цитатами строк кода и выдаёт оценку уверенности.

- субагент · `type=agent` · Claude Code, Codex, Cursor · ★ 41823
- Автор: Seth Hobson
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/wshobson/agents/tree/HEAD/plugins/agent-teams/agents/team-debugger.md
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/agents/team-debugger

## Что делает

team-debugger работает по строгой процедуре: получает конкретное предположение о корневой причине бага и проверяет только его. Субагент изучает код, маршруты данных, логи и историю git, чтобы выяснить, подтверждается ли идея фактами. Если гипотеза оказывается ложной, он фиксирует опровержение как полезный результат.

Внутри задействована модель `opus` и набор инструментов `Read`, `Glob`, `Grep`, `Bash`, а также системные задачи и `SendMessage`. Каждую находку агент подкрепляет точной ссылкой формата `file:line`, выстраивает причинно-следственную цепочку и выставляет итоговый уровень уверенности: высокий (>80%), средний (50-80%) или низкий (<50%).

Субагент строго держит фокус: если в процессе всплывают улики в пользу совсем другой причины, он лишь сообщает об этом ведущему агенту через сообщение, но не переключает расследование сам.

## Установка

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

1. **Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin marketplace add wshobson/agents
```
В чате агента (не в терминале):
```text
/plugin install agent-teams@claude-code-workflows
```

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

### Codex

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

### Cursor

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/wshobson/agents/tree/HEAD/plugins/agent-teams/agents/team-debugger.md

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

## Примеры запросов агенту
- Проверь гипотезу, что утечка соединений вызвана отсутствием вызова close() в src/db/pool.ts
- Исследуй предположение о гонке потоков при обновлении кэша в worker.py и подтверди фактами с номерами строк
- Собери улики по гипотезе сбоя авторизации, опровергни её или подтверди с указанием уровня уверенности

## Похожие
- [code-reviewer](https://affpapa.org/nevibecode/agents/anthropic-code-reviewer.md) — субагент · 31050 установок
- [code-reviewer](https://affpapa.org/nevibecode/agents/code-reviewer.md) — субагент · 31050 установок
- [test-engineer](https://affpapa.org/nevibecode/agents/test-engineer.md) — субагент · 9715 установок
- [code-reviewer](https://affpapa.org/nevibecode/agents/voltagent-community-code-reviewer.md) — субагент · 31050 установок
- [fullstack-developer](https://affpapa.org/nevibecode/agents/fullstack-developer.md) — субагент · 18117 установок
- [prompt-engineer](https://affpapa.org/nevibecode/agents/voltagent-community-prompt-engineer.md) — субагент · 16078 установок

Из того же набора: [wshobson/agents](https://affpapa.org/nevibecode/by/wshobson/agents.md) — 498 карточек

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

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