Урок 17.3. Быстрый старт: первая сессия за 5 минут

Сверено по репозиторию: https://github.com/obra/superpowers (README.md, разделы Installation, The Basic Workflow)

Зачем это нужно

Урок 17.2 закончился приемочным тестом, но одно дело — проверить, что плагин загрузился, и другое — прожить первую сессию целиком: увидеть, как агент отказывается писать код, задает вопросы, предъявляет дизайн порциями и сохраняет документ. Именно этот опыт «агент ведет себя иначе, чем обычно» и есть продукт Superpowers; пока вы его не испытали, установка не подтверждена.

Материал этого урока построен на стороннем туториале OpenCodeDocs (Quick Start, глава «5 Minute Quick Start» и «Master Skill Calls»). Туториал — не первоисточник: его шаги сверены с README репозитория на дату среза (2026-10-03); команды и поведение — из официальной документации, подача — адаптирована. Установка на другие каркасы — урок 17.2; здесь используется Claude Code как каркас с самым простым маркетплейсом.

Основная идея

Быстрый старт — это четыре шага: зарегистрировать маркетплейс → установить плагин → проверить команды → отправить первый запрос через /superpowers:brainstorm. После последнего шага происходит главное: агент не пишет код, а начинает интервью. Весь смысл Superpowers сжимается в одну фразу туториала: «не более умный AI, а более послушный AI» — дисциплина вместо хитрости.

flowchart LR A["/plugin marketplace add obra/superpowers-marketplace"] --> B["/plugin install superpowers@superpowers-marketplace"] B --> C["/help: видны команды"] C --> D["/superpowers:brainstorm + описание задачи"] D --> E["Агент задает вопросы, код не пишется"]

Шаг 1. Зарегистрировать маркетплейс

В Claude Code:

/plugin marketplace add obra/superpowers-marketplace

Зачем: регистрация маркетплейса говорит Claude Code, где искать плагины Superpowers. Ожидаемый ответ:

✅ Successfully added marketplace: obra/superpowers-marketplace

Замечание: в уроке 17.2 показан и более короткий путь — официальный маркетплейс Anthropic (/plugin install superpowers@claude-plugins-official), где шаг регистрации не нужен. Туториал использует маршрут маркетплейса автора; оба ведут к одному плагину.

Шаг 2. Установить плагин

/plugin install superpowers@superpowers-marketplace

Ожидаемый ответ:

📦 Installing superpowers from superpowers-marketplace...
✅ Successfully installed superpowers

Установились скиллы, хук старта сессии и слэш-команды. В большинстве каркасов после этого стоит перезапустить сессию — бутстрап грузится при старте (урок 17.4).

Шаг 3. Проверить команды

/help

Среди команд должны появиться слэш-команды Superpowers. Ключевые три (по туториалу):

Команда	Назначение
`/superpowers:brainstorm`	интерактивное уточнение дизайна
`/superpowers:write-plan`	создать план реализации
`/superpowers:execute-plan`	исполнить план по задачам

Если все три на месте — установка успешна. Полный список скиллов и команд — в справочнике 17.5; слэш-команды — способ ручного вызова, норма же — автоматические триггеры (ниже).

Шаг 4. Первый запрос: `/superpowers:brainstorm`

Отправьте:

/superpowers:brainstorm I want to add a comment feature to the blog

Что происходит дальше — ядро всего Superpowers:

Агент не пишет код. Первый ответ — не файлы и не диффы, а вопросы.
Вопросы по существу замысла: какие функции должны быть у комментариев? нужен ли логин? нужны ли лайки? — по одному вопросу за раз (правило скилла brainstorming — урок 17.6).
Дизайн предъявляется порциями по 200-300 слов — короткими настолько, что их можно прочесть и осмыслить, с вопросом «пока похоже на правду?» после каждой секции.
После вашего подтверждения дизайн сохраняется в документ (архитектурный маршрут — в docs/superpowers/specs/; маршруты и артефакты — уроки 17.6 и 17.16).

Формула быстрого старта: сначала уточнить, потом кодить. Согласование — ворота (HARD-GATE), и до явного «да» от вас реализация не начинается.

