Суперспособности
Superpowers — это набор навыков для рабочего процесса разработки для инструментов ИИ-программирования. Он заставляет ИИ уточнять требования и составлять планы перед написанием кода, сокращая количество повторных правок.
Типичные сложности в ИИ-кодинге
После того как вы описываете требования, ИИ сразу начинает писать код. Только написав сотни строк, вы понимаете, что направление выбрано неверно: граничные случаи не обработаны, стиль интерфейса не совпадает, а ключевая логика понята неправильно.
Затем вы снова и снова вносите изменения, иногда тратя больше времени на исправление курса, чем на первоначальное написание кода.
Что ещё хуже — сложные требования, включающие несколько модулей и поэтапную реализацию. ИИ постепенно сбивается с курса во время написания, и к тому моменту, как вы это заметите, многие файлы уже изменены, что делает откат проблематичным.
Корневая причина
По умолчанию инструменты для ИИ-кодинга после получения требованийсразу пишут код。
Это нормально для простых задач, но для чуть более сложных требований «прямое написание» пропускает критически важный шаг:полное понимание требований。
Каждая неоднозначность в требованиях в конечном итоге становится проблемой в коде. ИИ не проявляет инициативу и не задаёт вопросы, и у него нет систематического плана реализации. Он просто движется вперёд, исходя из текущего понимания, и если сбивается с пути, ему приходится возвращаться и всё исправлять.
Если бы ИИ мог сначала уточнить требования, составить план реализации и подтвердить границы, прежде чем писать код, а затем уже наконец начать писать код, весь процесс был бы намного стабильнее.
Что такое Superpowers?
Superpowers — это наборпакетов навыков для рабочего процесса разработки, предназначенных для инструментов ИИ-кодинга.。
Он организует ключевые этапы разработки программного обеспечения — уточнение требований, планирование реализации, разработку через тестирование, ревью кода и управление ветками — в файлы навыков. После загрузки в инструменты ИИ-кодинга ИИ автоматически запускает соответствующий рабочий процесс в нужный момент, без необходимости каждый раз давать подсказки вручную.
Одним предложением:внедрите в ИИ методологию разработки, позвольте ему работать в соответствии с процессом, а не начинать писать код сразу после получения требований.。
| Проект | Информация |
|---|---|
| Репозиторий GitHub | https://github.com/obra/superpowers |
| Лицензия | MIT |
| Поддерживаемые инструменты | Claude Code, Cursor, Codex CLI, Codex App, Gemini CLI, GitHub Copilot CLI |
Обзор рабочего процесса
Основной процесс Superpowers разделён на четыре фазы. У каждой фазы есть чёткие цели и результаты, и ИИ не пропустит ни одного шага.
| Этап | Name | Что он делает | Вывод |
|---|---|---|---|
| 1 | Уточнение требований | ИИ задаёт встречные вопросы, уточняет неясности и представляет планы проектирования по разделам для подтверждения. | Подтверждённый документ с требованиями |
| 2 | Планирование реализации | Разбейте работу на конкретные задачи продолжительностью 2-5 минут каждая. Каждая задача включает файлы, код и методы проверки. | Список выполнимых задач |
| 3 | Выполнение задач | Выполняйте задачи одну за другой. После каждой задачи выполняйте проверку в два раунда (спецификация + качество). | Проверенный код |
| 4 | Сдать код | Подтвердите, что все задачи выполнены и код соответствует стандартам качества. | Код для сдачи |
Установка
У разных инструментов ИИ-программирования разные методы установки. Выберите метод, соответствующий используемому инструменту.
Claude Code (рекомендуется)
Claude Code можно установить напрямую из магазина плагинов.
# 从官方插件市场安装(推荐) /plugin install superpowers@claude-plugins-official
Его также можно установить через собственный магазин Superpowers.
# 添加 Superpowers 市场 /plugin marketplace add obra/superpowers-marketplace # 从 Superpowers 市场安装 /plugin install superpowers@superpowers-marketplace
Cursor
Установите, введя команду в диалоговом окне Agent в Cursor.
# 在 Agent 对话框里输入 /add-plugin superpowers
Вы также можете найти в магазине плагиновsuperpowersи установить.
Codex CLI
# 打开插件管理界面 /plugins # 搜索 superpowers,选择 Install Plugin
Gemini CLI
# 通过扩展安装 gemini extensions install https://github.com/obra/superpowers
Каждый инструмент нужно устанавливать отдельно. Установка в Claude Code не означает, что он также доступен в Cursor.
| Инструмент | Способ установки | Требуется ли что-то дополнительно |
|---|---|---|
| Claude Code | /plugin install | Достаточно официального маркетплейса, или можно использовать маркетплейс Superpowers |
| Cursor | /add-pluginили найдите маркетплейс плагинов | Не требуется |
| Codex CLI | /pluginsПоиск и установка в интерфейсе | Не требуется |
| Gemini CLI | gemini extensions install | Не требуется |
Опыт после установки
После установки вам не нужно изучать новые команды или менять свои рабочие привычки. Просто описывайте требования как обычно; Superpowers автоматически вмешается в фоновом режиме.
При начале работы над новой функцией
После того как вы опишете требования, AIне будетсразу начинать писать код.
Сначала он задаст вам несколько вопросов, уточнит неясности и представит план дизайна по разделам для вашего подтверждения.
Этот этап называетсяbrainstorming, его цель — согласовать требования перед началом работы. После вашего подтверждения AI переходит к следующему шагу.
Переход к этапу реализации
После подтверждения требований AI создаёт план реализации, разбивая работу на конкретные задачи по 2-5 минут каждая.
Каждая задача включает: какие файлы задействованы, какой код писать и как проверять.
Степень детализации плана будет достаточно высокой, чтобы «младший инженер смог выполнить его по описанию» -- это сделано, чтобы субагенты надёжно выполняли каждый шаг и во время выполнения было меньше расхождений в понимании.
Этап выполнения
После утверждения плана ИИ выполняет задачи одну за другой.
После завершения каждой задачи он выполняетдва раунда проверок: сначала проверяет, соответствует ли она проектной спецификации, затем проверяет качество кода.
Если обнаружены проблемы, они решаются в рамках текущей задачи и не переносятся дальше.
Вам не нужно следить за всем процессом выполнения. Просто дайте ИИ работать. Если он застрянет, он приостановится и обратится к вам.
Проверка установки
Например, мы вводим в Claude Code:
Design an attractive mobile phone product promotional page.
Вы увидите superpowers:brainstorming, что означает, что установка прошла успешно:

