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

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

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

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

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

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

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

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

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

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

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

Какие навыки доступны?

Если 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 активируется между задачами, ревью diff по плану и сообщает о проблемах по степени серьезности; критические проблемы блокируют переход к следующей задаче.
7. finishing-a-development-branch активируется, как только все задачи выполнены. Он проверяет, что тесты проходят, затем предлагает варианты — слияние, открытие PR, сохранение ветки или отмена, — и очищает worktree.

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

Пробуем в деле: обзор первой задачи

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

Я хочу добавить ограничение частоты запросов к нашим публичным API-эндпоинтам.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Обновления в основном автоматические, но зависят от агента. Насколько актуальным останется ваша установка, зависит от среды: 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. Спросите «Какие навыки доступны?», чтобы подтвердить обнаружение, проверьте, что вы установили его для конкретного агента, которым вы сейчас пользуетесь (а не для другого на той же машине), и помните, что сессии Hermes требуют нового запуска после компактизации длинной сессии, если загрузочный код тихо теряется.

Заключение

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

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

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