Superpowers Quickstart: Instalacja, przepływ pracy i testowanie

Superpowers pakuje kompletną, spec-driven metodologię w instalowalne Claude Skills, wymuszając burzę mózgów, planowanie, implementację opartą na subagentach oraz rygorystyczne TDD, zamiast pozostawiać tę strukturę do Twojej dyspozycji.

Większość konfiguracji SDD w Claude Code kończy się w ten sam sposób: ktoś raz tworzy solidną umiejętność specify-plan-implement, pilnie jej używa przez tydzień, a następnie, gdy tylko zbliża się termin, cicho wraca do nieustrukturyzowanego promptowania. Nic w ręcznie tworzonej umiejętności nie jest w stanie tego powstrzymać. Superpowers jest bezpośrednią odpowiedzią na ten problem z dyscypliną – to pakiet umiejętności 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 modelu 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 sprawia, że warto poświęcić mu odrębny artykuł, a nie tylko notkę, to kwestia 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 towarzyszy Ci przez różne środowiska (harnessy), zamiast istnieć w folderze .claude/skills/ jednego repozytorium. Ten przewodnik omawia, czym dokładnie jest Superpowers, jak go zainstalować i zweryfikować na używanym przez Ciebie agencie, jak wygląda pierwsze pełne przebiegi od zera do końca oraz jak się ma 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 zestawie komponowalnych umiejętności oraz kilku początkowych instrukcjach, które zapewniają, że Twój agent z nich korzysta”. To ostatnie zdanie jest kluczowe. Istnieje wiele kolekcji umiejętności; tu wyróżnikiem jest instrukcja bootstrapowa, która zmusza agenta do sprawdzenia istnienia odpowiednich umiejętności przed rozpoczęciem jakiegokolwiek zadania, dzięki czemu workflow aktywuje się automatycznie, zamiast wymagać od Ciebie zapamiętywania komendy ze slashem.

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

• Test-Driven Development – najpierw pisz testy, zawsze
• Systematyczność zamiast improwizacji – 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ą sobie zadania. Jeśli czytałeś Claude Skills and SKILL.md for Developers, mechanika wyda Ci się znajoma – Superpowers to duży, zdeterminowany zestaw dokładnie tego typu katalogów SKILL.md, dystrybuowany jako instalowalny plugin, a nie jako coś, co tworzysz samodzielnie.

Instalacja Superpowers w różnych agentach kodujących

Instalacja zależy od konkretnego środowiska (harnessa), a projekt wprost wskazuje, że należy go instalować osobno dla każdego agenta, którego używasz – nie ma jednej globalnej instalacji.

Claude Code

Superpowers jest dystrybuowany przez dwa rynki (marketplaces) dla Claude Code:

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

Albo przez dedykowany rynek 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 rynku pluginów w Cursor.

Inni agenci

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

• Antigravity automatycznie uruchamia hook session-start pluginu, więc Superpowers jest aktywny od pierwszej wiadomości; aby zaktualizować, zainstaluj ponownie tą samą komendą.
• Pi ładuje umiejętności przez małą rozszerzenie, które wstrzykuje bootstrap using-superpowers przy uruchomieniu sesji i po kompaktacji kontekstu, oraz nie wymaga narzędzia Skill kompatybilności Pi, ponieważ Pi ma natywną obsługę umiejętności.
• Hermes Agent nie ma hooka po kompaktacji – bardzo długa sesja, która ulegnie kompaktacji po swojej pierwszej turze, może stracić bootstrap, więc rozpocznij nową sesję, jeśli umiejętności przestaną się aktywować.
• OpenCode traktuje to jako całkowicie odrębną ścieżkę instalacji od jakiegokolwiek innego środowiska, którego 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 został poprawnie zainstalowany, agent powinien w wynikach wymienić umiejętności takie jak brainstorming, writing-plans, test-driven-development i subagent-driven-development. To ten sam test wykrywania, który zaleca się przy debugowaniu Claude Skills, które nie aktywują się – jeśli umiejętność istnieje, ale nigdy się nie aktywuje, problemem prawie zawsze jest opis routingu, a nie model.

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

Superpowers dokumentuje siedem umiejętności jako „podstawowy workflow”, z których każda aktywuje się w konkretnym punkcie i przekazuje zadanie następnej:

⬇

