Superpowers – szybki start: instalacja, przepływ pracy i wypróbowanie

Superpowers spakowuje pełną metodologię opartą na specyfikacjach w instalowalne umiejętności Claude Skills, egzekwując burzę mózgów, planowanie, implementację sterowaną subagentami oraz rygorystyczne TDD, zamiast pozostawiać tę strukturę do Twojej dyspozycji.

Większość konfiguracji Claude Code SDD (Spec-Driven Development) kończy się na ten sam sposób: ktoś raz pisze solidną umiejętność specify-plan-implement, pilnie jej używa przez tydzień, a potem cicho wraca do nieustrukturyzowanego promptowania przy pierwszej okazji, gdy zbliża się termin. Nic w ręcznie skonstruowanej umiejętności nie jest w stanie tego powstrzymać. Superpowers jest bezpośrednią odpowiedzią na ten problem dyscypliny – to pakiet umiejętności stworzony przez Jesse Vincenta i zespół Prime Radiant, który traktuje burzę mózgów, planowanie, przegląd przez subagenta oraz TDD red-green-refactor jako obowiązkowe kroki, które agent sprawdza przed każdym zadaniem, a nie jako opcjonalne sugestie, z których można zrezygnować pod presją.

To, co czyni go wartym dedykowanego artykułu, a nie tylko wzmianki, to historia instalacji. Superpowers dostarcza manifesty pluginów dla Claude Code, Cursor, Codex, Gemini CLI, GitHub Copilot CLI, Grok Build CLI, Kimi Code, OpenCode, Pi, Devin CLI, Factory Droid oraz Hermes Agent, dzięki czemu ta sama metodologia podąża za Tobą przez różne środowiska wykonawcze (harnessy), zamiast mieszkać w folderze .claude/skills/ jednego repozytorium. Ten przewodnik obejmuje, czym właściwie jest, jak zainstalować i zweryfikować go u agenta, którego używasz, jak wygląda pierwsze przebieganie end-to-end oraz gdzie znajduje się w porównaniu do innych narzędzi do rozwoju opartego na specyfikacjach.

Czym jest Superpowers?

Superpowers opisuje się jako “kompletną metodologię rozwoju oprogramowania dla Twoich agentów kodujących, zbudowaną na podstawie zestawu skomponowalnych umiejętności i kilku początkowych instrukcji, które zapewniają, że Twój agent z nich korzysta”. To ostatnie zdanie jest kluczowe. Istnieje wiele kolekcji umiejętności; wyróżnikiem tutaj jest instrukcja bootstrapowa, która zmusza agenta do sprawdzenia istnienia odpowiednich umiejętności przed rozpoczęciem jakiegokolwiek zadania, dzięki czemu przepływ pracy aktywuje się automatycznie, zamiast wymagać od Ciebie pamiętania o poleceniu slash.

Filozofia stojąca za tym projektem jest jasno wyrażona w jego własnej dokumentacji:

• Test-Driven Development – pisz testy zawsze najpierw
• Systematyczność zamiast doraźności – proces zamiast zgadywania
• Redukcja złożoności – prostota jako główny cel
• Dowody zamiast twierdzeń – weryfikuj przed ogłaszaniem sukcesu

W praktyce ta filozofia przejawia się jako sekwencja umiejętności, które przekazują zadania kolejno. Jeśli czytałeś Claude Skills and SKILL.md for Developers, mechanika będzie Ci przypominać – Superpowers to duży, zdeterminowany zestaw dokładnie tego typu katalogów SKILL.md, dystrybuowany jako instalowalny plugin, a nie coś, co sam autorujesz.

Instalowanie Superpowers w różnych agentach kodujących

Instalacja jest specyficzna dla danego środowiska wykonawczego, a projekt wyraźnie zaznacza, że instalujesz go osobno dla każdego agenta, którego używasz – nie ma jednej globalnej instalacji.

Claude Code

Superpowers jest dystrybuowany przez dwa sklepy z pluginami dla Claude Code:

# Oficjalny sklep z pluginami Anthropic
/plugin install superpowers@claude-plugins-official

Albo przez dedykowany sklep Superpowers, który również oferuje kilka powiązanych pluginów:

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

Cursor

/add-plugin superpowers

Możesz również wyszukać “superpowers” bezpośrednio w interfejsie sklepu z pluginami Cursor.

Inne agenty

Kilka szczegółów dotyczących instalacji warto zaznaczyć przed wykonaniem prawdziwego zadania:

