Урок 17.2. Установка на разные каркасы: Claude Code, OpenCode, Codex и другие

Дополнительные источники: https://github.com/obra/superpowers/blob/main/docs/README.opencode.md, https://github.com/obra/superpowers/blob/main/.opencode/INSTALL.md, https://github.com/obra/superpowers/blob/main/docs/README.kimi.md

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

Superpowers — не отдельное приложение, а набор плагинов поверх coding-агентов. Отсюда первое правило установки из README: «Installation differs by harness. If you use more than one, install Superpowers separately for each one» — установка отличается по каркасам, и если вы пользуетесь несколькими, ставить нужно в каждый отдельно. Общей команды «поставь везде» нет, и это не недоработка, а следствие устройства: бутстрап скиллов грузится через механизм конкретного каркаса (хук SessionStart плагина), и у каждого каркаса он свой — механика разобрана в уроке 17.4.

В уроке 17.1 мы описали установку как «одну команду»; здесь она разобрана полностью: три каркаса детально (Claude Code, OpenCode, Codex — как самые показательные и разные), остальные — таблицей, потому что паттерн повторяется: зарегистрировать маркетплейс или указать репозиторий → установить плагин → перезапустить сессию.

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

Все ~16 способов установки сводятся к трем паттернам: официальный маркетплейс (Claude Code, Codex, Grok), маркетплейс/репозиторий автора (obra/superpowers напрямую) и «установка по инструкции через самого агента» (OpenCode). Что именно ставится — везде одно и то же: каталог skills/ с 15 скиллами, хук старта сессии и манифест под данный каркас.

flowchart TD A["Установка Superpowers"] --> B{"Паттерн каркаса"} B -->|маркетплейс| C["plugin install из<br/>официального маркетплейса"] B -->|репозиторий автора| D["plugin install / extensions install<br/>с указанием obra/superpowers"] B -->|инструкция через агента| E["агент читает INSTALL.md<br/>и следует ему"] C --> F["Перезапуск сессии →<br/>хук SessionStart активен"] D --> F E --> F

Claude Code

Рекомендуемый путь — официальный маркетплейс Anthropic:

/plugin install superpowers@claude-plugins-official

Альтернатива — маркетплейс автора (в нем Superpowers и связанные плагины):

/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace

После установки в новой сессии должны быть видны слэш-команды семейства /superpowers:* (проверка — в уроке 17.3).

OpenCode

OpenCode не имеет плагин-маркетплейса, и Superpowers ставится через самого агента: вы просите его загрузить и выполнить официальную инструкцию установки. В README рекомендована такая фраза:

Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md

Механика: агент скачивает INSTALL.md из каталога .opencode/ репозитория и выполняет его шаги — файлы плагина размещаются так, чтобы OpenCode загрузил их при следующем старте. Это демонстрирует общий принцип Superpowers: инструкция для агента — это тоже интерфейс.

Детальное руководство по OpenCode: docs/README.opencode.md в репозитории.

Codex

Codex CLI — через официальный маркетплейс плагинов OpenAI:

/plugins

открывает поиск по плагинам; дальше ищете superpowers и выбираете Install Plugin.

Codex App — через UI: в сайдбаре откройте Plugins, найдите Superpowers в разделе Coding и нажмите +.

Остальные каркасы: сводная таблица

README перечисляет команды для всех поддерживаемых каркасов (перевод описаний, команды — как в оригинале):

Каркас	Установка	Примечания
Antigravity	`agy plugin install https://github.com/obra/superpowers`	хук старта сессии работает с первого сообщения; переустановка той же командой = обновление
Cursor	`/add-plugin superpowers` в чате Cursor Agent, или поиск в маркетплейсе плагинов	—
Devin CLI	`devin plugins install obra/superpowers`	обновление: `devin plugins update superpowers`
Factory Droid	`droid plugin marketplace add https://github.com/obra/superpowers` → `droid plugin install superpowers@superpowers`	сначала маркетплейс, потом плагин
Gemini CLI	`gemini extensions install https://github.com/obra/superpowers`	обновление: `gemini extensions update superpowers`
GitHub Copilot CLI	`copilot plugin marketplace add obra/superpowers-marketplace` → `copilot plugin install superpowers@superpowers-marketplace`	через маркетплейс автора
Grok Build CLI	`grok plugin install superpowers@xai-official --trust`	официальный маркетплейс xAI; или `/marketplace` в TUI
Kimi Code	`/plugins` → Marketplace → Superpowers; или `/plugins install https://github.com/obra/superpowers`	детали: `docs/README.kimi.md`
Pi	`pi install git:github.com/obra/superpowers`	нативные скиллы Pi; для локальной разработки: `pi -e /path/to/superpowers`
Qwen Code	`qwen extensions install obra/superpowers`	ставит из маркетплейсов Claude Code; обновление: `qwen extensions update superpowers`
Hermes Agent	`hermes plugins install obra/superpowers --enable`	нет post-compaction hook: длинная сессия, скомпактировавшаяся в первом ходу, теряет бутстрап — если скиллы перестали срабатывать, начните свежую сессию (см. урок 17.14)
Muse	`muse plugins install ./superpowers` (из клона) + `muse plugins approve superpowers`	бутстрап через нативный `SessionStart`; после установки перезапустите сессии и одобрите хуки