Чек-лист «установка прошла»

[ ] /help показывает команды /superpowers:brainstorm и соседние;
[ ] /superpowers:brainstorm запускает интервью: агент спрашивает, а не кодит;
[ ] агент не перескакивает к коду мимо дизайна — даже на «простой» задаче.

Если все три пункта выполнены — быстрый старт пройден. Дальше сессия сама пойдет по базовому workflow: worktree → план → исполнение → TDD → ревью → завершение (уроки 17.6–17.12).

Автоматические триггеры против слэш-команд

Глава «Master Skill Calls» туториала и README сходятся в важном различии:

Слэш-команды (/superpowers:brainstorm и т.п.) — ручной вызов скилла; полезен, когда вы хотите явно направить агента.
Автоматические триггеры — основная механика: бутстрап using-superpowers требует от агента проверять применимость скиллов перед любым ответом, включая уточняющие вопросы. Запрос на новую фичу направляется в brainstorming сам; сообщение о баге — в systematic-debugging.

Практический вывод: после установки слэш-команды нужны редко — скиллы срабатывают по смыслу запроса. Если этого не происходит, два типичных объяснения ниже; систематическая диагностика — урок 17.14.

Типичные проблемы первых минут

Команды не появились в /help. По туториалу:

Проверьте написание: /superpowers:brainstorm — двоеточие, не пробел.
Перезапустите Claude Code (сессия, стартовавшая до установки, бутстрапа не имеет).
Повторите шаги установки.

Агент все равно сразу пишет код. По туториалу и README:

Задача может быть слишком простой: агент мог классифицировать ее как bounded-правку и предложить короткий дизайн в чате — читайте его первый ответ внимательно, возможно, дизайн уже предъявлен и ждет вашего «да» (маршруты — урок 17.6).
Попробуйте более содержательную задачу (например, «отрефакторить систему аутентификации и добавить двухфакторку»).
Обновите плагин: /plugin update superpowers.

Скиллы работали, потом перестали (после долгой сессии): вероятна компакция контекста с потерей бутстрапа в каркасе без post-compaction hook — начните свежую сессию (детали — уроки 17.4 и 17.14).

Практика

Пройдите цикл быстрого старта на задаче из своего проекта:

Установите (или обновите) Superpowers в рабочем каркасе, перезапустите сессию.
Отправьте /superpowers:brainstorm с описанием небольшого, но не тривиального изменения.
Ответьте на 2-3 вопроса агента и отметьте: предъявляется ли дизайн порциями? спрашивает ли агент «пока правильно?» после секций?
Досчитайте до явного согласования — и проследите, что до него не создано ни одного файла с кодом.

Краткое резюме

Быстрый старт укладывается в четыре шага и один опыт: маркетплейс → плагин → проверка /help → первый запрос через /superpowers:brainstorm, после которого агент начинает интервью вместо кодогенерации.

Ключевой опыт: агент задает вопросы по одному, дизайн предъявляется порциями по 200-300 слов, документ сохраняется после согласования.
Слэш-команды — ручной вызов; основная механика — автоматические триггеры через бутстрап using-superpowers.
Чек-лист: команды видны; brainstorming спрашивает, а не кодит; дизайн не перескакивается.
Типичные сбои первых минут: старая сессия без перезапуска, слишком простая задача (bounded-маршрут), устаревший плагин.

Вопросы для самопроверки

Какие четыре шага быстрого старта и что именно проверяет каждый?
Почему агент начинает с вопросов, а не с кода? Какой скилл за это отвечает?
Зачем дизайн предъявляется порциями по 200-300 слов? Что было бы при выдаче целиком?
В чем разница между /superpowers:brainstorm и автоматическим срабатыванием скилла? Какой способ основной?
Агент «все равно пишет код сразу» — какие две причины из урока вы проверите первыми?

Что дальше

Вы увидели поведение снаружи; следующий урок, 17.4, вскрывает его изнутри: формат SKILL.md, хук SessionStart, бутстрап using-superpowers и то, почему один набор markdown-файлов работает в шестнадцати каркасах.