Diagnosing Bugs: скилл для поиска причины трудного бага

mattpocock/skills· Проверено 13.11.2026· 323,4 тыс.на GitHub

Скилл Мэтта Пококка для трудных багов и просадок скорости: агент сначала строит быструю проверку, которая краснеет на этом баге, и только потом выдвигает гипотезы.

Как установить Diagnosing Bugs

Личные скиллы лежат в ~/.claude/skills/, проектные — в .claude/skills/ репозитория. Проверка: команда /skills в сессии, вызов по имени — /diagnosing-bugs.

# плагином, внутри Claude Code
/plugin marketplace add mattpocock/skills
/plugin install mattpocock-skills@mattpocock

# или вручную
git clone --depth 1 https://github.com/mattpocock/skills.git /tmp/diagnosing-bugs
mkdir -p ~/.claude/skills/diagnosing-bugs
cp -r /tmp/diagnosing-bugs/skills/engineering/diagnosing-bugs/. ~/.claude/skills/diagnosing-bugs/

Что умеет

Собрать петлю обратной связи: падающий тест, curl-скрипт, headless-браузер, git bisect или сравнение двух версий
Воспроизвести баг и урезать сценарий до минимума, где каждый шаг нужен
Выдвинуть 3–5 проверяемых гипотез и показать их вам до проверки
Расставить помеченные отладочные логи и убрать их одним grep
Написать регрессионный тест до исправления и подтвердить фикс на исходном сценарии

Шесть фаз: петля обратной связи, воспроизведение и минимизация, гипотезы, инструментирование, фикс с регрессионным тестом, уборка.

Главное правило: без одной команды, которая уже запускалась, быстро и стабильно краснеет на этом баге, переход к гипотезам запрещён.

Перед показом команд и вывода агент заменяет секреты на <REDACTED>. Если без человека не обойтись, петлю ведёт scripts/hitl-loop.template.sh.

Агент вызывает скилл сам на словах diagnose, debug this и на жалобах «сломалось», «падает», «тормозит».

Что нужно
АгентыРассчитан на Claude Code и Codex: рядом со SKILL.md лежит agents/openai.yaml для Codex.

Что попросить агента

Diagnose this: <эндпоинт> иногда отдаёт 500Построит петлю с повтором запроса, поднимет частоту воспроизведения и только потом начнёт искать причину
/diagnosing-bugs После <релиза> страница <каталога> грузится втрое дольшеСнимет базовый замер, затем бисектит коммиты автоматическим скриптом
Debug this: тест <имя> падает только в CIСведёт сценарий к минимуму, покажет ранжированные гипотезы и напишет регрессионный тест до фикса

Ограничения

!

Медленный и подробный: на быстрый вопрос, где нужен прямой ответ, он не подходит

!

Без воспроизводимой петли агент останавливается и просит доступ к окружению, логи или разрешение на временное инструментирование

!

Snyk помечает скилл как рискованный из-за shell-скрипта hitl-loop.template.sh

Описание из SKILL.md

Diagnosis loop for hard bugs and performance regressions. Use when the user says "diagnose"/"debug this", or reports something broken/throwing/failing/slow.

Частые вопросы

Как установить diagnosing bugs skill в Claude Code?
Через набор Пококка: claude plugin install mattpocock-skills@claude-plugins-official. Скилл включится сам, когда вы напишете «debug this».
Есть ли похожий скилл отладки в superpowers?
Да, systematic-debugging из obra/superpowers. У diagnosing-bugs главное условие — команда, которая краснеет на этом баге, до любых гипотез.
Почему Snyk считает diagnosing-bugs опасным?
Скилл поставляет shell-скрипт и учит обращаться к dev-серверу через curl. Автор называет срабатывание ложным: скрипт — около 30 строк запросов ввода от человека.
Куда делся /diagnose?
В версии 1.0.0 его переименовали в /diagnosing-bugs. Старые обёртки и сохранённые промпты с /diagnose нужно поправить.
Не утекут ли секреты в вывод?
Скилл требует заменять секреты на <REDACTED> и строить петли на переменных окружения.
Сколько установок у diagnosing-bugs?
На skills.sh на 13.11.2026 — 927 973 установки, 29-е место в общем рейтинге.

Похожие скиллы