AI METHODOLOGY · MIT · 14 SKILLS · ZERO CONFIG

14 поведенческих skills, которые превращают AI-агента в дисциплинированного инженера.

Дефолтный Claude Code (или Codex, или Gemini CLI) на запрос «сделай X» сразу пишет код. Без брейнсторма, без плана, без TDD, без верификации. Результат — недоделки, регрессии, бесконечные итерации.

Superpowers — open-source пакет, который автоматически триггерит правильное поведение на каждой фазе работы. Brainstorm → план → красно-зелёная TDD → ревью → ship. Ничего не настраивать — после установки агент сам подхватит skill в нужный момент.

Установить за 30 секунд → GitHub repo
14
Поведенческих skills
$0
Стоимость пакета
0
Конфига для активации
~30сек
Полная установка
TL;DR

Поток работы агента после установки

Skills не конкурируют — они расположены последовательно. На запрос пользователя срабатывает фаза Discovery, потом Execution, потом Quality, потом Ship. Каждый skill — это набор инструкций для конкретной фазы. Агент сам определяет, какой skill сейчас нужен, по контексту запроса.

Запрос пользователя → brainstorming → writing-plans → test-driven-development → executing-plans / subagent-driven-development → verification-before-completion → requesting-code-review → receiving-code-review → finishing-a-development-branch → done

В реальной работе это означает несколько часов автономной работы агента без отклонения от плана. Не идеально (нет совершенных систем), но в разы лучше, чем default-режим без методологии.

Зачем нужна методология

Дефолтный агент — это junior без вкуса.
Superpowers даёт ему дисциплину.

Без методологии Claude (или Codex, или Gemini) на запрос «сделай X» сразу пишет код. Спека формируется в голове, тестов нет, после ревью агент покорно соглашается со всеми правками. Результат — итерации, регрессии, переделки. Superpowers закрывает эту дыру.

// До Superpowers

  • ׫сделай фичу» → агент сразу кодит без вопросов
  • ×Спека держится в голове, не на бумаге
  • ×Тесты — либо нет, либо после кода
  • ×Агент говорит «готово» без проверки
  • ×На ревью соглашается со всем (performative agreement)
  • ×1 задача = 1 длинная последовательная сессия

// После Superpowers

  • ✓Сначала уточняет, что именно ты хочешь
  • ✓Чёткая спека, разбитая на читаемые куски
  • ✓Жёсткая red/green TDD — тест обязан упасть до имплементации
  • ✓verification-before-completion: evidence перед claim'ом
  • ✓Ревью обрабатывается технически, с верификацией каждой правки
  • ✓Параллельные сабагенты на независимые задачи
14 skills, 4 фазы

Каждый skill — отдельная программа поведения.
Все срабатывают автоматически.

Skills хранятся в ~/.claude/plugins/marketplaces/superpowers-dev/skills/ как папки с файлом SKILL.md. Каждый описывает Claude'у: когда триггериться (по фразам пользователя или фазе работы) и что делать. Auto-discovery — после установки рестартить или конфигурировать ничего не нужно.

