Szybki start z Superpowers: instalacja, przepływ pracy i testowanie

Superpowers to pakiet, który integruje kompletną, specyfikacyjną metodologię programowania w instalowalne Claude Skills, wymuszając burzę mózgów, planowanie, implementację opartą na subagentach oraz rygorystyczne TDD, zamiast pozostawiać tę strukturę Twojej dyscyplinie.

Większość konfiguracji SDD (Spec-Driven Development) w Claude Code kończy się w ten sam sposób: ktoś raz pisze solidny skill specify-plan-implement, korzysta z niego sumiennie przez tydzień, a następnie, gdy tylko zbliża się termin, cicho wraca do nieustrukturyzowanego promptingu. Żaden ręcznie napisany skill nie potrafi tego skutecznie powstrzymać. Superpowers jest bezpośrednią odpowiedzią na ten problem dyscypliny – to pakiet skilli stworzony przez Jesse Vincenta i zespół z Prime Radiant, który traktuje burzę mózgów, planowanie, przegląd przez subagentów oraz TDD w cyklu czerwony-zielony-refaktoryzacja 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ą czasu.

Co sprawia, że zasługuje na oddzielną analizę, a nie tylko na wspomnienie w przypisie, to proces instalacji. Superpowers dostarcza manifty 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 towarzyszy Ci między różnymi środowiskami, zamiast istnieć wyłącznie w folderze .claude/skills/ jednego repozytorium. Ten przewodnik omawia, czym dokładnie jest to narzędzie, jak je zainstalować i zweryfikować u używanego agenta, jak wygląda pierwsza pełna sesja od zera do końca oraz gdzie mieści się ono na tle innych narzędzi do specyfikacyjnego rozwoju oprogramowania.

Czym jest Superpowers?

Superpowers opisuje się jako „kompletna metodologia rozwoju oprogramowania dla Twoich agentów kodujących, zbudowana na podstawie zestawu składanych skilli oraz kilku początkowych instrukcji, które zapewniają, że Twój agent ich używa". To ostatnie zdanie ma kluczowe znaczenie. Istnieje wiele kolekcji skilli; tu wyróżnikiem jest instrukcja startowa, która zmusza agenta do sprawdzenia istnienia odpowiednich skilli przed rozpoczęciem jakiegokolwiek zadania, dzięki czemu workflow aktywuje się automatycznie, zamiast wymagać od Ciebie pamiętania komend slash.

Filozofia stojąca za tym projektem jest jasno sformułowana w jego własnej dokumentacji:

• Test-Driven Development – pisz testy pierwsze, zawsze
• Systematyczność ponad improwizację – proces zgadywania
• Redukcja złożoności – prostota jako główny cel
• Dowody ponad twierdzenia – weryfikuj przed ogłoszeniem sukcesu

W praktyce ta filozofia przejawia się jako sekwencja skilli, które przekazują kontrolę kolejne. Jeśli przeczytałeś Claude Skills i SKILL.md dla deweloperów, mechanika będzie Ci się kojarzyć – Superpowers to duży, silnie zdanie zestaw dokładnie tego typu katalogów SKILL.md, dystrybuowany jako instalowalny plugin, a nie coś, co musisz tworzyć samodzielnie.

Instalowanie Superpowers w agentach kodujących

Instalacja zależy od konkretnego środowiska (harnessa), a projekt wprost wskazuje, że należy instalować go osobno dla każdego używanego agenta – nie istnieje jedna globalna instalacja.

Claude Code

Superpowers jest dystrybuowane przez dwa place dla Claude Code:

# Oficjalny place pluginów Anthropic
/plugin install superpowers@claude-plugins-official

Albo przez dedykowany place Superpowers, który oferuje również 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 place pluginów w Cursor.

Inne agenty

Kilka szczegółów instalacyjnych warto zaznaczyć przed wykonaniem rzeczywistego zadania:

• Antigravity automatycznie uruchamia hook startowy sesji pluginu, więc Superpowers jest aktywne od pierwszej wiadomości; aby zaktualizować, należy ponownie zainstalować używając tego samego polecenia.
• Pi ładuje skilli przez małą rozszerzenie, które wstrzykuje bootstrapping using-superpowers przy starcie sesji oraz po kompresji kontekstu, i nie wymaga narzędzia zgodności Skill w Pi, ponieważ Pi ma natywne wsparcie dla skilli.
• Hermes Agent nie posiada hooka po kompresji – bardzo długa sesja, która dojdzie do kompresji po swojej pierwszej turze, może stracić bootstrap, więc należy rozpocząć nową sesję, jeśli skilli przestaną się uruchamiać.
• OpenCode traktuje to jako całkowicie odrębną ścieżkę instalacji niż jakiekolwiek inne środowisko, którego już używasz, nawet na tym samym komputerze.

