service-debugging — скилл для Claude Code: что делает и как установить
Пошаговый регламент поиска причин сбоев в бэкенд-сервисах: от сбора симптомов и проверки логов до локализации бага через git bisect.
npx skills add c0x12c/ai-toolkit --skill service-debugging -a claude-codeЧто делает service-debugging
Скилл превращает хаотичную отладку в строгий последовательный процесс. Вместо немедленной правки кода агент сначала выясняет контекст инцидента: время возникновения проблемы, затронутых пользователей и текст ошибок. Затем он проводит первичную экспресс-проверку через консоль, запуская curl, grep и psql, чтобы исключить последствия свежих деплоев, обрывы связи с базой данных или сбившиеся переменные окружения.
Регламент связывает конкретные симптомы с зонами поиска. Ошибки с кодом 500 отправляют ассистента анализировать трассировку стека, а задержки ответов требуют профилирования запросов через команду EXPLAIN. Для поиска регрессий после релизов скилл предписывает запускать git bisect и искать источники ошибок поиском по исходникам. Главное требование процесса перед внесением правок — написать падающий воспроизводящий тест.
Для работы агенту необходим доступ к инструментам Bash, Grep, Read и Glob. Без возможности читать логи на диске и выполнять консольные команды регламент теряет практический смысл.
Какие задачи решает
- Локализовать причину сбоя бэкенда по логам и кодам ответов
- Найти коммит с регрессией с помощью git bisect
- Проверить статус базы данных и сетевые таймауты
- Воспроизвести ошибку минимальным запросом и зафиксировать тестом
Примеры запросов агенту
- Эндпоинт
/api/ordersвозвращает 500 после деплоя, разберись по регламенту отладки - Сервис стал отвечать медленно, найди причину деградации
- Приложение падает при запуске, проверь конфигурацию и последние логи
Как установить service-debugging
1Через Skills CLI (Vercel)
npx skills add c0x12c/ai-toolkit --skill service-debugging -a claude-code2Вручную: положить файлы
~/.claude/skills/service-debugging/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/service-debugging/
1Через Skills CLI (Vercel)
npx skills add c0x12c/ai-toolkit --skill service-debugging -a codex2Вручную: положить файлы
.agents/skills/service-debugging/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add c0x12c/ai-toolkit --skill service-debugging -a cursor2Вручную: положить файлы
.cursor/skills/service-debugging/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install c0x12c/ai-toolkit service-debugging2Вручную: положить файлы
.github/skills/service-debugging/SKILL.md1Через Skills CLI (Vercel)
npx skills add c0x12c/ai-toolkit --skill service-debugging -a gemini-cli2Командой платформы
gemini skills install https://github.com/c0x12c/ai-toolkit --path toolkit/skills/service-debuggingВручную: положить файлы
.devin/skills/service-debugging/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add c0x12c/ai-toolkit --skill service-debugging -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о service-debugging
Как установить service-debugging в Claude Code?
Выполните в консоли npx skills add c0x12c/ai-toolkit --skill service-debugging -a claude-code. Также можно вручную сохранить файл по пути ~/.claude/skills/service-debugging/SKILL.md.
Что делает скилл service-debugging?
Он задаёт сценарий расследования инцидентов на бэкенде. Агент собирает симптомы, проверяет окружение, локализует причину ошибки и пишет тест до того, как менять рабочий код.
Какие инструменты нужны ассистенту для запуска этого регламента?
В конфигурации скилла прописаны разрешения для Read, Glob, Grep и Bash. Они нужны для поиска по кодовой базе, анализа журналов и запуска системных утилит.