Discovery (3) Execution (4) Quality (3) Review & Ship (4)
Phase 1 // Discovery — понять, что пользователь действительно хочет
using-superpowers // auto на старте сессии
Бутстрап-слой. Самый первый skill, который срабатывает автоматически в начале сессии. Учит агента, как вообще искать и применять остальные skills — какие триггеры, в каком порядке вызывать, как комбинировать. Без него агент не знает о существовании 13 других skills. Это самовоспроизводящийся механизм: skill учит агента работать с системой skills.
brainstorming // перед creative-работой
Срабатывает перед любой creative work — новой фичей, компонентом, поведением. Вместо того чтобы сразу писать код, агент задаёт вопросы и исследует контекст: «что ты на самом деле хочешь?», «кто будет это использовать?», «какие edge-cases?». Цель — извлечь спеку из разговора, прежде чем тратить токены на имплементацию. Простые правки (типа «измени отступ на 8px») не триггерятся.
writing-plans // спека → план
Когда спека уже есть (после brainstorming или прямо от пользователя), этот skill превращает её в пошаговый имплементационный план. Уровень детализации — такой, чтобы план мог выполнить «энтузиастный junior без вкуса, без контекста проекта и с аверсией к тестам». Это значит: каждый шаг — конкретный, маленький, проверяемый. Подчёркивает red/green TDD, YAGNI (You Aren't Gonna Need It) и DRY.
Phase 2 // Execution — выполнить план шаг за шагом
executing-plans // план → отдельная сессия
Берёт готовый план и выполняет его в отдельной сессии Claude Code с review-чекпоинтами после каждого шага. Хорошо для долгих задач, где не хочется засорять текущий контекст. Полезно когда план был согласован вчера, а исполнить его нужно сегодня в чистой сессии.
subagent-driven-development // план → текущая сессия
Альтернатива executing-plans: тот же план выполняется в текущей сессии через сабагентов. Главный агент раздаёт задачи, инспектирует результат, продолжает. Не нужно открывать вторую сессию. Хорошо для коротких фичей и итераций «здесь и сейчас».
dispatching-parallel-agents // 2+ независимые задачи
Когда у тебя несколько задач, которые не разделяют состояние (нет shared mutable state) — skill запускает их параллельно, каждую в своём sub-agent'е. Например: «1) добавь dark mode, 2) переделай footer, 3) почини SEO-теги, 4) добавь sitemap». Эти 4 задачи независимы — параллельный запуск экономит время в 3-4 раза.
using-git-worktrees // изоляция feature-работы
Когда нужна изоляция от текущего workspace — например, перед запуском executing-plans или dispatching-parallel-agents. Skill создаёт git-worktree в отдельной директории с safety-проверками: не затирает существующий worktree, не теряет uncommitted changes. Каждый параллельный агент работает в своём worktree → не возникает merge-конфликтов.
Phase 3 // Quality — гарантии корректности и evidence-based проверки
test-driven-development // rigid, перед любым кодом
Жёсткая red/green TDD. Триггерится перед написанием implementation-кода для любой фичи или багфикса. Этапы: (1) написать тест — (2) запустить и убедиться, что он упал по правильной причине — (3) только теперь писать минимальный код, чтобы тест прошёл — (4) рефакторить. Если на этапе (2) тест прошёл «случайно» — skill требует переписать тест, потому что без явной красной фазы нет уверенности, что код реально что-то делает. Это rigid-skill: его дисциплину нельзя адаптировать.
systematic-debugging // баг / падающий тест
Когда что-то ломается, дефолтный агент начинает гадать и пробовать наугад. Этот skill заставляет агента сначала собрать факты: где воспроизводится, в каких условиях, что именно говорит тест/трейс/логи, какой последний коммит трогал зону бага. Только потом — гипотеза. Гипотезы проверяются по одной, с минимальным изменением, и каждая отвергается явно или подтверждается.
verification-before-completion // перед claim'ом «готово»
Evidence before assertions. Перед тем как сказать «готово / fixed / passing» или закоммитить / создать PR — агент обязан прогнать команды верификации (build, lint, тесты, smoke-checks) и подтвердить вывод. Не «я думаю это работает», а «вот команда, вот её stdout, вот код возврата 0». Это закрывает класс ошибок «агент уверенно говорит готово, а на проде падает».
Phase 4 // Review & Ship — ревью, мерж, ship
requesting-code-review // после крупной фичи
После завершения задачи или большой фичи (особенно перед merge) — skill готовит чек-лист требований: что должно быть выполнено, какие тесты должны пройти, что должно быть в документации. Передаёт ревьюеру (человеку или другому агенту) с явными критериями приёмки. Не просто «ну посмотри на PR».
receiving-code-review // получил фидбек
Главное правило: никакого performative agreement. Если ревьюер говорит «измени это» — агент не соглашается «окей, исправлю», а сначала проверяет предложение технически. Если правка обоснована — внедряет. Если правка некорректна или ухудшит код — пушит обратно с техническим обоснованием. Цель — рост кода, а не угождение ревьюеру. Это противоположность стандартного LLM-поведения «соглашайся и делай».
finishing-a-development-branch // тесты зелёные → решить как мержить
Когда имплементация готова и тесты прошли — skill предлагает структурированные опции как интегрировать работу: merge напрямую, создать PR, squash, rebase, cleanup веток. Помогает не забыть про мелочи — закрыть worktree, удалить feature-branch, обновить changelog, проверить CI на main после merge.
writing-skills // мета-skill
Skill для создания самих skills. Когда тебе нужен новый skill (например, под твой специфический workflow), этот skill ведёт через процесс: формулировка триггера, написание SKILL.md, проверка что описание не пересекается с другими skills, тестирование на dry-run сценариях. Закрывает feedback-loop: можно расширять Superpowers собственными skills, не выходя за рамки методологии.
Установка

Один из четырёх способов.
Самый простой — официальный marketplace.

Superpowers распространяется как plugin через несколько marketplace'ов. После установки агент сам подхватит skills — настраивать ничего не нужно. Выбери путь под свою платформу.

Рекомендую этот вариант. Самый стабильный путь — пакет проходит review Anthropic. Команда выполняется внутри Claude Code (slash-команда). После установки skills сразу доступны во всех сессиях.

# В Claude Code: claude> /plugin install superpowers@claude-plugins-official # Готово. После установки — открой новую сессию. # Skills с префиксом superpowers: подхватятся автоматически.

Используй этот вариант, если хочешь свежие фичи раньше, чем они попадут в official marketplace. Это marketplace автора (Jesse Vincent / @obra) — туда новые skills попадают первыми.

# 1. Зарегистрировать marketplace: claude> /plugin marketplace add obra/superpowers-marketplace # 2. Установить плагин из него: claude> /plugin install superpowers@superpowers-marketplace # Этот marketplace может содержать дополнительные плагины # связанные со Superpowers — посмотри список командой /plugin list

Для пользователей OpenAI Codex CLI. Найди Superpowers в встроенном поиске плагинов и установи. Skills работают через тот же механизм триггеров.

# В Codex: codex> /plugins # Откроется интерфейс поиска плагинов. # Найди "superpowers" → выбери → подтверди установку.

Для Gemini CLI. В upstream-репо лежит gemini-extension.json — это extension-манифест, который Gemini распознаёт.

# Через Gemini CLI extensions: $ gemini extensions install obra/superpowers-marketplace # Если не работает — см. README в upstream-репо: # https://github.com/obra/superpowers-marketplace
Реальные диалоги

Как это выглядит в работе

Три типичные ситуации: новый landing page с нуля, баг в проде, четыре фичи параллельно. Видны конкретные skills, которые срабатывают, и в каком порядке. Реплики выделены цветом: пользователь, агент, триггер skill'а.

A Новый landing page с нуля

Классический сценарий. Пользователь говорит «сделай landing». Без Superpowers агент сразу пишет HTML. С ним — задаёт вопросы, согласует план, делает TDD, верифицирует.

ВЫ:    Сделай мне landing page для нашего продукта X.

CLAUDE: [триггер: brainstorming]
       Прежде чем писать код — давай разберёмся:
         1. Кто целевая аудитория? B2B / B2C?
         2. Какая главная боль, которую закрывает продукт?
         3. Какие 3 ключевых преимущества?
         4. Что должно произойти после клика на CTA?
            (форма / звонок / переход в Telegram?)
         5. Есть ли existing brand-guidelines?

ВЫ:    [отвечает на вопросы]

CLAUDE: [триггер: writing-plans]
       Окей, план в 5 шагов:
         Шаг 1. Hero: пейн → решение → primary CTA
         Шаг 2. 3 преимущества с метриками (proof)
         Шаг 3. Social proof (тестимониалы / лого клиентов)
         Шаг 4. FAQ (закрывает возражения)
         Шаг 5. Final CTA + footer
       Для каждого шага опишу детальнее ниже.
       Согласен начать с шага 1?

ВЫ:    Да.

CLAUDE: [триггер: TDD + executing-plans]
       Шаг 1: Hero
       (1) Пишу падающий тест: проверяю что primary CTA
           кликабелен и ведёт на правильный URL.
       (2) Запускаю → failed (ожидаемо, компонента нет).
       (3) Имплементирую CTA-компонент.
       (4) Тест зелёный.
       [триггер: verification-before-completion]
       (5) Прогоняю build, lint, все тесты — всё ОК.
           Вывод команд приложил выше.
       Шаг 1 готов. Переходить к шагу 2?

B Баг в проде

Пользователь сообщает о баге без деталей. Дефолтный агент начнёт гадать. Superpowers заставляет сначала собрать факты — это часто экономит часы поиска не там.

ВЫ:    Кнопка submit не работает в Safari.

CLAUDE: [триггер: systematic-debugging]
       Прежде чем гадать — соберу факты:
         1. В каких версиях Safari?
            (Mobile / Desktop / iPad / iPhone?)
         2. Воспроизводится ли локально?
            Если да — какая команда / шаги?
         3. Что в console (DevTools)?
            Есть ли ошибка в Network-tab при клике?
         4. Какой последний коммит трогал submit-форму?
            (git log --oneline -- components/SubmitButton.tsx)
         5. Это новый баг или регрессия?
            Когда работало последний раз?

       Дай мне эту информацию — потом сформулирую гипотезу
       и проверю её. Без фактов гадать бессмысленно.

C Четыре фичи параллельно

У тебя есть 4 независимые задачи. Дефолтный агент будет делать их по очереди — это 1-1.5 часа. Superpowers видит, что они не разделяют state, и запускает в параллель.

ВЫ:    Нужно сделать 4 вещи:
         1) добавить dark mode toggle
         2) переделать footer
         3) починить SEO-теги (meta description пустые)
         4) добавить sitemap.xml