Weryfikacja instalacji

Po zainstalowaniu zapytaj agenta wprost, zamiast polegać na cichej wiadomości o sukcesie:

Jakie skilli są dostępne?

Jeśli Superpowers zostało zainstalowane poprawnie, agent powinien w wyliczeniu zawierać skilli takie jak brainstorming, writing-plans, test-driven-development oraz subagent-driven-development. Jest to ta sama kontrola odkrywalności, którą zaleca się przy debugowaniu Claude Skills, które nie uruchamiają się – jeśli skill istnieje, ale nigdy się nie aktywuje, problemem jest prawie zawsze opis routingu, a nie model.

Workflow Superpowers: Od burzy mózgów do dostarczonego kodu

Superpowers dokumentuje siedem skilli jako „podstawowy workflow", z których każdy aktywuje się w określonym momencie i przekazuje kontrolę następnemu:

⬇

1. brainstorming aktywuje się przed napisaniem jakiegokolwiek kodu. Udoskonala surowy pomysł za pomocą pytań, eksploruje alternatywy i prezentuje projekt w krótkich, przejrzywalnych fragmentach, a nie 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 robocze na nowej gałęzi, uruchamia konfigurację projektu i weryfikuje czystą bazę testową przed rozpoczęciem implementacji.
3. writing-plans dzieli zatwierdzony projekt na drobne zadania – Superpowers celuje w dwa do pięciu minut pracy na jedno zadanie – z dokładnymi ścieżkami do plików, kompletnym kodem tam, gdzie to istotne, oraz wyraźnymi krokami weryfikacji.
4. subagent-driven-development (szyteki iteracje) lub executing-plans (wykonywanie wsadowe z punktami kontrolnymi dla człowieka) wysyła nowego subagenta do każdego zadania, z dwustopniowym przeglądem: zgodność ze specyfikacją na pierwszym miejscu, a następnie jakość kodu.
5. test-driven-development wymusza rygorystyczny cykl czerwony-zielony-refaktoryzacja – napisz test, który nie przechodzi, obserwuj jego porażkę, napisz minimalny kod, który go przechodzi, obserwuj sukces, commituj. Kod napisany przed istnieniem dla niego nieprzechodzącego testu jest usuwany, a nie zachowywany.
6. requesting-code-review aktywuje się między zadaniami, przeglądając różnicę (diff) względem planu i raportując problemy według ich wagi; problemy krytyczne blokują przejście do następnego zadania.
7. finishing-a-development-branch aktywuje się, gdy wszystkie zadania zostaną ukończone. Weryfikuje, czy testy przechodzą, a następnie prezentuje opcje – scalenie (merge), otwarcie Pull Requesta, zachowanie gałęzi lub jej usunięcie – oraz sprząta worktree.

Mapowanie to jest bardzo bliskie uniwersalnemu pięciofazowemu pętli w Workflow Spec-Driven Development od wymagań do kodu: specyfikowanie staje się burzą mózgów, planowanie staje się writing-plans, zadania i implementacja łączą się w subagent-driven-development, a weryfikacja jest podzielona między TDD a przegląd kodu. Różnicą jest egzekwowanie – Superpowers zostało tak zbudowane, aby agent automatycznie sprawdzał te skilli, zamiast polegać na Tobie, który wywoływałby każdy etap.

Wypróbowanie: Przechodzenie przez pierwsze zadanie

Nie kieruj Superpowers na swoją najważniejszą funkcję przy pierwszym uruchomieniu. Wybierz coś rzeczywistego, ale ograniczonego – mały endpoint, skupioną poprawkę błędu, refaktoryzację pojedynczego modułu – i rozpocznij sesję w projekcie, który już posiada pakiet testów, ponieważ wymuszanie TDD jest tam najbardziej widoczne.

Chcę dodać rate limiting do naszych publicznych endpointów API.

