Markdown edition

AI-translated from English; not yet reviewed by a fluent editor.

# Gamitin ang Superpowers sa Claude Code para magplano, sumubok at magsuri ng isang pagbabago sa code

> Isang gabay batay sa dokumentasyon para dalhin ang isang awtorisadong pagbabago sa code sa aprubadong disenyo at plano ng Superpowers, aktuwal na nakitang pulang-berdeng pagsusuri, pagrepaso sa mga gawain at buong branch, at pasya ng may pananagutan.

By BIG CHANGE Editorial

Published: 2026-10-20T10:39:38.153Z
Updated: 2026-10-20T10:39:38.153Z
Canonical: https://bigchange.ai/blog/superpowers-claude-code-plan-test-review-change-guide

![Conceptual charcoal illustration of a long, unlettered code-diff proof sheet emerging from a printer across an inspection table, with a short orange passage.](https://bigchange.ai/api/media/file/superpowers-whole-branch-proof-hero-v1.png)
AI-generated conceptual illustration by BIG CHANGE.

Maaaring gabayan ng Superpowers ang gumagamit ng Claude Code sa malaking pagbabago sa isang Git repository na pinamamahalaan niya: pagkasunduan ang disenyo, aprubahan ang plano ng gawain, ipatupad nang may mga test, suriin ang bawat gawain at inspeksiyunin ang natapos na branch. Sinusunod ng gabay na ito ang mga opisyal na manwal ng Superpowers 7.0.0 na sinuri noong 20 Oktubre 2026. Binasa ng BIG CHANGE ang dokumentasyon; hindi namin in-install ang plugin o pinatakbo ang isang proyekto sa proseso nito.

## Ang malaking pagbabago

- **Ano ang nagbago:** Ang aprubadong disenyo at plano ng implementasyon ay nagbibigay sa mga coding agent ng tiyak na gawain at limitasyon bago nila baguhin ang repository.
- **Bakit mahalaga:** Pinagsasama ng dokumentadong daloy ang nakitang pagkabigo at pagpasa ng mga test sa magkahiwalay na hatol ng iisang tagasuri tungkol sa pagtugma sa espesipikasyon at kalidad, bago ang mas malawak na pagsusuri ng buong branch.
- **Ano ang babantayan:** Tinitingnan pa rin ng may pananagutan ang buong diff at mga bagong resulta ng pagtanggap at siya ang nagpapasya sa branch. Maaaring may natitirang isiniwalat na problema kahit kumpleto ang daloy ng mga agent.

## Bago magsimula

Pumili ng isang awtorisadong pagbabago sa code na may maraming hakbang sa repository na pag-aari mo o maaari mong baguhin. Dapat itong mahati sa mga gawaing kayang suriin at may asal na puwedeng subukan. Isulat ang hinihinging asal, apektadong bahagi, hindi sakop, orihinal na acceptance command at panimulang commit. Patakbuhin ang command at ang mahahalagang umiiral na check bago magsimula. Kung bigo na ang panimulang kalagayan, tukuyin ang kabiguang iyon ngayon; nangangailangan ang susunod na pula o berdeng resulta ng kilalang panimulang batayan.

Kailangan mo ng Git, isang authenticated na Claude Code, pahintulot mag-install ng plugin at gumawa ng branch o worktree, at sapat na plan o API capacity para sa Claude Code at mga subagent. Suriin ang patakaran ng organisasyon tungkol sa pag-access sa source code at paggamit ng plugin. Bago i-activate, basahin ang nilalaman ng plugin, aktuwal na pahintulot, tuntunin ng provider sa datos at kontrol sa paggastos. Nagbababala ang Anthropic na maaaring tumakbo ang mga plugin hook at server process sa iyong user privileges sa labas ng sandbox ng tool call; hindi sakop ng karaniwang paghingi ng pahintulot ng tool ang lahat ng code na iyon. Panatilihin ang mga lihim, dependency, panlabas na pagsusulat, push at release sa awtoridad na talagang mayroon ka. [Ang dokumentasyon ng seguridad ng plugin ng Claude Code](https://code.claude.com/docs/en/plugins/security) ay nagpapaliwanag sa hangganang ito.

Ginagamit ng landas sa ibaba ang kasanayan ng Superpowers na `subagent-driven-development` para sa pagbabagong may maraming gawain. Inilalarawan din ng mga manwal ang direktang landas na `executing-plans` at pinapayagan ang mas payak na kasunduan sa disenyo para sa maliit na trabaho. Piliin ang landas kasama ang may pananagutan bago magpatupad sa halip na ipagpalagay na kailangan ng lahat ng proyekto ang buong pagkakasunod.

## 1. I-install ang plugin at beripikahin ang aktibong bersiyon

Sa isang interactive na Claude Code session, ilagay ang [command ng opisyal na marketplace](https://github.com/obra/superpowers/blob/bb92a77741419a4ab5f06e711a283343f1ada0c3/README.md):

```text
/plugin install superpowers@claude-plugins-official
```

Nagbubukas ang Claude Code ng panel ng detalye ng plugin bago i-install. Suriin ang laman at pumili ng pinahihintulutang scope. Ina-activate ito ng local scope para sa iyo sa repository na ito; naaapektuhan ng project scope ang mga setting ng repository ng mga katuwang. Basahin ang buod ng pag-install at tab na Errors. Sundin ang tagubilin ng session sa pag-activate o mag-restart, suriin ang tab na Installed at patakbuhin sa shell ang `claude plugin list`. Itala ang nakikitang Version, Scope at Status, at kumpirmahing magagamit ang mga kasanayan ng Superpowers sa aktibong session. Hindi ipinipirmi ng marketplace command ang research commit ng gabay na ito. Kung iba ang naka-install na bersiyon o teksto ng kasanayan sa 7.0.0, itugma muna ang proseso sa bersiyong iyon bago magpatuloy. Huminto kapag bigo o disabled ang pag-install; hindi iyon patunay na na-load ang workflow. [Ang gabay sa pag-install ng Claude Code](https://code.claude.com/docs/en/discover-plugins) ay nagdodokumento ng mga check na ito.

## 2. Aprubahan ang disenyo, pagkatapos ang plano

Sabihin sa Claude Code ang totoong pagbabago, acceptance criteria, panimulang resulta at mga ipinagbabawal na pagbabago. Gamitin ang proseso ng Superpowers na `brainstorming` upang linawin ang layunin, mga pasya sa disenyo at mga limitasyon. Para sa pagbabagong ito na maraming hakbang, suriin ang nakasulat na disenyo at mga natuklasan ng builder check, lutasin ang mga tanong para sa may pananagutan at aprubahan ang buong paglalarawan. Dapat tukuyin ng pag-apruba ang asal na itatayo; hindi ito ipinahihiwatig ng patuloy na pagsasalita ng agent. Pinapayagan ng [manwal ng disenyo](https://github.com/obra/superpowers/blob/bb92a77741419a4ab5f06e711a283343f1ada0c3/skills/brainstorming/SKILL.md) ang mas simpleng kasunduan o tahasang pag-opt out para sa maliliit na gawain, kaya sadyang pagpili ito ng buong landas para sa malaking gawain.

Pagkatapos, hilingin sa prosesong `writing-plans` na gawing mga gawain ang disenyo. Suriin ang mga hangganan ng file, interface, pangkalahatang limitasyon, test command at Review Focus ng plano. Dapat sapat ang liit ng bawat gawain para ma-inspeksiyon, at dapat sukatin ng test ang napagkasunduang asal. Aprubahan ang plano at paraan ng pagpapatakbo ng subagent bago baguhin ang code. [Ang manwal ng pagpaplano](https://github.com/obra/superpowers/blob/bb92a77741419a4ab5f06e711a283343f1ada0c3/skills/writing-plans/SKILL.md) ay nagtatakda ng pagpasa ng trabaho. Ang kapani-paniwalang plano ay hindi pahintulot magdagdag ng dependency o baguhin ang mga file na walang kaugnayan.

Sa pagpapatakbo, ang `using-git-worktrees` ay naghahanap ng angkop na umiiral na workspace o naghahanda ng nakahiwalay na lugar nang may kinakailangang pahintulot. Itala ang aktuwal na branch, base commit at malinis na panimulang kalagayan. Gamitin ang katutubong suporta ng Claude Code para sa worktree kung mayroon. Kung may hindi kaugnay na pagbabago sa workspace, linawin muna kung sino ang may pananagutan. [Ang manwal ng worktree](https://github.com/obra/superpowers/blob/bb92a77741419a4ab5f06e711a283343f1ada0c3/skills/using-git-worktrees/SKILL.md) ay naglalarawan sa pag-check at paggawa.

## 3. Obserbahan ang bawat test at pagrepaso sa gawain

Gamit ang aprubadong plano, gamitin ang `subagent-driven-development` para sa mga gawaing masusuri nang magkakahiwalay. Nagtatalaga ang kasalukuyang manwal ng implementer sa isang gawain, pagkatapos ay ipinapasa ang implementasyon at diff nito sa **iisang tagasuri ng gawain**. Nagbabalik ang tagasuring iyon ng dalawang hatol: kung tugma ang gawain sa espesipikasyon at kung katanggap-tanggap ang kalidad ng implementasyon. Dalawang hatol ito mula sa isang pagsusuri, hindi dalawang sunod na reviewer agent. Maaaring pagsamahin ang maliliit na gawaing magkakatulad ayon sa mga tuntunin ng manwal. [Ang workflow ng gawain](https://github.com/obra/superpowers/blob/bb92a77741419a4ab5f06e711a283343f1ada0c3/skills/subagent-driven-development/SKILL.md) at ang [prompt ng tagasuri](https://github.com/obra/superpowers/blob/bb92a77741419a4ab5f06e711a283343f1ada0c3/skills/subagent-driven-development/task-reviewer-prompt.md) ay nagtatakda ng pagkakasunod na ito.

Para sa bawat asal na angkop sa pagsubok muna, hingin ang nakikitang pulang-berdeng siklo: idagdag ang behavioral test, patakbuhin at makita ang inaasahang kabiguan; gawin ang pinakamaliit na implementasyon, ulitin at makitang pumasa; pagkatapos ay i-refactor habang pumapasa pa rin ang mga check. Ang import error o sirang test harness ay hindi ang inaasahang pulang resulta. Itabi ang command, output at kaugnay na commit o diff ng bawat gawain. Inilalarawan ng [manwal ng development na ginagabayan ng test](https://github.com/obra/superpowers/blob/bb92a77741419a4ab5f06e711a283343f1ada0c3/skills/test-driven-development/SKILL.md) ang mga eksepsiyong nangangailangan ng kasunduan ng tao; ipinagpapalagay ng gabay na ito ang gawaing angkop sa karaniwang test-first na landas.

Basahin ang dalawang hatol at aktuwal na diff. Bago tanggapin ang gawain, lutasin ang anumang “hindi mabeberipika mula sa diff” gamit ang plano at repository. Suriin ang mga pagkukumpuni at kanilang nakatuong muling pagrepaso; ang panibagong pahayag ng tagumpay ay hindi bagong resulta ng test. Nililimitahan ng workflow 7.0.0 ang ikot ng pagkukumpuni at maaaring ipagpaliban ang mga natuklasan na may nakasulat na pasya. Itabi ang mga iyon para sa susunod na pagsusuri. Ang gawaing minarkahang kumpleto ay hindi nangangahulugang malinis ang pagrepaso.

Pagkatapos ng mga gawain, inspeksiyunin ang **hiwalay na pagrepaso ng buong branch**. Maaari nitong makita ang ugnayan ng mga gawain at balikan ang mga ipinagpalibang isyung hindi nalutas ng tagasuri mula sa isang diff lamang. Hingin ang ebidensiya at pasya sa bawat bukas na isyu. Itabi ang disenyo, plano, test output, ulat ng pagrepaso at buong diff bago linisin ang pansamantalang workspace ng plugin. Kung hindi na-trigger ang inaasahang kasanayan, suriin ang aktibong status at bersiyon ng plugin at ang dokumentadong paraan ng pag-diagnose; ang pag-install ay hindi patunay na ipinatupad ang daloy.

## 4. Suriin ang branch at piliin ang kahihinatnan nito

Patakbuhin muli ang orihinal na acceptance command sa huling code, kasama ang buong test suite ng proyekto. Inspeksiyunin ang bagong output, buong branch diff at lahat ng natitirang isyu. [Ang manwal ng beripikasyon ng Superpowers](https://github.com/obra/superpowers/blob/bb92a77741419a4ab5f06e711a283343f1ada0c3/skills/verification-before-completion/SKILL.md) ay nangangailangan ng ebidensiya mula sa kasalukuyang kalagayan bago sabihing kumpleto. Kung bigo ang suite, tukuyin ang eksaktong pagkabigo at kumpunihin o iwan ang branch para sa pagrepaso; hindi naaabot ang dokumentadong branch-finish menu kapag bigo ang suite.

Sa isang branch na may pangalan, ang `finishing-a-development-branch` ay nag-aalok ng local merge, push at paggawa ng pull request, o pag-iwan sa branch na hindi binabago. May mga pagpipiliang pull request at keep ang detached HEAD. Ang pagtatapon ay hiwalay na ginagawa pagkatapos lamang ng tahasang hiling ng may pananagutan at pag-type ng kumpirmasyon; hindi ito karaniwang ikaapat na opsiyon. [Ang manwal ng pagtatapos ng branch](https://github.com/obra/superpowers/blob/bb92a77741419a4ab5f06e711a283343f1ada0c3/skills/finishing-a-development-branch/SKILL.md) ay nagpapaliwanag sa mga pagpipiliang ito. Ipakita sa may pananagutan ang mga check, diff at natitirang isyu bago siya magpasya. Kailangan ng naaangkop na awtoridad para sa merge, push, pagtanggal o release.

Ang kapaki-pakinabang na output ay isang branch na puwedeng suriin at nakaugnay sa orihinal na pangangailangan: aprubadong disenyo at plano, nakitang mga resulta ng test, parehong hatol sa gawain, pagsusuri ng buong branch, kumpletong diff at bagong resulta ng pagtanggap. Kung pinahinto ng pag-install, access, badyet o check ang pagtakbo, itabi ang napatunayang mga artifact at sabihin ang huling natapos na yugto. Inilalarawan ng dokumentasyon ang proseso; hindi nito pinatutunayang mas mabilis, mas mura o mas kaunti ang depekto ng pagbabagong hindi pinatakbo sa gabay na ito.

## Mga sanggunian at karagdagang babasahin

- [Superpowers 7.0.0 README at pag-install](https://github.com/obra/superpowers/blob/bb92a77741419a4ab5f06e711a283343f1ada0c3/README.md): opisyal na ruta ng proyekto at paglalarawan ng daloy. Hindi nito bineberipika ang naka-install na bersiyon o resulta ng mambabasa.
- [Manwal ng pagpapatakbo ng gawain ng Superpowers](https://github.com/obra/superpowers/blob/bb92a77741419a4ab5f06e711a283343f1ada0c3/skills/subagent-driven-development/SKILL.md): tagasuri ng gawain, dalawang hatol, mga pasya sa pagkukumpuni at huling pagrepaso ng branch. Basahin ito kasama ng aktuwal na naka-install na bersiyon.
- [Pag-install ng plugin ng Claude Code](https://code.claude.com/docs/en/discover-plugins) at [seguridad](https://code.claude.com/docs/en/plugins/security): scope, pag-activate, pagbasa ng bersiyon at mga pribilehiyo sa pagpapatakbo. Maaaring baguhin ng kontrol ng organisasyon ang magagamit.

Para sa mas makitid na pag-aayos ng isang acceptance check, tingnan ang [gabay ng BIG CHANGE sa pagberipika ng isang bigong repository check](https://bigchange.ai/blog/ai-goal-failing-repository-check-guide). Nagsisimula nang mas maaga ang prosesong ito, sa disenyo at plano ng pagbabagong may maraming gawain.

## Sources

- [Superpowers README sa bersiyong 7.0.0](https://github.com/obra/superpowers/blob/bb92a77741419a4ab5f06e711a283343f1ada0c3/README.md) — Opisyal na marketplace command at pangkalahatang daloy ng proyekto. Isa itong nakapirming sanggunian, hindi patunay na in-install ng marketplace ang eksaktong commit na iyon o na tumakbo ang daloy.
- [Kasanayang brainstorming ng Superpowers](https://github.com/obra/superpowers/blob/bb92a77741419a4ab5f06e711a283343f1ada0c3/skills/brainstorming/SKILL.md) — Inilalarawan ang mga tanong sa disenyo, builder check at pag-apruba ng tao; maaaring gumamit ng mas magaan na landas ang maliliit na gawain.
- [Kasanayang writing-plans ng Superpowers](https://github.com/obra/superpowers/blob/bb92a77741419a4ab5f06e711a283343f1ada0c3/skills/writing-plans/SKILL.md) — Inilalarawan ang estruktura ng plano at pagpasa para sa pagrepaso. Hindi ibig sabihin na aprubado na ang plano para sa proyektong hindi pinatakbo.
- [Kasanayang using-git-worktrees ng Superpowers](https://github.com/obra/superpowers/blob/bb92a77741419a4ab5f06e711a283343f1ada0c3/skills/using-git-worktrees/SKILL.md) — Inilalarawan ang pagpili ng umiiral o nakahiwalay na workspace, pahintulot at panimulang check; walang worktree na ginawa para sa pag-uulat na ito.
- [Kasanayang subagent-driven-development at tagasuri ng gawain ng Superpowers](https://github.com/obra/superpowers/blob/bb92a77741419a4ab5f06e711a283343f1ada0c3/skills/subagent-driven-development/SKILL.md) — Nagtatakda ng isang tagasuri na may hatol sa espesipikasyon at kalidad, limitadong ikot ng pagkukumpuni, ipinagpalibang mga isyu at hiwalay na pagsusuri sa buong branch. Maaaring kasama sa pagkumpleto ang mga hindi nalutas na item na may naitalang pasya.
- [Kasanayang test-driven-development ng Superpowers](https://github.com/obra/superpowers/blob/bb92a77741419a4ab5f06e711a283343f1ada0c3/skills/test-driven-development/SKILL.md) — Inilalarawan ang inaasahang pula-berde-refactor at mga eksepsiyong pinagkasunduan ng tao. Walang test na isinagawa para sa artikulong ito.
- [Kasanayang verification-before-completion ng Superpowers](https://github.com/obra/superpowers/blob/bb92a77741419a4ab5f06e711a283343f1ada0c3/skills/verification-before-completion/SKILL.md) — Nangangailangan ng bagong ebidensiya mula sa aktuwal na command bago sabihing kumpleto; hindi nito pinatutunayan ang resulta ng gabay na ito.
- [Kasanayang finishing-a-development-branch ng Superpowers](https://github.com/obra/superpowers/blob/bb92a77741419a4ab5f06e711a283343f1ada0c3/skills/finishing-a-development-branch/SKILL.md) — Inilalarawan ang mga opsiyon ng may pangalan at detached branch at ang hiwalay na hiling at pag-type ng kumpirmasyon para sa pagtatapon. Kailangan pa rin ang awtoridad ng may pananagutan.
- [Mag-install at mamahala ng mga plugin — Claude Code Docs](https://code.claude.com/docs/en/discover-plugins) — Kasalukuyang install panel, mga scope, pag-activate, tab na Installed at CLI readback ng Version, Scope at Status; maaaring baguhin ng lokal na patakaran ang aktuwal na pagkakaroon.
- [Seguridad ng plugin — Claude Code Docs](https://code.claude.com/docs/en/plugins/security) — Ipinapaliwanag na maaaring tumakbo ang mga plugin hook at server process sa user privileges sa labas ng mga sandbox prompt ng model tool call; dapat suriin ng mga gumagamit ang lokal na access.