Быстрый старт с Superpowers: установка, рабочий процесс и тестирование

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

Большинство конфигураций SDD (Spec-Driven Development) в Claude Code проваливаются одинаково: кто-то однажды пишет надежный навык specify-plan-implement, усердно использует его в течение недели, а затем, как только приближается дедлайн, незаметно возвращается к неструктурированному промптингу. Ничто в самодельном навыке не в состоянии этому помешать. Superpowers — это прямой ответ на проблему дисциплины: пакет навыков, созданный Джесси Вайнентом и командой Prime Radiant, который рассматривает мозговой штурм, планирование, ревью субагентами и TDD по схеме «красный-зеленый-рефакторинг» как обязательные шаги, которые агент проверяет перед каждой задачей, а не как необязательные предложения, от которых можно отказаться под давлением.

То, что делает этот инструмент заслуживающим отдельного внимания, а не просто упоминания в сноске, — это процесс установки. Superpowers поставляется с манифестами плагинов для Claude Code, Cursor, Codex, Gemini CLI, GitHub Copilot CLI, Grok Build CLI, Kimi Code, OpenCode, Pi, Devin CLI, Factory Droid и Hermes Agent, поэтому одна и та же методология следует за вами через разные среды разработки, а не заперта в папке .claude/skills/ одного репозитория. В этом руководстве рассматривается, что это такое на самом деле, как установить и проверить его в том агенте, которым вы пользуетесь, как выглядит первый сквозной запуск и где он встает в ряд с другими инструментами разработки, управляемой спецификациями.

Что такое Superpowers?

Superpowers описывает себя как «полную методологию разработки программного обеспечения для ваших кодинг-агентов, построенную на наборе компонуемых навыков и некоторых начальных инструкциях, которые гарантируют, что ваш агент будет их использовать». Именно эта последняя оговорка имеет решающее значение. Существует множество коллекций навыков; отличие здесь заключается в инструкции по инициализации (bootstrap), которая принуждает агента проверять наличие релевантных навыков перед началом любой задачи, благодаря чему рабочий процесс активируется автоматически, а не требует от вас запоминания команды со слэшем.

Философия, стоящая за этим проектом, изложена прямо в его собственной документации:

• Тест-драйвеная разработка (TDD) — сначала пишите тесты, всегда
• Системность вместо импровизации — процесс важнее догадок
• Снижение сложности — простота как главная цель
• Доказательства вместо заявлений — верифицируйте перед объявлением успеха

На практике эта философия проявляется в виде последовательности навыков, которые передают управление друг другу. Если вы читали Claude Skills and SKILL.md for Developers, механика покажется вам знакомой — Superpowers представляет собой большой, субъективно выстроенный набор именно таких каталогов SKILL.md, распространяемый в виде устанавливаемого плагина, а не чего-то, что вы создаете самостоятельно.

Установка Superpowers в разных кодинг-агентах

Установка специфична для каждой среды разработки (harness), и проект прямо указывает, что вы должны устанавливать его отдельно для каждого агента, которым пользуетесь, — универсальной глобальной установки не существует.

Claude Code

Superpowers распространяется через два маркетплейса для Claude Code:

# Официальный маркетплейс плагинов Anthropic
/plugin install superpowers@claude-plugins-official

Или через специализированный маркетплейс Superpowers, который также содержит несколько связанных плагинов:

/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace

Cursor

/add-plugin superpowers

Вы также можете напрямую поискать «superpowers» в пользовательском интерфейсе маркетплейса плагинов Cursor.

Другие агенты

Перед тем как выполнять реальную задачу, стоит обратить внимание на несколько деталей установки:

• Antigravity автоматически запускает хук начала сессии плагина, поэтому Superpowers активен с первого сообщения; переустановите с той же командой для обновления.
• Pi загружает навыки через небольшое расширение, которое внедряет bootstrap using-superpowers при запуске сессии и после компактизации контекста, и не требует инструмента совместимости Skill в Pi, поскольку Pi имеет нативную поддержку навыков.
• Hermes Agent не имеет хука после компактизации — очень длинная сессия, которая подвергается компактизации после первого хода, может потерять bootstrap, поэтому начните новую сессию, если навыки перестанут срабатывать.
• OpenCode рассматривает это как полностью отдельный путь установки от любой другой среды разработки, которой вы уже пользуетесь, даже на том же компьютере.

Проверка установки

После установки спросите агента напрямую, а не доверяйте беззвучному сообщению об успехе:

What skills are available?

Если Superpowers установлен корректно, агент должен перечислить среди результатов навыки, такие как brainstorming, writing-plans, test-driven-development и subagent-driven-development. Это та же самая проверка обнаружения, которая рекомендуется для отладки Claude Skills, которые не срабатывают — если навык существует, но никогда не активируется, проблема почти всегда в описании маршрутизации, а не в модели.

Рабочий процесс Superpowers: от мозгового штурма до готового кода