Z zainstalowanym Superpowers, oczekuj, że sesja zacznie się od pytań z burzy mózgów, a nie od kodu: które endpointy, jaki limit, per usera czy per klucza, co powinno się stać, gdy limit zostanie osiągnięty. To tarcie jest zamierzone – to ta sama dyscyplina wyznaczania celów negatywnych, o której mowa w Workflow Spec-Driven Development od wymagań do kodu, tylko że egzekwowana przez skill, a nie pozostawiona Twojej pamięci. Po zatwierdzeniu projektu fragmentami, oczekuj planu z ponumerowanymi, małymi zadaniami przed jakąkolwiek zmianą w plikach, a następnie jednym subagentem wysłanym do każdego zadania z diffem do przejrzenia przy każdym punkcie kontrolnym.

Dwie rzeczy, na które warto zwrócić uwagę przy pierwszym uruchomieniu:

• Potwierdź, że TDD jest faktycznie egzekwowane. Poproś agenta o implementację jednego zadania i sprawdź, czy pojawia się nieprzechodzący test przed implementacją. Jeśli kod pojawi się pierwszy, skill nie uruchomił się dla tego kroku i warto ponownie wykonać kontrolę odkrywalności z sekcji instalacji.
• Obserwuj granularność zadań. Wymiarowanie zadań na dwa do pięciu minut jest agresywne dla niektórych baz kodu. Jeśli zadania wydają się niepotrzebnie fragmentaryczne dla Twojego projektu, warto to zgłosić podczas punktu kontrolnego przeglądania planu (writing-plans), a nie po fakcie.

Co w środku: Biblioteka Skilli

Poza siedmioma skillami workflow, Superpowers dostarcza wspierające skilli zgrupowane według obszarów:

dispatching-parallel-agents zasługuje na osobne podkreślenie: obejmuje współbieżne workflow subagentów, co leży w tej samej dziedzinie co Subagenty Claude Code – izolowany kontekst, niezależny przegląd oraz podsumowanie zgłaszane do sesji głównej, zamiast zalewania jej pośrednimi wyjściami.

Kiedy Superpowers pasuje (a kiedy nie)

Dobre zastosowanie:

• Jeśli już lubisz podejście Claude Skills do Spec-Driven Development vs Vibe Coding, ale wciąż uciekasz w stronę nieustrukturyzowanego promptingu, ponieważ nic nie wymusza punktów kontrolnych przeglądu.
• Jeśli pracujesz z wieloma agentami kodującymi i chcesz jednej metody, która towarzyszy Ci wszędzie, zamiast skilla tylko dla Claude Code.
• Jeśli chcesz rygorystycznego egzekwowania TDD bez pisania logiki wymuszającej samodzielnie.
• Funkcje rozłożone na wiele sesji, gdzie dryf architektoniczny i zapomniane ograniczenia są realnym ryzykiem – dokładnie ten tryb awarii opisany w Spec-Driven Development vs Vibe Coding.

Słabsze zastosowanie:

• Szybkie skrypty, prototypy jednorazowego użytku i automatyzacje jednorazowe – overhead burzy mózgów i planowania jest realny, a nie warto go ponosić przy zmianie pięćdziesięciu linii kodu.
• Zespoły posiadające istniejący, dobrze dostrojony, specyficzny dla projektu skill SDD. Superpowers wymienia tę personalizację na wymuszoną, zdaną ceremonię; możesz wolisz trzymać się tego, co już działa, i pożyczć jedynie pomysły na pojedyncze skilli.
• Środowiska, w których rygorystyczna granularność zadań (2-5 min) lub obowiązkowe TDD kolidowałyby z ustalonym procesem zespołowym, którego nie jesteś gotów zmienić.

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

Superpowers nie jest konkurentem dla GitHub Spec Kit ani AWS Kiro w zwykłym sensie – działa na warstwie skilli Claude Code / między-agentowej, a nie jako samodzielne CLI lub IDE. Spec Kit oferuje przenośne artefakty markdown i niezależność agenta; Kiro oferuje prowadzone, zintegrowane doświadczenie w IDE; ręcznie napisany skill Claude Code daje maksymalną elastyczność przy zerowym wymuszaniu. Superpowers plasuje się gdzieś między tymi ostatnimi: ten sam mechanizm oparty na skillach co DIY workflow Claude Code, ale z wymuszaniem, które daje poczucie obowiązkowości, oraz dystrybucją pluginów między agentami, której nie zapewnia repozytorium-local skill.

