Superpowers

Superpowers — это полноценная методология разработки программного обеспечения для ваших кодирующих агентов, построенная на основе набора композируемых навыков и некоторых начальных инструкций, которые гарантируют, что ваш агент будет их использовать.

Содержание

• Как это работает
• Коммерческие услуги
• Начало работы
  • Claude Code
  • Antigravity
  • Codex App
  • Codex CLI
  • Cursor
  • Devin CLI
  • Factory Droid
  • Gemini CLI
  • GitHub Copilot CLI
  • Grok Build CLI
  • Kimi Code
  • OpenCode
  • Pi
  • Hermes Agent
• Базовый рабочий процесс
• Сообщество
• Что внутри
• Философия
• Участие в разработке
• Обновление
• Лицензия
• Телеметрия визуального помощника

Как это работает

Всё начинается с момента запуска вашего кодирующего агента. Как только он видит, что вы что-то создаёте, он не сразу бросается писать код. Вместо этого он отступает и спрашивает, что вы на самом деле хотите сделать.

Как только из разговора удаётся выявить спецификацию, агент показывает её вам частями, достаточно короткими, чтобы их можно было прочитать и усвоить.

После того как вы одобрили дизайн, ваш агент составляет план реализации, достаточно понятный для того, чтобы его мог выполнить энтузиаст-младший инженер с плохим вкусом, без осуждения, без контекста проекта и с нежеланием тестировать. В плане делается упор на настоящий TDD (разработка через тестирование) по принципу "красный/зелёный", YAGNI (Вам это не понадобится) и DRY (Не повторяйся).

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

В системе есть ещё много чего, но это её основа. А поскольку навыки срабатывают автоматически, вам не нужно делать ничего особенного. Ваш кодирующий агент просто получает Superpowers.

Коммерческие услуги

Если вы используете Superpowers в корпоративной среде и могли бы извлечь пользу из коммерческой поддержки, дополнительных инструментов или управляемых расходов, не стесняйтесь написать нам по адресу sales@primeradiant.com.

Установка

Установка зависит от используемой оболочки. Если вы используете несколько, установите Superpowers отдельно для каждой из них.

Claude Code

Superpowers доступен через официальный магазин плагинов Claude

Официальный магазин

• Установите плагин из официального магазина Anthropic:

  bash /plugin install superpowers@claude-plugins-official

Магазин Superpowers

Магазин Superpowers предоставляет Superpowers и некоторые другие связанные плагины для Claude Code.

• Зарегистрируйте магазин:

  bash /plugin marketplace add obra/superpowers-marketplace

• Установите плагин из этого магазина:

  bash /plugin install superpowers@superpowers-marketplace

Antigravity

Установите Superpowers как плагин из этого репозитория:

agy plugin install https://github.com/obra/superpowers

Antigravity запускает хук начала сессии плагина, поэтому Superpowers активен с первого сообщения. Переустановите с помощью той же команды для обновления.

Codex App

Superpowers доступен через официальный магазин плагинов Codex.

• В приложении Codex нажмите на Plugins в боковой панели.
• Вы должны увидеть Superpowers в разделе Coding.
• Нажмите + рядом с Superpowers и следуйте инструкциям.

Codex CLI

Superpowers доступен через официальный магазин плагинов Codex.

• Откройте интерфейс поиска плагинов:

  bash /plugins

• Найдите Superpowers:

  bash superpowers

• Выберите Install Plugin.

Cursor

• В чате Cursor Agent установите из магазина:

  text /add-plugin superpowers

• Или найдите "superpowers" в магазине плагинов.

Devin CLI

• Установите плагин из этого репозитория:

  bash devin plugins install obra/superpowers

• Обновите до последней версии с помощью:

  bash devin plugins update superpowers

Factory Droid

• Зарегистрируйте магазин:

  bash droid plugin marketplace add https://github.com/obra/superpowers

  ---

• Установите плагин:

  bash droid plugin install superpowers@superpowers

Gemini CLI

• Установите расширение:

  bash gemini extensions install https://github.com/obra/superpowers

• Обновите позже:

  bash gemini extensions update superpowers

GitHub Copilot CLI

• Зарегистрируйте маркетплейс:

  bash copilot plugin marketplace add obra/superpowers-marketplace

• Установите плагин:

  bash copilot plugin install superpowers@superpowers-marketplace

Grok Build CLI

Superpowers доступен через официальный маркетплейс плагинов Grok.

• Установите плагин из официального маркетплейса xAI:

  bash grok plugin install superpowers@xai-official --trust

• Или откройте маркетплейс в TUI, найдите Superpowers и установите его:

  text /marketplace

Kimi Code

Superpowers доступен в маркетплейсе плагинов Kimi Code.

• Откройте менеджер плагинов Kimi Code:

  text /plugins

• Перейдите в Marketplace > Superpowers и установите его.

• Или установите напрямую из этого репозитория:

  text /plugins install https://github.com/obra/superpowers

• Подробная документация: docs/README.kimi.md

OpenCode

OpenCode использует собственную установку плагинов; установите Superpowers отдельно, даже если вы уже используете его в другой оболочке.

• Сообщите OpenCode:

  Загрузите и следуйте инструкциям с https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md

• Подробная документация: docs/README.opencode.md

Pi

Установите Superpowers как пакет Pi из этого репозитория:

pi install git:github.com/obra/superpowers

Для локальной разработки запустите Pi с этой копией, загруженной как временный пакет:

pi -e /path/to/superpowers