CLAUDE: [триггер: dispatching-parallel-agents]
       Анализирую зависимости между задачами:
         (1) dark mode → CSS-vars, не пересекается
         (2) footer → отдельный компонент
         (3) SEO → metadata.ts, изолировано
         (4) sitemap → app/sitemap.ts, изолировано

       Все 4 задачи независимы (нет shared mutable state).
       [триггер: using-git-worktrees]
       Создаю 4 worktree:
         ../site-darkmode    → branch feat/darkmode
         ../site-footer      → branch feat/footer
         ../site-seo         → branch fix/seo-tags
         ../site-sitemap     → branch feat/sitemap

       Запускаю 4 sub-agent'а параллельно, каждый со своим
       worktree и своей задачей. Через ~15 минут получишь
       4 готовых PR на ревью с тестами и verification.
FAQ

Частые вопросы

Это правда работает в продакшне?

Да. Автор Jesse Vincent (obra) использует это в своих проектах ежедневно. На моих personal-проектах Superpowers + кастомные skills экономят 30-50% времени за счёт меньшего числа итераций и переделок.

Это не magic — это дисциплина, без которой LLM'ы по умолчанию работают как сильно болтливые junior'ы. После установки агент перестаёт быть junior'ом.

Сжигает ли Superpowers больше токенов?

