Просьба «добавь экспорт отчёта» оставляет десятки решений открытыми. Какой формат нужен, какие данные включать, что делать с пустой выборкой? Если агент сразу пишет код, эти решения могут появиться в реализации раньше, чем пользователь увидит их последствия.
Superpowers предлагает организовать такой процесс через набор скиллов. Его полезность стоит оценивать по тому, помогает ли процедура принять решения и проверить итог, а не по количеству этапов.
Что входит в идею Superpowers
В официальном репозитории проект описан как методология разработки для AI-агентов, основанная на комбинируемых навыках. Основной маршрут связывает уточнение задачи, согласование решения, планирование, выполнение и проверку. В README также описаны способы подключения для разных агентных клиентов.
Это дополнительный слой процесса поверх выбранной среды и модели. Он не заменяет знание проекта, разрешения инструментов или средства проверки программы. Наличие пакета не доказывает, что текущий клиент загрузил нужный скилл и применил его в конкретном задании.
Когда процесс помогает
Этап уточнения полезен, если от ответа зависит поведение продукта. Для экспорта отчёта это может быть включение персональных данных, формат чисел или права получателя. Короткая схема позволяет увидеть решение до реализации.
План нужен, когда изменение состоит из зависимых частей. Например, сначала определить формат, затем изменить формирование данных, после этого интерфейс и проверку. При независимых задачах можно разделить работу, но цена координации тоже входит в процесс.
Проверка нужна там, где завершение должно означать наблюдаемое поведение. Сохранённый файл, прошедшая проверка и доступная пользователю функция являются разными результатами. Агенту стоит заранее сообщить, какой из них требуется.
Учебный сценарий: экспорт отчёта
Начальная задача: пользователь хочет выгружать результаты фильтрации в CSV. В примере выбраны такие условия: выгружаются только видимые строки, заголовки сохраняются, пустая выборка даёт файл с заголовком. Это условия учебного задания, а не универсальное правило CSV-экспорта.
| Этап | Полезный результат | Признак лишней работы |
|---|---|---|
| Уточнение | Решены вопросы состава и формата | Повторно спрашиваются уже заданные условия |
| Проектирование | Видны поведение и ограничения | Обсуждение не меняет ни одного решения |
| План | Названы небольшие шаги и проверки | План длиннее и сложнее самой задачи |
| Выполнение | Изменения соответствуют условиям | Возникает незапрошенная переработка проекта |
| Приёмка | Есть результат на обычном и пустом входе | Список действий заменяет проверку функции |
Наше предложение для постановки:
> Подготовь экспорт CSV по указанным условиям. На этапе уточнения спрашивай только о решениях, которые действительно меняют результат. Затем покажи короткий план. В реализации сохраняй существующие соглашения проекта. Подтверди работу на обычной и пустой выборке. Отдельно сообщи, если какая-то проверка не выполнялась.
Эта формулировка описывает желаемую работу. Она не является обходом правил конкретного скилла: если подключённая процедура требует дополнительных этапов, её содержание следует прочитать и оценить заранее.
Как не перегрузить процесс
Для простого исправления опечатки подробное проектирование может не дать пользы. Для изменения публичного API отсутствие проектирования может обойтись дорого. Поэтому выбирайте рабочую процедуру с учётом последствий задачи и уже известных условий.
Если пакет регулярно заставляет обсуждать решённые вопросы, проверьте вызываемый скилл, его версию и переданный контекст. Проблема может быть в несовместимых инструкциях, а не в модели. Не стоит лечить её ещё одним длинным общим промптом поверх прежнего.
Для работы нескольких исполнителей определите владение файлами и критерии результата каждого. Две параллельные правки одного файла могут потребовать больше согласования, чем последовательная работа. Участие нескольких агентов само по себе не является независимой проверкой.
По каким признакам оценивать пользу
Сравнивайте сходные задачи по объёму переделок, числу пропущенных условий и возможности проверить результат. Удобно отдельно учитывать время обсуждения и время исправлений после приёмки. Сокращение одного без учёта другого может дать ложный вывод.
В этом материале нет измеренного выигрыша от Superpowers. Мы описываем подход и условия, при которых его стоит оценивать. Обещания качества из описания проекта не считаем собственными результатами испытаний.
Рассматривайте Superpowers вместе с Codex CLI или Claude Code. Для постоянных правил проекта полезна статья о AGENTS.md и CLAUDE.md.