# adk-debugger

Разбирает трейсы и логи ADK-агента, находит причину сбоя и ведёт по шагам от симптома до проверки фикса.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1600 установок · ★ 12
- Автор: botpress
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/botpress/skills/tree/HEAD/skills/adk-debugger/SKILL.md
- Обновлён: 2026-10-20
- HTML: https://affpapa.org/nevibecode/skills/adk-debugger

## Что делает

Скилл для тех, кто собирает агентов на ADK и устал гадать, почему бот молчит или зовёт не тот инструмент. Он опирается на трейсы и логи: каждый ход диалога, вызов инструмента, шаг рассуждения модели и ошибка записаны, и это источник правды о поведении агента.

Внутри шесть справочников. `traces-and-logs.md` — команды CLI и структура трейсов, `common-failures.md` — типовые сбои рантайма, `llm-debugging.md` — галлюцинации, отказы, зацикливание, `debug-workflow.md` — цикл из восьми шагов, `trace-summarization.md` и `conversation-analysis.md` — как пересказать трейс или весь диалог словами. Скилл сам выбирает файл под вопрос.

Перед отладкой рантайма стоит прогнать `adk check --format json`: часть проблем сидит в конфиге и схеме, и без офлайн-проверки вы будете искать их в трейсах. Почти все команды поддерживают `--format json`, а вот у `adk dev` такого флага нет — для структурированного вывода нужен `adk dev --non-interactive`. Ещё понадобится связанный бот: `agent.json` с `botId` и `workspaceId` от `adk link`.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add botpress/skills --skill adk-debugger -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/adk-debugger/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/adk-debugger/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add botpress/skills --skill adk-debugger -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/adk-debugger/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add botpress/skills --skill adk-debugger -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install botpress/skills adk-debugger
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/adk-debugger/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add botpress/skills --skill adk-debugger -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/botpress/skills --path skills/adk-debugger
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/adk-debugger/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add botpress/skills --skill adk-debugger -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

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

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

## Примеры запросов агенту
- мой бот перестал отвечать, посмотри логи и трейсы
- суммируй этот трейс: что произошло на ходе
- \`adk check` нашёл ошибки, разберись, что с конфигом

## Похожие
- [google-agents-cli-adk-code](https://affpapa.org/nevibecode/skills/google-agents-cli-adk-code.md) — скилл · 512800 установок
- [debugger](https://affpapa.org/nevibecode/skills/zhaono1-debugger.md) — скилл · 745 установок
- [node-inspect-debugger](https://affpapa.org/nevibecode/skills/node-inspect-debugger.md) — скилл · 396 установок
- [pine-debugger](https://affpapa.org/nevibecode/skills/pine-debugger.md) — скилл · 460 установок
- [debugging-wizard](https://affpapa.org/nevibecode/skills/debugging-wizard.md) — скилл · 5100 установок
- [incident-response-debugger](https://affpapa.org/nevibecode/agents/incident-response-debugger.md) — субагент · ★ 41729

Из того же набора: [botpress/skills](https://affpapa.org/nevibecode/by/botpress/skills.md) — 3 карточки

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

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