debugging · siviter-xyz — скилл для Claude Code: что делает и как установить
Скилл debugging для Claude Code пошагово ищет первопричину сбоев и ошибок в коде. Помогает локализовать баг и подготовить минимальное исправление.
MIT 151 установок ★ 22 обновлён 2026-03-21
npx skills add siviter-xyz/dot-agent --skill debugging -a claude-codeЧто делает debugging
Скилл задаёт агенту шестиэтапный процесс отладки при падении тестов, исключениях или повреждении состояния. Сначала модель собирает логи и воспроизводит проблему, затем проверяет гипотезы и только после этого вносит изменения.
Протокол требует внедрять временное логирование в точки ветвления или вызовы внешних API и удалять его после починки. Правки должны быть минимальными: скилл запрещает переписывать соседнюю логику без необходимости. Перед фиксацией изменений агент обязан дождаться подтверждения пользователя.
Какие задачи решает
- локализовать первопричину сбоя по трейсу стека
- расставить временные логи в точках ветвления
- составить минимальный сценарий воспроизведения ошибки
- проверить прохождение тестов без регрессий
Примеры запросов агенту
- Разбери трейс ошибки после запуска интеграционных тестов
- Помоги найти причину повреждения состояния в модуле авторизации
- Локализуй сбой с undefined в обработчике событий
Как установить debugging
1Через Skills CLI (Vercel)
npx skills add siviter-xyz/dot-agent --skill debugging -a claude-code2Вручную: положить файлы
~/.claude/skills/debugging/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/debugging/
1Через Skills CLI (Vercel)
npx skills add siviter-xyz/dot-agent --skill debugging -a codex2Вручную: положить файлы
.agents/skills/debugging/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add siviter-xyz/dot-agent --skill debugging -a cursor2Вручную: положить файлы
.cursor/skills/debugging/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install siviter-xyz/dot-agent skills/debugging2Вручную: положить файлы
.github/skills/debugging/SKILL.md1Через Skills CLI (Vercel)
npx skills add siviter-xyz/dot-agent --skill debugging -a gemini-cli2Командой платформы
gemini skills install https://github.com/siviter-xyz/dot-agent --path skills/debuggingВручную: положить файлы
.devin/skills/debugging/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add siviter-xyz/dot-agent --skill debugging -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о debugging
Как установить debugging в Claude Code?
Выполните команду npx skills add siviter-xyz/dot-agent --skill debugging -a claude-code. Также файл инструкции можно поместить вручную в ~/.claude/skills/debugging/SKILL.md.
Что делает скилл debugging?
Он направляет модель по фиксированному алгоритму расследования ошибок: от сбора данных и проверки гипотез до минимального патча и проверки регрессий.
Что требуется от агента перед созданием коммита?
Протокол обязывает проверить статус CI, собрать атомарный набор изменений с тестами и обязательно запросить подтверждение у разработчика.
Исходный текст
SKILL.md · MIT
--- name: debugging description: Root cause analysis and debugging protocols. Use when encountering errors, test failures, unexpected behavior, stack traces, or when code behaves differently than expected. --- # Debugging Systematic approach to root cause analysis and debugging. ## When to Use - Encountering errors or exceptions - Test failures that need investigation - Unexpected behavior in code - Stack traces or error messages - Code behaving differently than expected - Performance issues or bugs ## Core Principles - **Evidence-based**: Base diagnosis on error messages, logs, and reproducible steps - **Systematic**: Follow structured debugging process - **Minimal fixes**: Implement smallest change that resolves issue - **Verify solutions**: Confirm fix works and doesn't introduce regressions ## Debugging Process Follow systematic debugging process: 1. Capture error information (message, stack trace, logs, environment) 2. Identify reproduction steps (minimal steps, conditions, edge cases) 3. Isolate failure location (function/module, recent changes, dependencies) 4. Form and test hypotheses (evidence-based, systematic testing, debug logging) 5. Implement minimal fix (smallest change, preserve behavior, follow patterns) 6. Verify solution (issue resolved, no regressions, tests pass) See `references/root-cause-analysis.md` for detailed methods. ## Strategic Debug Logging Add debug logging to entry/exit points, state transitions, conditional branches, external API calls, and data transformations. Remove after issue resolved unless it provides ongoing value. ## Error Pattern Recognition Common patterns: null/undefined errors, type errors, timing issues, state corruption, configuration issues. See `references/error-patterns.md` for detailed patterns and solutions. ## Integration After fixing: - Verify CI passes (types, tests, lint) - Stage atomic changes (fix + tests) - Suggest semantic commit message - Confirm with user before committing ## References For detailed guidance, see: - `references/root-cause-analysis.md` - Systematic analysis methods - `references/error-patterns.md` - Common error patterns and solutions - `references/debugging-tools.md` - Debugging tools and techniques
© siviter-xyz · MIT · siviter-xyz/dot-agent
Похожие скиллы
Все скиллы по теме «Тесты и QA» →Сначала — debugging от других авторов.