Чуть-чуть. Системный промпт растёт на ~5-10K токенов (за счёт описаний skills, которые автоматически инжектятся). Brainstorming-фаза тоже добавляет токены — диалог с уточнениями.

Но это компенсируется за счёт меньшего числа неудачных попыток и переделок. Net-эффект: на средних/крупных задачах экономия токенов по сравнению с default-режимом, потому что не нужно делать 3-5 циклов «не то → переделай».

Совместимо с моими собственными skills?

Полностью. Superpowers — отдельный плагин. Skills вызываются с префиксом superpowers: (например, superpowers:brainstorming). Не конфликтует с твоими skills в ~/.claude/skills/ — у них свой namespace.

Можно даже использовать writing-skills из Superpowers, чтобы создавать собственные skills в твоём namespace.

Можно отключить отдельные skills?

Да. Каждый skill — отдельный SKILL.md в ~/.claude/plugins/marketplaces/superpowers-dev/skills/<name>/.

Варианты: (1) удалить папку skill'а — он перестанет грузиться. (2) Скопировать SKILL.md локально и отредактировать триггер, чтобы он срабатывал реже. (3) Добавить в settings.json исключение по namespace.

А если я не хочу brainstorming на каждый запрос?

Skill срабатывает только на creative work — новые фичи, компоненты, новая функциональность. Простые правки («поменяй цвет», «исправь опечатку», «добавь log») не триггерятся, потому что в описании skill'а явно указан класс «creative» через триггерные фразы.

Если всё-таки слишком часто — отредактируй brainstorming/SKILL.md, чтобы триггер был уже (например, добавь конкретные слова-маркеры или пороги по сложности).

Это open-source? Можно использовать коммерчески?

Да, MIT License. Можно форкать, модифицировать, использовать в коммерческих проектах. Этот гайд — тоже MIT.

Если экосистема помогает зарабатывать — поддержи автора через GitHub Sponsors. Это не обязательно, но прямо помогает развитию пакета.

Что делать, если skill начинает мешать (слишком жёстко)?

Некоторые skills (особенно test-driven-development и verification-before-completion) намеренно rigid — их дисциплина не должна адаптироваться. Это feature, не bug: TDD без strictness превращается в «потом напишу тест».

Если ты уверен, что в конкретной ситуации rigidity не нужна — явно скажи агенту: «без TDD на этот раз, я просто хочу исправить опечатку». Агент пропустит skill для этого запроса.

Кредиты

Это гайд, а не форк

Сам Superpowers создан Jesse Vincent (obra). Этот сайт — гайд на русском с моими комментариями и диаграммами. Это не форк и не репликация — у них свой репозиторий, у меня свой.

Upstream — оригинал

Open-source пакет создан Jesse Vincent (@obra). MIT License. Continuous development — следи за релизами.

→ github.com/obra/superpowers-marketplace
→ Claude Plugin Marketplace
→ GitHub Sponsors — поддержать автора

Этот гайд

Русский гайд с диаграммами и примерами от Сергея Рамаса. Тоже MIT. Рекомендую посмотреть upstream README для последних обновлений.

→ github.com/sergeyramas/superpowers-guide
→ Хаб с другими решениями
→ Telegram @Sergeyramas — связаться

Дисциплина за 30 секунд установки.
Без подписок и конфигов.

14 skills, которые работают автоматически на каждой фазе. Один /plugin install — и агент перестаёт быть junior'ом.

Установить →