AIKraft/AI/Войти
AIKraft/Skills/Диагностика

Диагностика

Disciplined diagnosis loop for hard bugs and performance regressions. Reproduce → minimise → hypothesise → instrument → fix → regression-test. Use when user says

mattpocock official Разработка

Что делает навык

Навык обеспечивает дисциплинированный цикл диагностики сложных багов и регрессий производительности, начиная с создания надежного цикла обратной связи и заканчивая исправлением и пост-мортемом. Он решает задачу системного поиска причин сбоев, исключая хаотичные попытки и требуя воспроизводимости проблемы перед выдвижением гипотез.

Когда применять

  • Диагностика сложных багов, где требуется строгий порядок действий от воспроизведения до исправления.
  • Исследование регрессий производительности с использованием бенчмарков и профилирования вместо логов.
  • Работа с недетерминированными багами, требующими повышения частоты воспроизведения через стресс-тесты.
  • Анализ архитектурных проблем, если не удается создать корректный регрессионный тест (отсутствие правильного 'seam').

Как работает

  1. Построить цикл обратной связи (feedback loop): создать быстрый, детерминированный и агент-запускаемый сигнал провала/успеха (тест, скрипт curl, Playwright, bisection harness и т.д.).
  2. Воспроизвести баг: запустить цикл, подтвердить, что он точно описывает симптом пользователя, и зафиксировать точный признак ошибки.
  3. Выдвинуть гипотезы: сгенерировать 3–5 ранжированных, фальсифицируемых гипотез с четкими предсказаниями; показать список пользователю.
  4. Инструментировать код: проверить гипотезы, меняя по одной переменной, используя отладчик или целевые логи с уникальными префиксами (например, [DEBUG-a4f2]).
  5. Исправить и добавить регрессионный тест: написать тест на правильном 'seam' до исправления, убедиться в падении теста, применить фикс и проверить прохождение.
  6. Очистить и провести пост-мортем: удалить все отладочные логи и прототипы, задокументировать причину в коммите, оценить необходимость улучшения архитектуры.

Примеры запросов агенту

Помоги диагностировать этот баг, следуя дисциплинированному циклу: сначала построй цикл обратной связи, затем воспроизведи, выдвини гипотезы и исправь.
У нас регрессия производительности. Используй навык 'Диагностика': установи базовые измерения, проведи бисекцию и исправь проблему.
Баг проявляется иногда. Попробуй повысить частоту воспроизведения, выдвини ранжированные гипотезы и проверь их инструментами.

Что понадобится

  • Доступ к кодовой базе и понимание доменной глоссарии/ADR.
  • Возможность запуска тестов, скриптов (curl, CLI) или браузерных автоматизаций (Playwright/Puppeteer).
  • Инструменты отладки, профилирования или возможность добавления временной инструментации.

Описание составлено по SKILL.md навыка, сверено 06.10.2026.

Как подключить

1Скачать навык
# возьмите папку навыка «diagnose» из репозитория: # https://github.com/mattpocock/skills
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r diagnose/ ~/.claude/skills/diagnose/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.