Суперспособности

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


Типичные сложности в ИИ-кодинге

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

Затем вы снова и снова вносите изменения, иногда тратя больше времени на исправление курса, чем на первоначальное написание кода.

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


Корневая причина

По умолчанию инструменты для ИИ-кодинга после получения требованийсразу пишут код。

Это нормально для простых задач, но для чуть более сложных требований «прямое написание» пропускает критически важный шаг:полное понимание требований。

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

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


Что такое Superpowers?

Superpowers — это наборпакетов навыков для рабочего процесса разработки, предназначенных для инструментов ИИ-кодинга.。

Он организует ключевые этапы разработки программного обеспечения — уточнение требований, планирование реализации, разработку через тестирование, ревью кода и управление ветками — в файлы навыков. После загрузки в инструменты ИИ-кодинга ИИ автоматически запускает соответствующий рабочий процесс в нужный момент, без необходимости каждый раз давать подсказки вручную.

Одним предложением:внедрите в ИИ методологию разработки, позвольте ему работать в соответствии с процессом, а не начинать писать код сразу после получения требований.。

ПроектИнформация
Репозиторий GitHubhttps://github.com/obra/superpowers
ЛицензияMIT
Поддерживаемые инструментыClaude Code, Cursor, Codex CLI, Codex App, Gemini CLI, GitHub Copilot CLI

Обзор рабочего процесса

Основной процесс Superpowers разделён на четыре фазы. У каждой фазы есть чёткие цели и результаты, и ИИ не пропустит ни одного шага.

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

На что обратить вниманиеОписаниеПрименимые сценарии
Более длительный процессДаже простые требования проходят анализ перед реализациейРазработка функций средней или более высокой сложности
Требует участия в обсужденияхЭтап мозгового штурма требует подтверждения планаРазработчики, готовые потратить время на предварительное согласование
Различия в опытеПроизводительность варьируется в зависимости от инструментов и проектовВсем пользователям нужно быть в курсе
Другие расширения