Дополнительные источники: https://github.com/obra/superpowers#community, https://github.com/obra/superpowers#commercial-services
Зачем это нужно
Финальный урок модуля и закрытие большой темы курса: глубокие разборы трех SDD-подходов — OpenSpec (модуль 15), обзор Spec Kit (2.8) и этот модуль. Карта инструментов SDD-рынка — урок 2.6; здесь — не обзор рынка, а сопоставление трех разобранных подходов по осям, которые важны при выборе: механизм дисциплины, артефакты, порог входа, цена процесса.
Четвертый участник сравнения — подход Мэтта Покока (глава книги «Agentic Design Patterns», на которую ссылается этот урок): разрозненные скиллы без общего каркаса. Он нужен, чтобы показать главное отличие Superpowers: не набор скиллов, а единый порядок с обязательными контрольными точками.
Основная идея
Все три инструмента решают одну задачу — не дать агенту начать с кода и не дать объявить готовность без доказательств — но разными носителями процесса: Superpowers несет процесс в поведении агента (скиллы + HARD-GATE), OpenSpec — в файлах репозитория (proposal → delta → archive), Spec Kit — в командном ритуале (constitution + слэш-команды /speckit.*). Отсюда разные сильные стороны: Superpowers максимально автоматичен и кросс-инструментален, OpenSpec максимален в аудируемости истории изменений, Spec Kit — в командной стандартизации.
Сопоставление: большая таблица
| Ось | Superpowers (модули 17.1–17.16) | OpenSpec (модуль 15) | Spec Kit (урок 2.8) |
|---|---|---|---|
| Носитель процесса | поведенческие скиллы, инжектируемые в агента (17.4) | файлы изменений: proposal, delta specs, tasks, archive (15.3) | constitution + фазы specify → clarify → plan → tasks → analyze → implement |
| Механизм дисциплины | HARD-GATE между этапами; скиллы срабатывают по триггерам до любого ответа (17.4, 17.6) | архивные требования: каждое изменение начинается с proposal и заканчивается архивацией дельт (15.2) | конституция проекта + ритуал команд /speckit.* (2.8) |
| Дизайн до кода | обязателен; масштабируется маршрутом: spike → bounded → architectural (17.6) | обязателен: /opsx:propose до применения (15.2) |
обязателен: /speckit.specify + clarify (2.8) |
| Артефакты | спека + план (architectural), журнал scratch (удаляется); «git history is the record» (17.16) | proposal/delta/tasks/archive — все в git, история изменений — первый класс (15.3) | constitution, spec, plan, tasks, analysis (2.8) |
| TDD | железный закон: нет кода без упавшего теста (17.10) | не встроен как закон; рекомендуется практикой | checklist/analysis поддерживают, закон — нет |
| Ревью | двухступенчатое на каждой задаче + финальное ветки (17.9, 17.11) | ревью proposal до apply (15.10) | ревью спек/планов людьми + analyze (2.8) |
| Каркасы (harness) | ~16 каркасов плагинами; один и тот же контент (17.2) | интеграции через генерацию команд под агента (15.1) | 38 интеграций (2.8) |
| CLI | нет собственного CLI; скиллы + слэш-команды агента | есть: openspec CLI + /opsx:* в чате (15.4) |
есть: specify CLI + /speckit.* (2.8) |
| Порог входа | установка плагина; дальше — все автоматически | установка CLI + договориться о proposal-ритуале | specify init, обучение команды фазам |
| Цена | средняя: полный цикл только для architectural; bounded дешевле (17.6) | средняя: proposal+archive на каждое изменение | выше: полный ритуал фаз |
| Сильная сторона | автоматичность, enforced TDD/ревью, кросс-каркасность | аудируемая история изменений, дельты | командная стандартизация, зрелый процесс |
Чем отличается (по главе книги)
Глава «Agentic Design Patterns» выделяет четыре отличия Superpowers — сверим каждое с разобранным:
- согласование до реализации: инструкции требуют согласования до любого кода; для небольшой правки достаточно краткого дизайна в чате — 17.6, HARD-GATE;
- автоматический выбор процедуры: хук бутстрапа помогает агенту выбирать нужную процедуру сам, без ручного запуска — 17.4;
- отдельный контекст исполнителя и рецензента: реализация и оценка разделены — свежие сабагенты на задачи и ревью — 17.9;
- шаги red-green-refactor в плане: TDD встроен в структуру плана и каждой задачи — 17.8, 17.10.
Против OpenSpec и Spec Kit различие одно и то же по сути: у них дисциплина — в артефактах и ритуале, у Superpowers — в поведении. Поэтому Superpowers не требует от человека помнить фазы: бутстрап держит порядок сам.
Скиллы Мэтта Покока против Superpowers
Глава книги сравнивает и со скиллами Мэтта Покока (набор разрозненных скиллов для coding-агентов). Разница: отдельные скиллы дают отдельные улучшения (лучше писать планы, лучше делать ревью), но не дают порядка: агент может вызвать скилл, а может пропустить. Superpowers — «единый порядок с обязательными контрольными точками»: правило using-superpowers (проверка скиллов до любого ответа — 17.4) плюс HARD-GATE между этапами (17.6) делают пропуск этапа невозможным.
Практическое следствие из главы книги: если команде удобнее хранить результаты обсуждений в трекере, а не в файлах репозитория, набор отдельных скиллов (подход Покока) может подойти лучше: меньше церемонии, нет обязательных артефактов. Если нужен гарантированный порядок — Superpowers.
Когда выбирать Superpowers
Подходит (сводка модуля и главы книги):
- нужна дисциплина для агента, а не надежда на его «аккуратность»: enforced TDD, ревью, верификация;
- агент часто спешит в реализацию, объявляет готовность без проверки;
- работа идет в разных каркасах у разных людей: одни и те же скиллы везде (17.2);
- длинные задачи, где агент может потерять контекст: журнал и сабагенты переживают компакцию (17.9);
- нужна автономность на часы при сохранении контроля: rulings и финальное ревью держат рамку (17.9).
Избыточен:
- быстрые правки и throwaway-прототипы — маршруты spike/bounded снимают большую часть церемонии, но полный цикл architectural здесь не нужен (17.6);
- нужен трекер как источник правды по изменениям, а не файлы и не поведение агента — сравните OpenSpec (архив дельт) или свой процесс;
- команде нужна стандартизация всего процесса разработки одним ритуалом — сравните Spec Kit (2.8);
- в проекте нет культуры тестов: enforced TDD на сломанном бейзлайне бессмыслен — сначала стабилизировать бейзлайн (17.7).
Сценарии выбора
Сведите выбор к трем вопросам (практика курса):
- Носитель: дисциплина в поведении агента (Superpowers), в файлах репозитория (OpenSpec), в командном ритуале (Spec Kit)?
- Цена ошибки: дорогая → полный цикл (architectural/Superpowers, archive/OpenSpec); дешевая → bounded/spike;
- Команда: один человек в одном каркасе → автоматичность Superpowers максимальна; распределенная команда с трекером → файловые артефакты OpenSpec; организация со стандартом → Spec Kit.
Сообщество и поддержка
- Discord: https://discord.gg/35wsABTejz; issues: https://github.com/obra/superpowers/issues; анонсы релизов: https://primeradiant.com/superpowers/.
- Коммерческая поддержка (enterprise, дополнительный тулинг, managed spending): sales@primeradiant.com.
- Контрибуция: 94% PR отклоняются; новые скиллы обычно не принимаются; правки — с эвал-доказательствами (17.15).
Завершение модуля: карта пройденного
| Блок | Уроки | Что вы теперь знаете |
|---|---|---|
| A. Основы | 17.1–17.3 | что такое Superpowers, философия, HARD-GATE, установка на ~16 каркасов, первая сессия |
| B. Устройство | 17.4–17.5 | формат SKILL.md, бутстрап, хуки, отображение инструментов, карта 15 скиллов |
| C. Процесс | 17.6–17.12 | семь шагов: маршруты, worktree, план, исполнение сабагентами, TDD, ревью, завершение ветки |
| D. Качество | 17.13–17.14 | четыре фазы отладки, три техники, верификация до заявлений, диагностика сессий |
| E. Расширение | 17.15–17.17 | TDD-методология написания скиллов, артефакты и полный цикл, выбор инструмента |
Связи с остальным курсом: скиллы — модуль 6; планирование — модуль 4; TDD — модуль 9; git-безопасность и worktrees — модуль 10; мультиагентность и независимый ревьюер — модуль 11; hooks — модуль 12; сравнение инструментов SDD — уроки 2.6, 2.8, 2.10; глубокие разборы — модуль 15 (OpenSpec) и этот модуль. Для capstone-потока (модуль 14) практический вывод: Superpowers — готовый каркас enforced-дисциплины для production-работы с агентами, если ваша команда работает в поддерживаемых каркасах и готова к TDD.
Практика
Выберите инструмент для трех сценариев и обоснуйте по таблице и критериям:
- Прототип выходного дня: один разработчик, одна идея, код выбрасывается через неделю.
- Правка бага в легаси-системе: прод, ревью обязательны, тестов мало, бейзлайн хрупкий.
- Новая подсистема в команде из восьми человек: три каркаса у разных участников, ревью обязательны, история изменений — в файлах репозитория.
Для каждого: какой маршрут/инструмент, какие артефакты останутся, какие ворота пройдете.
Краткое резюме
Superpowers, OpenSpec и Spec Kit закрывают одну потребность — дисциплину до кода и доказательства до заявлений — разными носителями: поведением агента, файлами репозитория, командным ритуалом. Superpowers отличается от набора скиллов (Покок) обязательностью порядка: HARD-GATE и правило «скиллы до любого ответа» делают пропуск этапа невозможным.
- Superpowers — выбирать для автоматичности, кросс-каркасности, enforced TDD/ревью, длинной автономии.
- Не брать для быстрых правок вне маршрутов, команд со стандартом-ритуалом (Spec Kit) или трекером как источником правды (OpenSpec).
- Выбор сводится к трем вопросам: носитель процесса, цена ошибки, команда.
Вопросы для самопроверки
- Назовите носитель процесса у каждого из трех подходов. Что из этого следует для их сильных сторон?
- Чем enforced TDD Superpowers отличается от отношения к тестам в OpenSpec и Spec Kit?
- Чем Superpowers отличается от набора скиллов Мэтта Покока? Какой механизм гарантирует порядок?
- Приведите два сценария, где Superpowers избыточен, и назовите лучшую альтернативу для каждого.
- Какой из трех подходов переживет смену каркаса с наименьшими потерями и почему?
- Составьте сами третий критерий выбора, не совпадающий с тремя из урока (носитель, цена ошибки, команда), и примените его к трем сценариям практики.
Что дальше
Модуль 17 завершен. Дальше по курсу — возвращение к capstone-материалу (модуль 14) и самостоятельная практика: выбрать инструмент под свой контекст по критериям этого урока и провести хотя бы один полный цикл — от маршрута запроса до merge — по урокам 17.6–17.12.
Источники
- https://mokevnin.github.io/agentic-coding-design-patterns/ru/superpowers.html (разделы «Чем отличается», «Когда выбирать»)