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

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

Большинство установок SDD для Claude Code проваливаются одинаково: кто-то один раз создает надежный навык specify-plan-implement, тщательно им пользуется в течение недели, а затем при приближении дедлайна невольно возвращается к неструктурированному промптингу. Ничто в самодельном навыке не может этого остановить. Superpowers — это прямой ответ на проблему с дисциплиной: это пакет навыков, разработанный Джиссом Винсентом (Jesse Vincent) и командой из 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, поэтому одна и та же методология следует за вами через различные среды выполнения (harnesses), а не существует в папке .claude/skills/ одного репозитория. Это руководство рассказывает о том, что это на самом деле такое, как установить и проверить его в используемом вами агенте, как выглядит первый сквозной запуск и как он соотносится с другими инструментами разработки по спецификациям.

Что такое Superpowers?

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

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

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

На практике эта философия проявляется в последовательности навыков, передающих управление друг другу. Если вы читали Claude Skills и SKILL.md для разработчиков, механика покажется вам знакомой — 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 загружает навыки через небольшое расширение, которое инъектирует бутстрап using-superpowers при запуске сессии и после сжатия контекста, и не требует инструмента совместимости Skill от Pi, поскольку у Pi есть нативная поддержка навыков.
• Hermes Agent не имеет хука после сжатия контекста (compaction) — очень длинная сессия, которая сжимает контекст после первого хода, может потерять бутстрап, поэтому начинайте новую сессию, если навыки перестали срабатывать.
• 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.

Это тесно соотносится с нейтральным к инструментам пятифазным циклом в Рабочий процесс разработки по спецификациям: от требований к коду: спецификация становится мозговым штурмом, план становится writing-plans, задачи и реализация сворачиваются в subagent-driven-development, а валидация распределяется между TDD и кодовым ревью. Разница заключается в принуждении — Superpowers создан так, чтобы агент автоматически проверял наличие этих навыков, а не полагался на то, что вы вызовете каждый этап.

Попробуем: пошаговое руководство по первой задаче

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

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

С установленным Superpowers ожидайте, что сессия начнется с вопросов мозгового штурма, а не с кода: какие endpoints, какой лимит, на пользователя или на ключ, что должно происходить при достижении лимита. Это трение намеренно — это та же самая дисциплина не-целей, о которой говорится в Рабочем процессе разработки по спецификациям: от требований к коду, только она обеспечивается навыком, а не зависит от вашей памяти. После того как вы одобрите дизайн фрагментами, ожидайте план с нумерованными небольшими задачами до изменения любого файла, затем одного субагента, отправляемого на каждую задачу, с диффом, который вы проверяете на каждой контрольной точке.

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

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

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

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

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

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

Хорошее применение:

• Вы уже подходите к Разработке по спецификациям против Вайб-кодинга подходу Claude Skills, но продолжаете возвращаться к неструктурированному промптингу, потому что ничто не принуждает к контрольным точкам ревью.
• Вы работаете с несколькими кодинг-агентами и хотите одну методологию, которая следует за вами, а не навык, привязанный только к Claude Code.
• Вы хотите строгого соблюдения TDD, не написав логику принуждения самостоятельно.
• Функции, растянутые на несколько сессий, где архитектурный дрейф и забытые ограничения — реальный риск, — точный режим отказа, описанный в Разработке по спецификациям против Вайб-кодинга.

Менее подходящее применение:

• Быстрые скрипты, одноразовые прототипы и разовая автоматизация — накладные расходы на мозговой штурм и планирование реальны, и они не стоят того, чтобы платить за них при изменении в пятьдесят строк.
• Команды с существующим, хорошо настроенным специфичным для проекта навыком 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, но с ощущаемым принуждением и кросс-агентным дистрибуцией плагинов, которые не предоставляет локальный для репозитория навык.

Для полного разбора переносимости, трения при настройке, контрольных точек ревью и привязки к поставщику между Spec Kit, Kiro, навыками Claude Code, OpenSpec, BMAD-METHOD и Tessl — включая то, где Superpowers находится в таблице сравнения и фреймворке принятия решений — см. GitHub Spec Kit vs Kiro vs Рабочие процессы Claude Code SDD. Если вы хотите меньше принудительного церемониала и больше свободы для итераций в brownfield-кодовой базе, быстрый старт OpenSpec охватывает более легкую, центрированную на изменениях альтернативу. И если роли, которые вам не хватает, — это те, которые Superpowers не покрывает — продуктовое ревью, браузерное QA, аудит безопасности, релизная инженерия — gstack упаковывает их как виртуальную команду инженерии, которая может быть объединена с Superpowers, где Superpowers обеспечивает дисциплину внутри фазы реализации.

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

Обновления в основном автоматические, но зависят от агента. Насколько актуальной останется ваша установка, зависит от среды выполнения — 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 нуждаются в новом запуске после сжатия контекста длинной сессии, если бутстрап молча теряется.

Заключение

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

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

• Репозиторий Superpowers — исходный код, навыки и манифесты плагинов для всех поддерживаемых агентов
• Маркетплейс Superpowers — маркетплейс Claude Code для Superpowers и связанных плагинов
• GitHub Spec Kit vs Kiro vs Рабочие процессы Claude Code SDD — полное сравнение инструментов и фреймворк принятия решений
• Claude Skills и SKILL.md для разработчиков — лежащие в основе механики навыков, на которых строится Superpowers
• Субагенты Claude Code: настройка, конфигурация и когда их использовать — ревью с изолированным контекстом, механизм, лежащий в основе subagent-driven-development
• Рабочий процесс разработки по спецификациям: от требований к коду — нейтральный к инструментам пятифазный процесс, который автоматизирует Superpowers
• Что такое разработка по спецификациям? Спецификация как источник истины — основные концепции и терминология SDD
• Установка и конфигурация Claude Code для Ollama, llama.cpp, цены — сначала установите сам Claude Code перед добавлением Superpowers