Superpowers
Superpowers — это набор команд и навыков (skills) для кодинг-агентов (Claude Code, Codex, OpenCode), который превращает обычного агента в дисциплинированного инженера, следующего TDD, YAGNI и DRY. Система автоматически управляет рабочим процессом: от брейншторма до ревью и слияния веток.
Как это работает
Когда вы запускаете агента, он не бросается сразу писать код, а сначала выясняет, что именно вы хотите сделать. Агент формирует спецификацию, показывает её частями, чтобы вы могли прочитать и осмыслить. После утверждения дизайна он составляет план реализации — простой и понятный, как для младшего разработчика. Затем, по команде «go», запускается процесс разработки через суб-агентов: каждый суб-агент выполняет инженерную задачу, проверяет и ревьюит результат. Система может работать автономно несколько часов без отклонения от плана.
Установка
Установка различается в зависимости от платформы. Claude Code имеет встроенную систему плагинов; Codex и OpenCode требуют ручной настройки.
Claude Code (через Marketplace плагинов)
Зарегистрируйте marketplace:
/plugin marketplace add obra/superpowers-marketplace
Затем установите плагин:
/plugin install superpowers@superpowers-marketplace
Проверка установки
Выполните /help — в списке команд должны появиться:
/superpowers:brainstorm — интерактивная доработка дизайна
/superpowers:write-plan — создание плана реализации
/superpowers:execute-plan — пакетное выполнение плана
Codex
Скажите Codex: «Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.codex/INSTALL.md»
Подробнее: docs/README.codex.md
OpenCode
Скажите OpenCode: «Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md»
Подробнее: docs/README.opencode.md
Основной рабочий процесс
- Brainstorming — Активируется перед написанием кода. Уточняет идеи, задаёт вопросы, предлагает альтернативы, показывает дизайн частями для утверждения. Сохраняет документ дизайна.
- Git Worktrees — После утверждения дизайна создаёт изолированное рабочее пространство на новой ветке, настраивает проект и проверяет чистый тестовый baseline.
- Writing Plans — Дробит работу на маленькие задачи (2–5 минут каждая). Каждая задача содержит точные пути к файлам, полный код и шаги верификации.
- Subagent-driven Development / Executing Plans — Запускает свежего суб-агента для каждой задачи: либо в той же сессии (быстрая итерация), либо пакетно (параллельные сессии с контрольными точками).
- Test-Driven Development — В процессе реализации: написать падающий тест, увидеть, что он падает, написать минимальный код, увидеть, что тест проходит, закоммитить. Код, написанный до тестов, удаляется.
- Code Review — Между задачами проверяет реализацию на соответствие плану, сообщает о проблемах по критичности. Критические ошибки блокируют прогресс.
- Finishing a Branch — Когда все задачи выполнены: проверяет тесты, предлагает варианты (merge/PR/keep/discard), убирает worktree.
Агент проверяет наличие актуальных навыков перед каждой задачей. Эти рабочие процессы обязательны, а не рекомендации.
Что внутри (библиотека навыков)
Тестирование
- test-driven-development — цикл RED-GREEN-REFACTOR
- condition-based-waiting — паттерны асинхронных тестов
- testing-anti-patterns — частые ошибки и как их избежать
Отладка
- systematic-debugging — 4-фазовый процесс поиска корня проблемы
- root-cause-tracing — нахождение настоящей причины
- verification-before-completion — убедиться, что исправление работает
- defense-in-depth — множественные проверки
Коллаборация
- brainstorming — сократическая доработка дизайна
- writing-plans — детальные планы реализации
- executing-plans — пакетное выполнение с контрольными точками
- dispatching-parallel-agents — параллельные работы суб-агентов
- requesting-code-review — чеклист перед ревью
- receiving-code-review — реакция на замечания
- using-git-worktrees — параллельные ветки для разработки
- finishing-a-development-branch — решение о merge/PR
- subagent-driven-development — быстрая итерация с контролем качества
Мета
- writing-skills — создание новых навыков по лучшим практикам
- testing-skills-with-subagents — проверка качества навыка
- using-superpowers — введение в систему навыков
Философия
- Test-Driven Development — сначала тесты
- Системный подход вместо импровизации — процесс вместо гадания
- Снижение сложности — простота как главная цель
- Доказательства вместо утверждений — верифицировать до объявления успеха
Подробнее о подходе: Superpowers for Claude Code
Обновление
Навыки обновляются автоматически при обновлении плагина:
/plugin update superpowers
Спонсорство
Если Superpowers помог вам заработать деньги, автор (Jesse) будет благодарен за спонсирование: github.com/sponsors/obra
Вклад в развитие
Навыки живут прямо в этом репозитории. Чтобы внести изменения:
- Fork репозитория
- Создайте ветку для своего навыка
- Следуйте навыку
writing-skills при создании
- Используйте
testing-skills-with-subagents для проверки качества
- Отправьте PR
Полное руководство: skills/writing-skills/SKILL.md
Лицензия
MIT License — подробнее в файле LICENSE.
Поддержка
Комментарии
Комментариев пока нет. Будьте первым.