• Antigravity automatycznie wykonuje hook początku sesji pluginu, więc Superpowers jest aktywny od pierwszej wiadomości; zainstaluj ponownie tym samym poleceniem, aby zaktualizować.
• Pi ładuje umiejętności przez małą rozszerzenie, które wstrzykuje bootstrap using-superpowers na starcie sesji i po kompaktowaniu kontekstu, oraz nie wymaga kompatybilności Skill tool, ponieważ Pi ma natywną obsługę umiejętności.
• Hermes Agent nie ma hook po kompaktowaniu – bardzo długa sesja, która kompaktuje się po pierwszej rundzie, może stracić bootstrap, więc rozpocznij nową sesję, jeśli umiejętności przestaną się wyzwaląć.
• OpenCode traktuje to jako całkowicie odrębną ścieżkę instalacji od innych środowisk, których już używasz, nawet na tym samym komputerze.

Weryfikacja instalacji

Po zainstalowaniu zapytaj agenta bezpośrednio, zamiast ufać cichej wiadomości o sukcesie:

What skills are available?

Jeśli Superpowers zainstalował się poprawnie, agent powinien wylistować umiejętności takie jak brainstorming, writing-plans, test-driven-development oraz subagent-driven-development wśród wyników. Jest to ta sama kontrola odkrywania, która zalecana jest dla debugowania Claude Skills, które nie wyzwalają się – jeśli umiejętność istnieje, ale nigdy nie aktywuje się, opis routingu jest prawie zawsze problemem, a nie model.

Przepływ pracy Superpowers: od burzy mózgów do wydanego kodu

Superpowers udokumentował siedem umiejętności jako “podstawowy przepływ pracy”, każda z nich aktywuje się w konkretnym punkcie i przekazuje do następnej:

⬇

1. brainstorming aktywuje się przed napisaniem jakiegokolwiek kodu. Doskonalenie wstępnego pomysłu poprzez pytania, eksplorację alternatyw i prezentację projektu w krótkich, przeglądalnych fragmentach, zamiast w jednym długim dokumencie – a następnie zapisuje wynik jako artefakt projektowy.
2. using-git-worktrees aktywuje się, gdy zatwierdzisz projekt. Tworzy izolowane środowisko pracy na nowej gałęzi, uruchamia konfigurację projektu i weryfikuje czystą bazę testową, zanim zacznie się implementacja.
3. writing-plans dzieli zatwierdzony projekt na małe zadania – Superpowers celuje w dwa do pięciu minut pracy na zadanie – z dokładnymi ścieżkami plików, kompletnym kodem, gdzie to odpowiednie, oraz wyraźnymi krokami weryfikacji.
4. subagent-driven-development (szyte iteracje) lub executing-plans (wykonywanie wsadowe z kontrolnymi punktami ludzkimi) dysponuje świeżym subagentem na każde zadanie, z dwustopniowym przeglądem: zgodność ze specyfikacją najpierw, a następnie jakość kodu.
5. test-driven-development egzekwuje rygorystyczne red-green-refactor – napisz test, który nie przechodzi, obserwuj jego porażkę, napisz minimalny kod, aby przechodził, obserwuj jego sukces, commit. Kod napisany przed istnieniem testu, który nie przechodzi, jest usuwany, a nie zachowywany.
6. requesting-code-review aktywuje się między zadaniami, przeglądając różnicę (diff) wobec planu i raportując problemy według ważności; krytyczne problemy blokują postępy do następnego zadania.
7. finishing-a-development-branch aktywuje się, gdy wszystkie zadania się zakończą. Weryfikuje, czy testy przechodzą, a następnie przedstawia opcje – scalenie, otwarcie PR, zachowanie gałęzi lub porzucenie – oraz sprząta worktree.

To mapuje się ściśle na neutralne narzędziowo pięciofazowe pętlę z Spec-Driven Development Workflow From Requirements to Code: specyfikacja staje się burzą mózgów, planowanie staje się writing-plans, zadania i implementacja zlewają się w subagent-driven-development, a walidacja jest podzielona między TDD a przegląd kodu. Różnica polega na egzekucji – Superpowers jest zbudowany tak, aby agent automatycznie sprawdzał te umiejętności, zamiast polegać na Tobie, abyś wywoływał każdą fazę.

Wypróbuj to: przewodnik po pierwszym zadaniu

Nie kieruj Superpowers do najważniejszej funkcji w pierwszym uruchomieniu. Wybierz coś realnego, ale ograniczonego – mały endpoint, skoncentrowaną poprawkę błędu, refactor jednego modułu – i rozpocznij sesję w projekcie, który już ma suitę testową, ponieważ egzekucja TDD jest tam najbardziej widoczna.

