Навык создан оригинальным автором superpowers и активируется при обнаружении сбоев тестов, ошибок в рабочей среде, неудачных сборок или любого аномального поведения. Ключевое правило: «Нельзя предлагать исправление без проведения расследования корневой причины». На первом этапе необходимо прочитать полное сообщение об ошибке, стабильно воспроизвести проблему и проверить недавние изменения; в системах с несколькими компонентами нужно добавить логирование на каждой границе взаимодействия, чтобы определить уровень сбоя. На втором этапе следует найти аналогичный рабочий код и провести поэлементное сравнение. На третьем этапе проверяется только одна гипотеза за раз. Исправление выполняется лишь в самом конце. Чем сильнее спешка и чем больше желание «просто изменить одну строку», тем обязательнее прохождение всего процесса.
Почему это важно Частая проблема агентов при исправлении ошибок — изменение кода сразу после обнаружения симптомов, а если не помогает, добавление еще одного слоя изменений. Этот навык разделяет расследование, сравнение, проверку гипотез и исправление на четыре обязательных последовательных этапа.
Количество установок skills.sh 333427 (+1239 / 24 ч)
Аудит безопасности: есть предупреждения о рисках
- Агенту разрешено выполнять команды shell / скриптов
- Область аудита: GitHub obra/superpowers/skills/systematic-debugging/SKILL.md (сканируется только текст SKILL.md)
Обоснование
- За последние 24 часов количество установок skills.sh составило 1239, общее число установок — 333427 (отражает только уровень интереса); лицензия MIT
- Выполняемые команды, указанные в предупреждении аудита (git diff и добавление логов для диагностики), используются на этапе расследования и соответствуют назначению инструмента; это оригинальный репозиторий obra, а не клонированный аккаунт
Использование
- После установки агент автоматически проходит четырехэтапную диагностику при обнаружении ошибок или сбоев тестов; также можно явно указать: «Сначала не исправляй, найди корневую причину этой проблемы»
Риски
- Во время диагностики в код временно добавляются логи для отладки и выполняются команды; после завершения необходимо убедиться, что эти изменения удалены