1. brainstorming aktywuje się przed napisaniem jakiegokolwiek kodu. Udoskonala wstępny pomysł za pomocą pytań, eksploruje alternatywy i prezentuje projekt 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ę po zatwierdzeniu projektu. 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 zadanie – z dokładnymi ścieżkami plików, kompletnym kodem, gdzie to stosowne, oraz jawnymi krokami weryfikacji.
4. subagent-driven-development (szybka iteracja) lub executing-plans (wykonywanie wsadowe z punktami kontrolnymi dla człowieka) wysyła nowego subagenta na każde zadanie, z dwustopniowym przeglądem: najpierw zgodność ze specyfikacją, a następnie jakość kodu.
5. test-driven-development wymusza rygorystyczne red-green-refactor – napisz test, który zawiedzie, obserwuj jego porażkę, napisz minimalny kod, który go przejdzie, obserwuj jego sukces, commituj. Kod napisany przed istnieniem testu, który miałby go zweryfikować, jest usuwany, a nie zachowywany.
6. requesting-code-review aktywuje się między zadaniami, przeglądając różnice (diff) w stosunku do planu i raportując problemy według stopnia krytyczności; 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 PR, zachowanie gałęzi lub porzucenie – i sprząta worktree.

Dokładnie to odpowiada neutralnemu narzędziowo pięciostopniowemu pętli w Spec-Driven Development Workflow From Requirements to Code: specyfikacja staje się burzą mózgów, planowanie staje się writing-plans, zadania i implementacja wchodzą w skład subagent-driven-development, a walidacja jest podzielona między TDD a przegląd kodu. Różnicą jest wymuszanie – Superpowers jest zbudowany tak, aby agent automatycznie sprawdzał te umiejętności, zamiast polegać na Tobie, abyś wywoływał każdy etap.

Wypróbuj: Przejście przez pierwsze zadanie

Nie kieruj Superpowers do swojej najważniejszej funkcji 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ż ma zestaw testów, ponieważ wymuszanie TDD jest tam najbardziej widoczne.

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

Z zainstalowanym Superpowers oczekuj, że sesja otworzy się pytaniami z burzy mózgów, a nie kodem: które endpointy, 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 dotycząca celów negatywnych, o której mówimy w Spec-Driven Development Workflow From Requirements to Code, tylko że wymuszana przez umiejętność, a nie pozostawiona Twojej pamięci. Po zatwierdzeniu projektu w fragmentach, oczekuj planu z numerowanymi, małymi zadaniami przed jakąkolwiek zmianą plików, a następnie jednego subagenta wysłanego na każde zadanie, z różnicą (diff), którą przeglądasz na 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ę test, który zawodzi, przed implementacją. Jeśli kod pojawi się pierwszy, umiejętność nie aktywowała się dla tego kroku i warto ponownie uruchomić test wykrywania z sekcji instalacji.
• Obserwuj granularność zadań. Rozmiar zadań od dwóch do pięciu minut jest agresywny dla niektórych baz kodu. Jeśli zadania wydają się niepotrzebnie fragmentaryczne dla Twojego projektu, warto o tym wspomnieć podczas punktu kontrolnego przeglądu writing-plans, a nie po fakcie.

Co w środku: Biblioteka umiejętności

Oprócz siedmiu umiejętności workflow, Superpowers dostarcza wspierające umiejętności pogrupowane według obszaru:

dispatching-parallel-agents zasługuje na osobne wyróżnienie: obejmuje równoległe workflow subagentów, co jest tym samym terytorium co Claude Code subagents – izolowany kontekst, niezależny przegląd i podsumowanie zgłaszane z powrotem do głównej sesji, zamiast zalewania go pośrednim outputem.

Kiedy Superpowers pasuje (a kiedy nie)

Dobry wybór:

• Już lubisz podejście Claude Skills do Spec-Driven Development vs Vibe Coding, ale ciągle wracasz do nieustrukturyzowanego promptowania, ponieważ nic nie wymusza bram przeglądowych.
• Pracujesz z wieloma agentami kodującymi i chcesz jednej metodologii, która Cię towarzyszy, zamiast umiejętności wyłącznie dla Claude Code.
• Chcesz rygorystycznego wymuszania TDD, nie pisząc logiki wymuszania samodzielnie.
• Funkcje wielosesyjne, w których dryf architektoniczny i zapomniane ograniczenia są realnym ryzykiem – dokładnie ten tryb awarii opisany w Spec-Driven Development vs Vibe Coding.

Słabszy wybór:

