# gjalla-debug

Скилл gjalla-debug для поиска первопричины бага с доказательствами до того, как агент предложит исправление. Работает с Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 357 установок · ★ 3 у репозитория
- Автор: gjalla
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/gjalla/engineering/tree/HEAD/skills/gjalla-debug/SKILL.md
- Обновлён: 2026-09-20
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/gjalla-debug

## Что делает

gjalla-debug учит агента вести расследование: зафиксировать точный симптом, воспроизвести проблему или объяснить, почему это не получилось, проверить актуальность кода, собрать контекст из правил и истории репозитория, найти корень вместо первого попавшегося следствия. После диагностики скилл требует посчитать, сколько мест в кодовой базе содержат ту же ошибку, и написать тест, который падает сейчас и проходит после фикса.

На выходе — структурированный отчёт: симптом, механизм с номером строки, причина достижимости состояния, радиус поражения (список мест и счётчик), уровень уверенности (что проверено напрямую, что выведено), предложенное исправление с тестом. Если фикс затрагивает системные примитивы, скилл останавливается и передаёт задачу `gjalla-spec`.

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

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add gjalla/engineering --skill gjalla-debug -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add gjalla/engineering --skill gjalla-debug -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add gjalla/engineering --skill gjalla-debug -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install gjalla/engineering skills/gjalla-debug
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add gjalla/engineering --skill gjalla-debug -a gemini-cli
```

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

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add gjalla/engineering --skill gjalla-debug -a opencode
```

### Claude.ai

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

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

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

## Примеры запросов агенту
- Найди корень того, почему при втором сохранении в сессии возвращаются устаревшие данные
- Воспроизведи ошибку из тикета и объясни механизм
- Посчитай, в скольких местах мы вызываем метод без проверки, которая привела к этому багу

## Похожие
- [08-debug](https://affpapa.org/nevibecode/skills/08-debug.md) — скилл · ★ 571 у репозитория
- [error-diagnostics-smart-debug](https://affpapa.org/nevibecode/skills/error-diagnostics-smart-debug.md) — скилл · 1 установка
- [debug-like-expert](https://affpapa.org/nevibecode/skills/debug-like-expert.md) — скилл · ★ 1988 у репозитория
- [debug-agent](https://affpapa.org/nevibecode/agents/debug-agent.md) — субагент · ★ 3951 у репозитория
- [systematic-debugging](https://affpapa.org/nevibecode/skills/systematic-debugging.md) — скилл · 306118 установок
- [agent-browser](https://affpapa.org/nevibecode/skills/vercel-labs-agent-browser.md) — скилл · 1600000 установок
- [improve-codebase-architecture](https://affpapa.org/nevibecode/skills/improve-codebase-architecture.md) — скилл · 1163035 установок
- [tdd](https://affpapa.org/nevibecode/skills/tdd.md) — скилл · 1141062 установки

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

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