Superpowers документирует семь навыков как «базовый рабочий процесс», каждый из которых активируется в определенной точке и передает управление следующему:

⬇

1. brainstorming активируется до написания какого-либо кода. Он дорабатывает грубую идею через вопросы, исследует альтернативы и представляет дизайн короткими, проверяемыми фрагментами, а не одним длинным документом, — затем сохраняет результат в виде артефакта дизайна.
2. using-git-worktrees активируется, когда вы утверждаете дизайн. Он создает изолированную рабочую область на новой ветке, запускает настройку проекта и проверяет чистую базовую линию тестов перед началом реализации.
3. writing-plans разбивает утверждённый дизайн на небольшие задачи — Superpowers ориентируется на две-пять минут работы на задачу — с точными путями к файлам, полным кодом там, где это уместно, и явными шагами верификации.
4. subagent-driven-development (быстрая итерация) или executing-plans (пакетное выполнение с контрольными точками для человека) назначает нового субагента на каждую задачу, с двухэтапным ревью: сначала соответствие спецификации, затем качество кода.
5. test-driven-development обеспечивает строгий цикл «красный-зеленый-рефакторинг» — напишите проваливающийся тест, посмотрите, как он падает, напишите минимальный код для прохождения, посмотрите, как он проходит, закоммитьте. Код, написанный до того, как для него существовал проваливающийся тест, удаляется, а не сохраняется.
6. requesting-code-review активируется между задачами, ревьюит дифф по сравнению с планом и сообщает о проблемах по степени серьезности; критические проблемы блокируют переход к следующей задаче.
7. finishing-a-development-branch активируется, когда все задачи завершены. Он проверяет, что тесты проходят, затем предлагает варианты — слияние, открытие PR, сохранение ветки или удаление — и наводит порядок в рабочей области (worktree).

Это тесно соответствует инструментально-нейтральному циклу из пяти фаз в Spec-Driven Development Workflow From Requirements to Code: «спецификация» становится мозговым штурмом, «план» — написанием планов, «задачи и реализация» складываются в subagent-driven-development, а «валидация» распределяется между TDD и ревью кода. Разница заключается в принуждении — Superpowers построен так, чтобы агент автоматически проверял наличие этих навыков, а не полагался на вас для вызова каждой фазы.

Практика: обзор первой задачи

Не направляйте Superpowers на вашу самую важную функцию в первый раз. Выберите что-то реальное, но ограниченное — небольшой эндпоинт, целевое исправление бага, рефакторинг одного модуля — и начните сессию в проекте, у которого уже есть набор тестов, поскольку принуждение к TDD наиболее заметно именно там.

I want to add rate limiting to our public API endpoints.

С установленным Superpowers ожидайте, что сессия откроется вопросами для мозгового штурма, а не кодом: какие эндпоинты, какой лимит, на пользователя или на ключ, что должно произойти при достижении лимита. Это трение намеренно — это та же самая дисциплина «не-целей», о которой рассказывается в Spec-Driven Development Workflow From Requirements to Code, просто принуждаемая навыком, а не оставленная на ваше воспоминание. После того как вы утвердите дизайн фрагментами, ожидайте план с пронумерованными, небольшими задачами до каких-либо изменений в файлах, затем одного субагента, назначенного на каждую задачу, с диффом, который вы ревьюите на каждой контрольной точке.

Две вещи, за которыми нужно следить при первом запуске:

• Убедитесь, что TDD действительно принуждается. Попросите агента реализовать одну задачу и проверьте, появляется ли проваливающийся тест до реализации. Если код появляется первым, навык не сработал для этого шага, и стоит повторно выполнить проверку обнаружения из раздела установки.
• Следите за гранулярностью задач. Размер задачи от двух до пяти минут является агрессивным для некоторых кодовых баз. Если задачи кажутся вам излишне фрагментированными для вашего проекта, это стоит поднять на контрольной точке ревью writing-plans, а не постфактум.

Что внутри: библиотека навыков

Помимо семи навыков рабочего процесса, Superpowers поставляется с поддерживающими навыками, сгруппированными по областям:

dispatching-parallel-agents заслуживает отдельного упоминания: он охватывает параллельные рабочие процессы субагентов, что является той же территорией, что и субагенты Claude Code — изолированный контекст, независимое ревью и сводка, возвращаемая в основную сессию, вместо того чтобы затапливать ее промежуточным выводом.

Когда Superpowers подходит (а когда нет)

Хорошее соответствие:

• Вам уже нравится подход Claude skills к Spec-Driven Development vs Vibe Coding, но вы постоянно возвращаетесь к неструктурированному промптингу, потому что ничто не принуждает к шлюзам ревью.
• Вы работаете с несколькими кодинг-агентами и хотите одну методологию, которая следует за вами, а не навык, специфичный только для Claude Code.
• Вы хотите строгое принуждение к TDD, не написав логику принуждения самостоятельно.
• Функции, охватывающие несколько сессий, где архитектурный дрейф и забытые ограничения представляют реальный риск — именно тот режим отказа, который описан в Spec-Driven Development vs Vibe Coding.