• Szybkie skrypty, prototypy jednorazowe i automatyzacje jednorazowe – nakład na burzę mózgów i planowanie jest realny i nie warto go ponosić przy zmianie pięćdziesięciu linii.
• Zespoły z istniejącą, dobrze dostrojoną, projektową umiejętnością SDD. Superpowers zamienia tę personalizację na wymuszane, zdeterminowane ceremonie; możesz woleć zachować to, co już działa, i pożyczać tylko pojedyncze pomysły na umiejętności.
• Środowiska, w których rygorystyczna granularność zadań (2–5 minut) lub obowiązkowe TDD kłóciłoby się 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 GitHub Spec Kit ani AWS Kiro w zwykłym sensie – działa na warstwie umiejętności Claude Code / między-agentów, a nie jako samodzielny CLI lub IDE. Spec Kit daje Ci przenośne artefakty markdown i niezależność agentów; Kiro daje Ci prowadzone, zintegrowane doświadczenie IDE; ręcznie zrobiona umiejętność Claude Code daje Ci maksymalną elastyczność przy zerowym wymuszaniu. Superpowers znajduje się między tymi ostatnimi: ten sam mechanizm oparty na umiejętnościach jak DIY workflow Claude Code, ale z wymuszaniem odczuwalnym jako obowiązkowe i dystrybucją pluginów między agentami, której umiejętność lokalna w repozytorium nie zapewnia.

Pełne zestawienie przenośności, tarcia przy konfiguracji, bram przeglądowych i lock-in dla Spec Kit, Kiro, umiejętności Claude Code, OpenSpec, BMAD-METHOD i Tessl – w tym gdzie Superpowers plasuje się w tabeli porównawczej i ramie decyzyjnej – znajdziesz w GitHub Spec Kit vs Kiro vs Claude Code SDD Workflows.

Rozwiązywanie problemów i rzeczy do wiedzenia

Aktualizacje są w dużej mierze automatyczne, ale zależne od agenta. Jak aktualna pozostaje Twoja instalacja zależy od środowiska – Antigravity ponownie uruchamia hook session-start przy reinstalacji, instalacje oparte na npm lub Git wymagają jawnej komendy aktualizacji, a instalacje oparte na rynku zazwyczaj podążają za własnym przepływem aktualizacji pluginów hostującego agenta.

Telemetria jest domyślnie włączona, ale łatwa do wyłączenia. Opcjonalny wizualny towarzysz umiejętności brainstorming ładuje logo Prime Radiant z ich strony internetowej, co zawiera wersję Twojego Superpowers, ale nie dane projektu, promptu ani kliknięć. Ustaw SUPERPOWERS_DISABLE_TELEMETRY na dowolną wartość prawdziwą, aby ją wyłączyć. Superpowers honoruje 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ć umiejętności, sklonuj repozytorium, przełącz się na dev i postępuj zgodnie z umiejętnością writing-skills dla tworzenia i testowania zmian – nowe kontrybucje umiejętności są ogólnie nieakceptowane, ponieważ każda umiejętność musi działać identycznie we wszystkich wspieranych agentach.

Jeśli umiejętność nie aktywuje się, traktuj to jak każdy inny problem z Claude Skill. Zapytaj „What skills are available?”, aby potwierdzić wykrywanie, sprawdź, czy zainstalowałeś ją dla konkretnego agenta, którego aktualnie używasz (nie innego na tym samym komputerze) i pamiętaj, że sesje Hermes wymagają nowego rozpoczęcia po kompaktacji długiej sesji, jeśli bootstrap cicho zniknie.

Wniosek

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 nowego pomysłu specify-plan-implement – ta pętla jest już dobrze pokryta w What Is Spec-Driven Development? – sprawia, że istniejący pomysł jest trudniejszy do pominięcia i robi to na większej liczbie agentów, niż może sięgnąć umiejętność lokalna w repozytorium. Zainstaluj go najpierw na jednym środowisku, którego używasz codziennie, przeprowadź małe, ograniczone zadanie przez pełny cykl od burzy mózgów do zakończenia i zdecyduj na tej podstawie, czy wymuszane ceremonie są warte swojej ceny przy Twoim rzeczywistym obciążeniu.

Przydatne linki

• Repozytorium Superpowers – źródło, umiejętności i manifesty pluginów dla każdego wspieranego agenta
• Rynek Superpowers – rynek 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órej buduje Superpowers
• Claude Code Subagents: Setup, Config, and When to Use Them – przegląd z izolowanym kontekstem, mechanizm stojący za subagent-driven-development
• Spec-Driven Development Workflow From Requirements to Code – neutralny narzędziowo pięciostopniowy proces, który automatyzuje Superpowers
• What Is Spec-Driven Development? The Spec as Source of Truth – kluczowe koncepcje i terminologia SDD
• Claude Code install and config for Ollama, llama.cpp, pricing – zainstaluj sam Claude Code przed dodaniem Superpowers