# gem-debugger

Субагент ищет корневую причину падений: разбирает стек, бисектит регрессии, воспроизводит ошибки. Полезен, когда тест падает, а почему — непонятно.

- субагент · `type=agent` · GitHub Copilot · ★ 40418
- Автор: github · официальный репозиторий GitHub
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/github/awesome-copilot/tree/HEAD/agents/gem-debugger.agent.md
- Обновлён: 2026-10-23
- HTML: https://affpapa.org/nevibecode/agents/gem-debugger

## Что делает

\`gem-debugger` работает как отдельный субагент в режиме диагностики. Он не пишет код и не предлагает правки в файлах — только разбирается, откуда взялась ошибка, и отдаёт результат в виде JSON с полями `status`, `fail`, `handoff` и `learn`. Внутри `handoff` лежит диагноз: корневая причина, файлы, шаги воспроизведения, ожидаемое и фактическое поведение, рекомендации по исправлению.

Порядок проверок задан жёстко: сначала grep по логам, потом юнит-тест, затем интеграционный, и только в конце скрипт воспроизведения. Диагноз считается подтверждённым, если причина воспроизводится в двух независимых проверках или её сразу выдаёт стек с точной строкой. Если первая гипотеза не подтвердилась, субагент идёт глубже — по вызывающим функциям, зависимостям, состоянию и таймингам.

На вход он ждёт `plan_id`, `task_id`, `task_definition` и `config_snapshot` в рамках роли. Без этого набора запускать его бессмысленно: контекст падения берётся из `failure_context` в передаче задачи. Вывод — сырой JSON без markdown и пояснений, так что читать его будет следующая ступень пайплайна, а не человек.

## Установка

### GitHub Copilot (родная платформа)

**Вручную: положить файлы**
- Файл: `.github/agents/gem-debugger.agent.md`

### Claude Code

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

### Codex

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

### Cursor

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

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

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

## Примеры запросов агенту
- Разбери падение теста: вот `plan_id`, `task_id`, `task_definition` и `config_snapshot`, найди корневую причину
- Ошибка воспроизводится не всегда — проверь логи, тесты и тайминги, отдай диагноз в JSON
- Найди, в каком коммите появилась регрессия, и опиши шаги воспроизведения

## Похожие
- [frontend-developer](https://affpapa.org/nevibecode/agents/voltagent-community-frontend-developer.md) — субагент · 40905 установок
- [dx-optimizer](https://affpapa.org/nevibecode/agents/dx-optimizer.md) — субагент · 1198 установок
- [mlops-engineer](https://affpapa.org/nevibecode/agents/voltagent-community-mlops-engineer.md) — субагент · 1009 установок
- [postgres-pro](https://affpapa.org/nevibecode/agents/postgres-pro.md) — субагент · 897 установок
- [agent-installer](https://affpapa.org/nevibecode/agents/agent-installer.md) — субагент · 363 установки
- [embedded-systems](https://affpapa.org/nevibecode/agents/embedded-systems.md) — субагент · 279 установок

Из того же набора: [github/awesome-copilot](https://affpapa.org/nevibecode/by/github/awesome-copilot.md) — 861 карточка

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

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