Pełny przebieg przenośności, tarć przy konfiguracji, punktów kontrolnych przeglądu oraz lock-in dla Spec Kit, Kiro, Claude Code skills, OpenSpec, BMAD-METHOD oraz Tessl – w tym gdzie Superpowers plasuje się w tabeli porównawczej i frameworku decyzyjnym – znajdziesz w GitHub Spec Kit vs Kiro vs Claude Code SDD Workflows. Jeśli wolisz mniejszą ceremonię wymuszoną i większą swobodę iteracji na istniejącej bazie kodu (brownfield), Szybki start OpenSpec obejmuje lżejsze, centrujące się na zmianach alternatywę. A jeśli brakują Ci role, których Superpowers nie obsługuje – przegląd produktowy, QA przeglądarki, audyt bezpieczeństwa, inżynieria wydań – gstack pakietuje je jako wirtualny zespół inżynieryjny, który można łączyć z Superpowers, z Superpowers dostarczającym dyscypliny w fazie implementacji.

Wymiana i rzeczy, o których warto wiedzieć

Aktualizacje są w większości automatyczne, ale zależne od agenta. Jak aktualna pozostaje Twoja instalacja zależy od środowiska – Antigravity ponownie uruchamia hook startowy sesji przy reinstalacji, instalacje oparte na npm lub Git wymagają jawnego polecenia aktualizacji, a instalacje oparte na place zwykle podążają za własnym przepływem aktualizacji pluginów gospodarza.

Telemetria jest domyślnie włączona, ale łatwa do wyłączenia. Opcjonalny wizualny towarzysz skilla brainstorming ładuje logo Prime Radiant z ich strony internetowej, co zawiera wersję Twoich Superpowers, ale nie zawiera danych o projekcie, promptach ani kliknięciach. Ustaw SUPERPOWERS_DISABLE_TELEMETRY na dowolną wartość prawdziwą, aby to wyłączyć. Superpowers szanuje również własne opt-outy Claude Code: DISABLE_TELEMETRY i CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC.

Kontrybucje wymagają gałęzi dev. Jeśli chcesz modyfikować lub dodawać skilli, zwiduj repozytorium, przełącz się na dev i postępuj zgodnie ze skilliem writing-skills przy tworzeniu i testowaniu zmian – nowe kontrybucje skilli są zazwyczaj akceptowane, ponieważ każdy skill musi działać identycznie we wszystkich obsługiwanych agentach.

Jeśli skill się nie uruchomi, traktuj to jak każdy inny problem z Claude Skill. Zapytaj “Jakie skilli są dostępne?”, aby potwierdzić odkrywalność, sprawdź, czy zainstalowałeś go dla konkretnego agenta, którego obecnie używasz (a nie innego na tym samym komputerze), i pamiętaj, że sesje Hermes wymagają świeżego startu po kompresji długiej sesji, jeśli bootstrap cicho zniknie.

Podsumowanie

Superpowers warto zainstalować, 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 – pętla ta jest już dobrze pokryta przez Czym jest Spec-Driven Development? – sprawia, że pomysł istniejący jest trudniejszy do pominięcia i robi to w większej liczbie agentów niż repozytorium-local skill jest w stanie sięgnąć. Zainstaluj go najpierw w tym jednym środowisku, którego używasz codziennie, przeprowadź małe, ograniczone zadanie przez pełny cykl od burzy mózgów do końca i dopiero wtedy zdecyduj, czy wymuszana ceremonia jest warta swojej ceny na Twoim rzeczywistym obciążeniu pracy.

Przydatne linki

• Repozytorium Superpowers – źródło, skilli i manifty pluginów dla wszystkich obsługiwanych agentów
• Place Superpowers – Place 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 framework decyzyjny
• Claude Skills i SKILL.md dla deweloperów – podstawowa mechanika skilli, na których buduje Superpowers
• Subagenty Claude Code: Konfiguracja, Ustawienia i kiedy ich używać – przegląd w izolowanym kontekście, mechanizm stojący za subagent-driven-development
• Workflow Spec-Driven Development od wymagań do kodu – uniwersalny pięciofazowy proces, który Superpowers automatyzuje
• Czym jest Spec-Driven Development? Specyfikacja jako źródło prawdy – podstawowe pojęcia i terminologia SDD
• Instalacja i konfiguracja Claude Code dla Ollama, llama.cpp, ceny – zainstaluj samo Claude Code przed dodaniem Superpowers