I want to add rate limiting to our public API endpoints.

Po zainstalowaniu Superpowers, oczekuj, że sesja otworzy się pytaniami o burzę mózgów, a nie kodem: które endpoinsy, jaki limit, per-użytkownik czy per-klucz, co powinno się stać, gdy limit zostanie osiągnięty. To tarcie jest zamierzone – to ta sama dyscyplina celów nieosiągniętych (non-goals), omówiona w Spec-Driven Development Workflow From Requirements to Code, tylko egzekwowana przez umiejętność, a nie pozostawiona Twojej pamięci. Po zatwierdzeniu projektu w fragmentach, oczekuj planu z ponumerowanymi, małymi zadaniami przed jakimikolwiek zmianami w plikach, a następnie jednym subagentem dysponowanym na każde zadanie z diffem, który przeglądasz na każdym kontrolnym punkcie.

Dwie rzeczy, na które warto uważać w pierwszym uruchomieniu:

• Potwierdź, że TDD jest naprawdę egzekwowane. Poproś agenta o implementację jednego zadania i sprawdź, czy pojawia się test, który nie przechodzi, przed implementacją. Jeśli kod wyląduje najpierw, umiejętność nie wyzwaliła się dla tego kroku, i warto ponownie wykonać kontrolę odkrywania z sekcji instalacji.
• Obserwuj granularność zadań. Wielkość zadań od dwóch do pięciu minut jest agresywna dla niektórych baz kodu. Jeśli zadania wydają się niepotrzebnie fragmentowane dla Twojego projektu, warto o tym wspomnieć podczas kontrolnego punktu przeglądu writing-plans, a nie po fakcie.

Co jest wewnątrz: Biblioteka Umiejętności

Poza siedmioma umiejętnościami przepływu pracy, Superpowers dostarcza wspierające umiejętności pogrupowane według obszaru:

dispatching-parallel-agents zasługuje na osobne zaznaczenie: obejmuje równoległe przepływy pracy subagentów, co jest tym samym obszarem co Claude Code subagents – izolowany kontekst, niezależny przegląd i podsumowanie zwracane do sesji głównej, zamiast zalewania go wyjściem pośrednim.

Kiedy Superpowers pasuje (a kiedy nie)

Dobry wybór:

• Już podoba Ci się podejście Claude Skills do Spec-Driven Development vs Vibe Coding, ale cały czas wracasz do nieustrukturyzowanego promptowania, ponieważ nic nie egzekwuje bram przeglądów.
• Pracujesz z wieloma agentami kodującymi i chcesz jednej metodologii, która podąża za Tobą, zamiast umiejętności tylko dla Claude Code.
• Chcesz rygorystycznej egzekucji TDD bez pisania logiki egzekucji samodzielnie.
• Funkcje wielosesyjne, w których dryf architektoniczny i zapomniane ograniczenia są realnym ryzykiem – dokładnie ten model awarii opisany w Spec-Driven Development vs Vibe Coding.

Słabszy wybór:

• Szybkie skrypty, rzucające prototypy i jednorazowa automatyzacja – narzut burzy mózgów i planowania jest realny i nie warto go płacić za zmianę pięćdziesięciu linii.
• Zespoły z istniejącą, dobrze dostrojoną, specyficzną dla projektu umiejętnością SDD. Superpowers wymienia tę customizację na egzekwowaną, zdeterminowaną ceremonię; możesz wolić zachować to, co już działa i pożyczać tylko pomysły z poszczególnych umiejętności.
• Środowiska, w których rygorystyczna granularność zadań od dwóch do pięciu minut lub obowiązkowe TDD kłóciłoby się z ugruntowanym procesem zespołu, którego nie jesteś gotów zmienić.

Jak Superpowers różni się od innych narzędzi SDD

Superpowers nie jest konkurencją dla GitHub Spec Kit ani AWS Kiro w zwykłym sensie – operuje na poziomie umiejętności Claude Code / międzyagentowych, a nie jako samodzielny CLI lub IDE. Spec Kit daje Ci przenośne artefakty markdown i niezależność agenta; Kiro daje Ci prowadzone, zintegrowane doświadczenie IDE; ręcznie skonstruowana umiejętność Claude Code daje Ci maksymalną elastyczność z zerową egzekucją. Superpowers znajduje się między ostatnimi dwoma: ten sam mechanizm oparty na umiejętnościach jak DIY przepływ pracy Claude Code, ale z egzekucją odczuwalną jako obowiązkowa i dystrybucją pluginów międzyagentami, której nie zapewnia umiejętność lokalna w repozytorium.

