systematic-debugging · chriswiles — скилл для Claude Code: обзор и установка
Скилл systematic-debugging задаёт четырёхэтапный протокол отладки с упором на первопричину бага. Скилл пригодится при расследовании падений тестов или внезапных сбоев рантайма без поверхностных правок.
лицензия не указана ★ 6 091 обновлён 2026-01-06
npx skills add ChrisWiles/claude-code-showcase --skill systematic-debugging -a claude-codeЧто делает systematic-debugging
Скилл запрещает менять код до тех пор, пока не выяснена истинная причина поломки. Вместо поверхностного латания симптомов агент сначала изучает полный стектрейс, находит место зарождения ошибочных данных в цепочке вызовов и воспроизводит сбой. Процесс разбит на четыре этапа: расследование источника, сравнительный анализ с работающими примерами, формулировка проверяемой гипотезы и только потом точечное исправление.
Перед изменением рабочего кода скилл требует написать воспроизводящий падающий тест. Это исключает догадки. Если три попытки исправить ошибку подряд терпят неудачу, скилл предписывает немедленно остановиться: серию провалов он расценивает как признак архитектурных проблем, требующих пересмотра дизайна, а не новых заплаток.
Инструкция включает отдельные шаблоны действий для ошибок времени выполнения, регрессий через git bisect и плавающих состояний гонки. Также описана связка со скиллом testing-patterns.
Какие задачи решает
- локализовать первопричину сбоя в цепочке вызовов
- прекратить внесение слепых правок наугад
- написать падающий тест до правки кода
- изолировать причину плавающих сбоев и состояний гонки
Примеры запросов агенту
- Изучи стектрейс в
auth.service.tsи выясни первопричину ошибки по шагам systematic-debugging - Тест в
order.spec.tsупал: сформулируй одну гипотезу и подготовь падающий тест перед правкой
Как установить systematic-debugging
1Через Skills CLI (Vercel)
npx skills add ChrisWiles/claude-code-showcase --skill systematic-debugging -a claude-code2Вручную: положить файлы
~/.claude/skills/systematic-debugging/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/systematic-debugging/
1Через Skills CLI (Vercel)
npx skills add ChrisWiles/claude-code-showcase --skill systematic-debugging -a codex2Вручную: положить файлы
.agents/skills/systematic-debugging/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add ChrisWiles/claude-code-showcase --skill systematic-debugging -a cursor2Вручную: положить файлы
.cursor/skills/systematic-debugging/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install ChrisWiles/claude-code-showcase .claude/skills/systematic-debugging2Вручную: положить файлы
.github/skills/systematic-debugging/SKILL.md1Через Skills CLI (Vercel)
npx skills add ChrisWiles/claude-code-showcase --skill systematic-debugging -a gemini-cli2Командой платформы
gemini skills install https://github.com/ChrisWiles/claude-code-showcase --path .claude/skills/systematic-debuggingВручную: положить файлы
.devin/skills/systematic-debugging/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о systematic-debugging
Как установить systematic-debugging в Claude Code?
Выполните в терминале команду npx skills add ChrisWiles/claude-code-showcase --skill systematic-debugging -a claude-code.
Зачем нужен скилл systematic-debugging?
Он направляет Claude Code по дисциплинированному пути отладки. Ассистент ищет корень проблемы и проверяет гипотезы вместо того, чтобы сразу вносить случайные правки.
Что предписывает скилл, если исправление не сработало три раза подряд?
Правило требует полностью прекратить исправления. Три неудачные попытки подряд указывают на архитектурный дефект, требующий обсуждения и пересмотра логики.
Похожие скиллы
Все скиллы по теме «Тесты и QA» →Сначала — systematic-debugging от других авторов.