Общие наблюдения по таблице:

Перезапуск сессий обязателен почти везде: хук SessionStart срабатывает при старте, активные сессии, запущенные до установки, бутстрап не получат.
Одобрение хуков: часть каркасов (Muse) требует явного approve после установки — это нормально, Superpowers ничем не отличается от других плагинов с хуками.
Потеря бутстрапа после компакции — известная и задокументированная слабость каркасов без post-compaction hook; в Claude Code и основных каркасах повторная инъекция происходит автоматически.

Обновление

Формулировка README: обновления «somewhat coding-agent dependent, but are often automatic» — зависят от каркаса, но часто происходят автоматически (каркасы с маркетплейсами подтягивают версии сами). Универсальные fallback-паттерны:

маркетплейс-каркасы: команда установки повторно ставит/обновляет версию;
каркасы с update-командой: devin plugins update superpowers, gemini extensions update superpowers, qwen extensions update superpowers, muse plugins update superpowers;
Antigravity: переустановка той же командой agy plugin install ....

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

Минимальный smoke-тест, работающий в любом каркасе (из README, раздел Muse, и AGENTS.md проекта):

Откройте чистую сессию (не продолжение старой).
Отправьте ровно этот запрос: Let's make a react todo list.
Рабочая установка автоматически вызывает скилл brainstorming до того, как написан хоть какой-то код: агент сначала задает вопросы, а не генерирует файлы.

Именно этот тест проект использует как приемочный для новых интеграций (AGENTS.md): «A working integration auto-triggers the brainstorming skill before any code is written». Если агент сразу начал писать код — бутстрап не загрузился; диагностика — в уроке 17.14.

Дополнительная проверка в Claude Code: /help показывает команды /superpowers:brainstorm и соседние (разбор — урок 17.3).

Сравнение сложности установки

Туториал OpenCodeDocs (сторонний; проверен по репозиторию на дату среза) оценивает так: Claude Code — проще всего (нативный маркетплейс), OpenCode — средне (установка через агента), Codex — сложнее (нужен опыт с CLI). Оценка практичная: чем меньше у каркаса плагин-инфраструктуры, тем больше шагов вручную. Но содержимое после установки одинаково: одни и те же 15 скиллов.

Практика

Выберите каркас, которым пользуетесь ежедневно, и установите Superpowers по таблице выше.
Запустите чистую сессию и выполните приемочный тест Let's make a react todo list.
Зафиксируйте результат: вызвал ли агент brainstorming до генерации кода? Если нет — проверьте, что сессия новая (не продолжение), и повторите.

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

Superpowers ставится в каждый harness-каркас отдельно: три основных паттерна — официальный маркетплейс, репозиторий автора, инструкция через агента (OpenCode). После установки почти везде нужен перезапуск сессии: бутстрап грузится хуком старта сессии.

Claude Code: /plugin install superpowers@claude-plugins-official; OpenCode: инструкция INSTALL.md через агента; Codex: /plugins или UI Apps.
Остальные ~13 каркасов — таблицей; паттерн один: маркетплейс/репозиторий → плагин → перезапуск.
Приемочный тест любой установки: чистая сессия + Let's make a react todo list → brainstorming срабатывает до кода.
Обновления часто автоматические; fallback — повторная установка или update-команда каркаса.
Слабое место каркасов без post-compaction hook (Hermes) — потеря бутстрапа в длинных сессиях.

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

Почему нельзя поставить Superpowers «один раз и везде»? Что именно различается между каркасами?
Чем установка в OpenCode принципиально отличается от Claude Code? Почему это тоже интерфейс «для агента»?
Что проверяет приемочный тест Let's make a react todo list и почему тестовый запрос должен быть именно в чистой сессии?
Какой класс каркасов теряет бутстрап после компакции и что рекомендуется делать?
Какие три паттерна установки вы бы выделили, если бы готовили шпаргалку для команды из 20 человек с разными каркасами?

Что дальше

Установка есть, скиллы должны срабатывать — следующий урок, 17.3, проведет первую сессию за пять минут: от проверки команд до первого диалога brainstorming и сохраненного дизайн-документа.

Источники

https://github.com/obra/superpowers#installation