Pełny podział przenośności, tarcia instalacyjnego, bram przeglądów i lock-inu w Spec Kit, Kiro, umiejętnościach Claude Code, OpenSpec, BMAD-METHOD i Tessl – w tym gdzie Superpowers znajduje się w tabeli porównawczej i ramie decyzyjnej – zobacz w GitHub Spec Kit vs Kiro vs Claude Code SDD Workflows. Jeśli chcesz mniej egzekwowanej ceremonii i więcej swobody iterowania na bazie kodu brownfield, OpenSpec quickstart obejmuje lżejszą, centryczną względem zmian alternatywę.

Rozwiązywanie problemów i rzeczy do znania

Aktualizacje są w większości automatyczne, ale zależą od agenta. Jak aktualna pozostaje Twoja instalacja zależy od środowiska wykonawczego – Antigravity ponownie uruchamia hook początku sesji przy reinstalacji, instalacje oparte na npm lub Git wymagają wyraźnego polecenia aktualizacji, a instalacje oparte na sklepach zazwyczaj podążają za własnym przepływem aktualizacji pluginów hosta agenta.

Telemetria jest włączona domyślnie, ale łatwo ją wyłączyć. Opcjonalny wizualny towarzysz umiejętności burzy mózgów ładuje logo Prime Radiant z ich strony internetowej, co zawiera Twoją wersję Superpowers, ale żadnych danych o projekcie, promptach czy kliknięciach. Ustaw SUPERPOWERS_DISABLE_TELEMETRY na jakąkolwiek wartość true, aby wyłączyć. Superpowers honoruje również własne opt-outy Claude Code DISABLE_TELEMETRY i CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC.

Wpisy wymagają gałęzi dev. Jeśli chcesz modyfikować lub dodawać umiejętności, forkuj repozytorium, przełącz się na dev i postępuj zgodnie z umiejętnością writing-skills dla tworzenia i testowania zmian – nowe wpisy z umiejętnościami zazwyczaj nie są akceptowane, ponieważ każda umiejętność musi działać identycznie na wszystkich wspieranych agentach.

Jeśli umiejętność nie wyzwala się, traktuj to jak każdy inny problem z Claude Skill. Zapytaj “What skills are available?”, aby potwierdzić odkrycie, sprawdź, czy zainstalowałeś dla konkretnego agenta, którego obecnie używasz (a nie innego na tym samym komputerze), i pamiętaj, że sesje Hermes potrzebują świeżego startu po kompaktowaniu długiej sesji, jeśli bootstrap cicho zniknie.

Wniosek

Superpowers jest wart instalacji, gdy luką między Twoimi intencjami SDD a tym, co faktycznie dzieje się w sesji, jest problem, który próbujesz rozwiązać. Nie wprowadza nowej idei specify-plan-implement – ta pętla jest już dobrze pokryta przez What Is Spec-Driven Development? – sprawia, że istniejąca idea jest trudniejsza do pominięcia, i robi to na więcej agentów, niż dotrzeć może umiejętność lokalna w repozytorium. Zainstaluj go najpierw na jednym środowisku, którego używasz codziennie, wykonaj małe, ograniczone zadanie przez pełny cykl od burzy mózgów do zakończenia, a potem zdecyduj, czy egzekwowana ceremonia zarobiła na swoim utrzymaniu w Twojej rzeczywistej obciążeniowej.

Przydatne linki

• Superpowers repository – źródło, umiejętności i manifesty pluginów dla każdego wspieranego agenta
• Superpowers marketplace – sklep Claude Code dla Superpowers i powiązanych pluginów
• GitHub Spec Kit vs Kiro vs Claude Code SDD Workflows – pełne porównanie narzędzi i rama decyzyjna
• Claude Skills and SKILL.md for Developers – podstawowa mechanika umiejętności, na których buduje Superpowers
• Claude Code Subagents: Setup, Config, and When to Use Them – przegląd w izolowanym kontekście, mechanizm stojący za subagent-driven-development
• Spec-Driven Development Workflow From Requirements to Code – neutralny narzędziowo proces pięciofazowy, który automatyzuje Superpowers
• What Is Spec-Driven Development? The Spec as Source of Truth – podstawowe koncepcje i terminologia SDD
• Claude Code install and config for Ollama, llama.cpp, pricing – zainstaluj Claude Code samego, zanim dodasz Superpowers