gjalla-debug — скилл для Claude Code: что делает и как установить
Скилл gjalla-debug для поиска первопричины бага с доказательствами до того, как агент предложит исправление. Работает с Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode.
лицензия не указана 357 установок ★ 3 обновлён 2026-09-20
npx skills add gjalla/engineering --skill gjalla-debug -a claude-codeЧто делает gjalla-debug
gjalla-debug учит агента вести расследование: зафиксировать точный симптом, воспроизвести проблему или объяснить, почему это не получилось, проверить актуальность кода, собрать контекст из правил и истории репозитория, найти корень вместо первого попавшегося следствия. После диагностики скилл требует посчитать, сколько мест в кодовой базе содержат ту же ошибку, и написать тест, который падает сейчас и проходит после фикса.
На выходе — структурированный отчёт: симптом, механизм с номером строки, причина достижимости состояния, радиус поражения (список мест и счётчик), уровень уверенности (что проверено напрямую, что выведено), предложенное исправление с тестом. Если фикс затрагивает системные примитивы, скилл останавливается и передаёт задачу gjalla-spec.
Скилл запрещает формировать теорию раньше сбора данных. Без воспроизведения он переключается на логи, телеметрию и состояние базы, но помечает диагноз как менее надёжный.
Какие задачи решает
- найти первопричину бага вместо первого попавшегося следствия
- воспроизвести проблему или объяснить, почему она не воспроизводится
- посчитать, сколько мест в репозитории содержат ту же ошибку
- написать тест, который падает до фикса и проходит после
- собрать контекст из правил репозитория и истории изменений
Примеры запросов агенту
- Найди корень того, почему при втором сохранении в сессии возвращаются устаревшие данные
- Воспроизведи ошибку из тикета и объясни механизм
- Посчитай, в скольких местах мы вызываем метод без проверки, которая привела к этому багу
Как установить gjalla-debug
1Через Skills CLI (Vercel)
npx skills add gjalla/engineering --skill gjalla-debug -a claude-code2Вручную: положить файлы
~/.claude/skills/gjalla-debug/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/gjalla-debug/
1Через Skills CLI (Vercel)
npx skills add gjalla/engineering --skill gjalla-debug -a codex2Вручную: положить файлы
.agents/skills/gjalla-debug/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add gjalla/engineering --skill gjalla-debug -a cursor2Вручную: положить файлы
.cursor/skills/gjalla-debug/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install gjalla/engineering skills/gjalla-debug2Вручную: положить файлы
.github/skills/gjalla-debug/SKILL.md1Через Skills CLI (Vercel)
npx skills add gjalla/engineering --skill gjalla-debug -a gemini-cli2Командой платформы
gemini skills install https://github.com/gjalla/engineering --path skills/gjalla-debugВручную: положить файлы
.devin/skills/gjalla-debug/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add gjalla/engineering --skill gjalla-debug -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о gjalla-debug
Как установить gjalla-debug в Claude Code?
Выполни npx skills add gjalla/engineering --skill gjalla-debug -a claude-code, затем проверь файл ~/.claude/skills/gjalla-debug/SKILL.md.
Что делает gjalla-debug?
Учит агента искать первопричину бага с доказательствами: воспроизвести, собрать контекст, найти все похожие места в коде, написать тест и структурированный отчёт.
Зачем gjalla-debug пишет тест до исправления?
Тест, который не проходит сейчас и проходит после фикса, доказывает, что найдена настоящая причина, а не похожая. Если предложенное исправление не меняет результат теста — причина неверна.