Типичный сценарий для новичка: разработка приложения Todo с нуля
Предположим, мы хотим реализовать приложение Todo с поддержкой CRUD (React + локальное хранилище).
Традиционный подход с прямым промптом:
用 React 帮我写一个 Todo App。
ИИ обычно генерирует большой объём кода за один раз. На первый взгляд он выглядит функционально полным, но в действительности могут быть следующие проблемы:
- Неправильное управление состоянием
- Отсутствие модульных тестов
- Не обработаны граничные случаи (например, пустые списки, параллельные операции)
- Изменение одного места может легко привести к другим ошибкам
- В результате часто получается код, который трудно поддерживать, а последующие итерации обходятся дорого.
Структурированный подход Superpowers полностью отличается. Он не позволяет ИИ сразу перейти к этапу написания кода, а действует следующим образом:

Подробное объяснение основных рабочих процессов
Superpowers предоставляет три основных рабочих процесса, каждый из которых охватывает свою часть разработки.
Разработка через тестирование (TDD)
test-driven-developmentЭтот навык заставляет ИИ следовать последовательности RED-GREEN-REFACTOR.
Сначала напишите падающий тест, убедитесь, что он падает, затем напишите минимальный код, чтобы он прошёл, и наконец выполните рефакторинг.
Если ИИ пишет код до написания тестов, этот навык потребует удалить код и начать заново.
| Шаг | Name | Что он делает |
|---|---|---|
| RED | Напишите падающий тест | Сначала напишите тест-кейс, который в данный момент падает, проясняя ожидаемое поведение. |
| GREEN | Напишите минимальный код для прохождения | Пишите только минимальный код, необходимый для прохождения теста, и ничего больше. |
| РЕФАКТОРИНГ | Рефакторинг | Оптимизируйте структуру кода под защитой тестов, следя за тем, чтобы тесты по-прежнему проходили. |
Для проектов, не привыкших к TDD, этот процесс может показаться немного некомфортным, но он действительно сокращает число ситуаций, когда баги обнаруживаются позже и приходится возвращаться и исправлять их.
Изоляция Git Worktree
using-git-worktreesПосле подтверждения дизайна автоматически создайте изолированную рабочую ветку.
Таким образом, изменения кода ИИ не загрязняют напрямую основную ветку. Это полезно для параллельной многозадачности или когда требуется откат.
Git Worktree — это нативная функция Git, позволяющая одновременно извлекать несколько веток в разные каталоги в одном и том же репозитории, по сравнению сgit stash + git checkoutболее чистым.
Систематическая отладка
systematic-debuggingНавык заставляет ИИ следовать 4-шаговому процессу устранения неполадок при возникновении проблем, а не гадать.
При возникновении ошибки сначала определите первопричину, затем устраните её, а не начинайте сразу изменять код и смотреть, что получится.
| Шаги | Что сделать | Почему |
|---|---|---|
| 1. Воспроизведите проблему | Подтвердите, что её можно надёжно воспроизвести, и зафиксируйте условия срабатывания | Ошибку, которую нельзя воспроизвести, невозможно подтвердить как исправленную |
| 2. Определите первопричину | Постепенно сужайте область поиска, чтобы найти конкретную строку кода, вызывающую проблему | Исправления, устраняющие только симптомы, приведут к новым проблемам |
| 3. Реализуйте исправление | Измените код на основе первопричины | Сведите объём изменений к минимуму |
| 4. Проверьте исправление | Убедитесь, что проблема решена и новые проблемы не появились | Убедитесь, что исправление эффективно |
Несколько моментов, которые стоит знать перед использованием
Процесс становится длиннее
После установки Superpowers даже простые требования будут проходить анализ требований и планирование перед написанием кода.
Если вы просто исправляете небольшой баг или добавляете строку конфигурации, этот процесс может показаться избыточным.
Superpowers подходит для разработки функций с определённым уровнем сложности. Для простых задач просто позвольте ИИ написать код напрямую — нет необходимости применять весь этот рабочий процесс.
Требует вашего участия в обсуждениях на раннем этапе
мозговой штурмНа этом этапе нужно отвечать на вопросы и подтверждать планы.
Если вы думаете: «просто передайте это ИИ и позвольте ему работать полностью автоматически», такой подход вам не понравится.
Superpowers позиционируется каксовместная разработка человека и ИИ, а не полностью автоматическая генерация кода.
Опыт различается в зависимости от инструмента
В README упоминается, что Claude может работать два часа, не отклоняясь от плана, но этот показатель зависит от инструмента, проекта и сложности задачи, поэтому реальный опыт может отличаться.
| На что обратить внимание | Описание | Применимые сценарии |
|---|---|---|
| Более длительный процесс | Даже простые требования проходят анализ перед реализацией | Разработка функций средней или более высокой сложности |
| Требует участия в обсуждениях | Этап мозгового штурма требует подтверждения плана | Разработчики, готовые потратить время на предварительное согласование |
| Различия в опыте | Производительность варьируется в зависимости от инструментов и проектов | Всем пользователям нужно быть в курсе |