Более слабое соответствие:

• Быстрые скрипты, одноразовые прототипы и разовая автоматизация — накладные расходы на мозговой штурм и планирование реальны, и они не стоят того, чтобы платить за них на изменениях в пятьдесят строк.
• Команды, у которых есть существующий, хорошо настроенный проект-специфичный навык SDD. Superpowers обменивает эту кастомизацию на принуждаемую, субъективную церемонию; вы можете предпочесть сохранить то, что уже работает, и позаимствовать только идеи отдельных навыков.
• Среды, где строгая гранулярность задач от двух до пяти минут или обязательное TDD будут конфликтовать с устоявшимся процессом команды, который вы не готовы менять.

Чем Superpowers отличается от других инструментов SDD

Superpowers не является конкурентом GitHub Spec Kit или AWS Kiro в обычном смысле — он работает на уровне навыков Claude Code / кросс-агентных, а не как автономный CLI или IDE. Spec Kit дает вам переносимые markdown-артефакты и независимость агентов; Kiro дает вам направляемый, интегрированный опыт IDE; самодельный навык Claude Code дает вам максимальную гибкость с нулевым принуждением. Superpowers находится между последними двумя: тот же механизм на основе навыков, что и в DIY-рабочем процессе Claude Code, но с ощущением обязательного принуждения и кросс-агентным распространением плагинов, который не предоставляет локальный для репозитория навык.

Для полного разбора переносимости, сложности настройки, шлюзов ревью и привязки (lock-in) между Spec Kit, Kiro, навыками Claude Code, OpenSpec, BMAD-METHOD и Tessl — включая то, где Superpowers находится в таблице сравнения и рамке принятия решений, — см. GitHub Spec Kit vs Kiro vs Claude Code SDD Workflows.

Устранение неполадок и важные моменты

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

Телеметрия включена по умолчанию, но легко отключается. Необязательный визуальный компаньон навыка мозгового штурма загружает логотип Prime Radiant с их веб-сайта, что включает вашу версию Superpowers, но не данные о проекте, промптах или кликах. Установите SUPERPOWERS_DISABLE_TELEMETRY в любое истинное значение, чтобы отключить ее. Superpowers также уважает собственные опции отключения DISABLE_TELEMETRY и CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC в Claude Code.

Вклад требует ветки dev. Если вы хотите изменить или добавить навыки, сделайте форк репозитория, переключитесь на dev и следуйте навыку writing-skills для создания и тестирования изменений — вклады новых навыков, как правило, не принимаются, поскольку каждый навык должен работать идентично во всех поддерживаемых агентах.

Если навык не срабатывает, относитесь к этому как к любой другой проблеме с Claude Skill. Спросите «What skills are available?», чтобы подтвердить обнаружение, проверьте, что вы установили его для конкретного агента, которым вы сейчас пользуетесь (а не для другого на том же компьютере), и помните, что сессиям Hermes нужен свежий старт после компактизации длинных сессий, если bootstrap тихо теряется.

Заключение

Superpowers стоит устанавливать, когда разрыв между вашими намерениями в области SDD и тем, что на самом деле происходит в сессии, является проблемой, которую вы пытаетесь решить. Он не вводит новую идею specify-plan-implement — этот цикл уже хорошо охвачен в What Is Spec-Driven Development? — он делает существующую идею сложнее для пропуска, и делает это в большем количестве агентов, чем может охватить локальный для репозитория навык. Сначала установите его в той среде разработки, которой вы пользуетесь ежедневно, прогоните небольшую ограниченную задачу через полный цикл от мозгового штурма до завершения, а затем решите, оправдывает ли принуждаемая церемония свои затраты на вашей реальной нагрузке.

Полезные ссылки

• Репозиторий Superpowers — исходный код, навыки и манифесты плагинов для всех поддерживаемых агентов
• Маркетплейс Superpowers — маркетплейс Claude Code для Superpowers и связанных плагинов
• GitHub Spec Kit vs Kiro vs Claude Code SDD Workflows — полное сравнение инструментов и рамка принятия решений
• Claude Skills and SKILL.md for Developers — базовые механики навыков, на которых строится Superpowers
• Claude Code Subagents: Setup, Config, and When to Use Them — ревью с изолированным контекстом, механизм, лежащий в основе subagent-driven-development
• Spec-Driven Development Workflow From Requirements to Code — инструментально-нейтральный процесс из пяти фаз, который автоматизирует Superpowers
• What Is Spec-Driven Development? The Spec as Source of Truth — основные концепции и терминология SDD
• Claude Code install and config for Ollama, llama.cpp, pricing — установка самого Claude Code перед добавлением Superpowers