Пакет Pi загружает навыки Superpowers и небольшое расширение, которое внедряет загрузчик using-superpowers при старте сессии и повторно после компактификации. Pi имеет собственные навыки, поэтому не требуется совместимый инструмент Skill. Инструменты суб-агентов и списка задач остаются дополнительными пакетами-компаньонами для Pi.

Hermes Agent

Установите Superpowers как плагин Hermes из этого репозитория:

hermes plugins install obra/superpowers --enable

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

Основной рабочий процесс

1. мозговой штурм — Активируется перед написанием кода. Уточняет сырые идеи через вопросы, исследует альтернативы, представляет дизайн по разделам для проверки. Сохраняет документ с дизайном.

2. использование-git-worktrees — Активируется после одобрения дизайна. Создаёт изолированное рабочее пространство в новой ветке, выполняет настройку проекта, проверяет чистую базовую линию тестов.

3. написание-планов — Активируется с одобренным дизайном. Разбивает работу на небольшие задачи (по 2–5 минут каждая). Каждая задача содержит точные пути к файлам, полный код, шаги проверки.

4. разработка-на-основе-суб-агентов или выполнение-планов — Активируется с планом. Запускает свежего суб-агента на каждую задачу с двухэтапной проверкой (соответствие спецификации, затем качество кода) или выполняет задачи пакетами с контрольными точками для человека.

5. разработка-через-тестирование — Активируется во время реализации. Следует циклу RED-GREEN-REFACTOR: пишет падающий тест, наблюдает его падение, пишет минимальный код, наблюдает его прохождение, фиксирует изменения. Удаляет код, написанный до тестов.

6. запрос-код-ревью — Активируется между задачами. Проверяет соответствие плану, сообщает об ошибках по степени серьёзности. Критические ошибки блокируют прогресс.

7. завершение-ветки-разработки — Активируется по завершении задач. Проверяет тесты, предлагает варианты (слияние/PR/сохранение/удаление), очищает рабочее пространство.

Агент проверяет наличие соответствующих навыков перед любой задачей. Это обязательные этапы рабочего процесса, а не рекомендации.

Сообщество

Superpowers разработан Джесси Винсентом и остальными участниками Prime Radiant.

• Discord: Присоединяйтесь для поддержки сообщества, вопросов и демонстрации того, что вы создаёте с помощью Superpowers
• Баг-трекер: https://github.com/obra/superpowers/issues
• Анонсы релизов: Подпишитесь, чтобы получать уведомления о новых версиях

Что внутри

Библиотека навыков

Тестирование - разработка-через-тестирование — Цикл RED-GREEN-REFACTOR (включает справочник анти-паттернов тестирования)

Отладка - systematic-debugging — четырёхэтапный процесс поиска первопричины (включает трассировку первопричин, глубокую защиту, ожидание по условиям) - verification-before-completion — Убедитесь, что проблема действительно устранена

Совместная работа - brainstorming — Уточнение дизайна методом сократического вопрошания - writing-plans — Детальные планы реализации - executing-plans — Пакетное выполнение с контрольными точками - dispatching-parallel-agents — Параллельные рабочие процессы подагентов - requesting-code-review — Чек-лист перед ревью - receiving-code-review — Реакция на обратную связь - using-git-worktrees — Параллельные ветки разработки - finishing-a-development-branch — Рабочий процесс принятия решения о слиянии/PR - subagent-driven-development — Быстрая итерация с двухэтапным ревью (соответствие спецификации, затем качество кода)

Мета - writing-skills — Создание новых навыков с соблюдением лучших практик (включает методологию тестирования) - using-superpowers — Введение в систему навыков

Философия

• Разработка через тестирование — Пишите тесты в первую очередь, всегда
• Систематичность вместо импровизации — Процесс важнее догадок
• Снижение сложности — Простота как основная цель
• Факты важнее утверждений — Проверяйте перед объявлением успеха

Прочтите оригинальное объявление о релизе.

Участие в разработке

Общий процесс внесения вклада в Superpowers описан ниже. Учтите, что мы, как правило, не принимаем вклад в виде новых навыков, а любые обновления навыков должны работать со всеми поддерживаемыми кодинговыми агентами.

1. Форкните репозиторий
2. Переключитесь на ветку «dev»
3. Создайте ветку для своей работы
4. Следуйте навыку writing-skills для создания и тестирования новых и изменённых навыков
5. Отправьте PR, заполнив шаблон пулл-реквеста.

Тесты поведения навыков используют оценочный фреймворк drill из superpowers-evals, клонированный в evals/ — см. evals/README.md для настройки. Тесты инфраструктуры плагинов находятся в tests/ и запускаются через соответствующие run-*.sh или npm test.

Полное руководство см. в skills/writing-skills/SKILL.md.

Обновление

Обновления Superpowers в некоторой степени зависят от кодингового агента, но часто выполняются автоматически.

Лицензия

Лицензия MIT — подробности см. в файле LICENSE.

Телеметрия визуального компаньона

Поскольку навыки и плагины не предоставляют создателям обратной связи, мы не имеем представления о том, сколько людей используют Superpowers. По умолчанию логотип Prime Radiant в необязательной функции визуального компаньона для мозгового штурма загружается с нашего сайта. Он включает версию используемого Superpowers. При этом не передаются никакие данные о вашем проекте, запросе или кодинговом агенте. Мы не видим ваши клики и ничего о том, что вы создаёте. Это помогает нам получить приблизительное представление о количестве пользователей Superpowers и о том, какую версию они используют. Эта функция полностью необязательна. Чтобы отключить её, установите переменную окружения SUPERPOWERS_DISABLE_TELEMETRY в любое истинное значение. Superpowers также учитывает отказы от телеметрии Claude Code: DISABLE_TELEMETRY и CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC.