145 lines
8.7 KiB
Markdown
145 lines
8.7 KiB
Markdown
# superpowers
|
||
|
||
- **Autore:** Jesse Vincent (obra)
|
||
- **Repository:** [obra/superpowers](https://github.com/obra/superpowers)
|
||
- **Sorgente:** [skills/using-superpowers/SKILL.md](https://github.com/obra/superpowers/blob/main/skills/using-superpowers/SKILL.md) (la skill che fa partire tutte le altre)
|
||
- **Pagina su skills.sh:** [obra/superpowers/using-superpowers](https://skills.sh/obra/superpowers/using-superpowers)
|
||
- **Diffusione (ottobre 2026):** circa 266.000 installazioni di using-superpowers su skills.sh; il repository ha circa 301.600 stelle su GitHub
|
||
- **Controlli di sicurezza su skills.sh:** Socket e Snyk superati; Gen Agent Trust Hub segnala un avviso (la pagina non spiega il motivo)
|
||
- **Licenza:** MIT
|
||
|
||
## A cosa serve
|
||
|
||
Dà all'agente un metodo di sviluppo software completo, invece di lasciarlo scrivere codice a tentativi. È una raccolta di skill componibili (brainstorming, piani, test, debug, review) più una skill iniziale che obbliga l'agente a usarle. Il flusso di lavoro è obbligatorio, non un suggerimento.
|
||
|
||
## Cosa fa
|
||
|
||
### Quando si attiva
|
||
|
||
Le skill partono da sole. `using-superpowers` va caricata all'inizio di ogni conversazione e impone di controllare le skill prima di qualsiasi risposta o azione, anche prima di una domanda di chiarimento. Poi, per esempio:
|
||
|
||
- chiedi di costruire qualcosa: parte `brainstorming`;
|
||
- segnali un bug: parte `systematic-debugging`;
|
||
- chiedi di implementare una funzione: si lavora con `test-driven-development`.
|
||
|
||
Se l'agente è avviato come subagent per un compito preciso, ignora `using-superpowers`.
|
||
|
||
### Come lavora
|
||
|
||
Il flusso di base, secondo il README:
|
||
|
||
1. **brainstorming:** prima di costruire, chiarisce cosa vuoi e perché, poi ti restituisce ciò che ha capito perché tu lo corregga.
|
||
2. **using-git-worktrees:** dopo l'approvazione del design crea uno spazio di lavoro isolato su un nuovo branch e verifica che i test di partenza passino.
|
||
3. **writing-plans:** divide il lavoro in task da 2-5 minuti, con percorsi dei file, codice completo e passi di verifica.
|
||
4. **subagent-driven-development** o **executing-plans:** esegue il piano, con un subagent per task e una review dopo ciascuno, oppure direttamente con un'unica review finale.
|
||
5. **test-driven-development:** impone il ciclo RED-GREEN-REFACTOR.
|
||
6. **requesting-code-review:** controlla il lavoro rispetto al piano e segnala i problemi per gravità.
|
||
7. **finishing-a-development-branch:** verifica i test, propone le opzioni (merge, PR, tenere, scartare) e pulisce il worktree.
|
||
|
||
Regole di `using-superpowers`:
|
||
|
||
- se una skill è pertinente, l'agente la invoca, annuncia che la usa e la segue alla lettera; se ha una checklist, crea un todo per ogni voce;
|
||
- le skill di processo (brainstorming, systematic-debugging) hanno la precedenza su quelle di implementazione (come frontend-design): prima si decide l'approccio, poi si esegue;
|
||
- una tabella di "red flags" elenca le scuse con cui l'agente tenderebbe a saltare le skill ("è solo una domanda semplice", "conosco già quella skill", "è eccessivo") e le smentisce;
|
||
- le tue istruzioni (CLAUDE.md, AGENTS.md, GEMINI.md, richieste dirette) prevalgono sulle skill, e le skill sulle abitudini predefinite dell'agente. Le skill si saltano solo se lo dici esplicitamente.
|
||
|
||
### Skill incluse
|
||
|
||
| Gruppo | Skill |
|
||
|---|---|
|
||
| Testing | test-driven-development |
|
||
| Debug | systematic-debugging, verification-before-completion, diagnosing-superpowers |
|
||
| Collaborazione | brainstorming, writing-plans, executing-plans, dispatching-parallel-agents, requesting-code-review, receiving-code-review, using-git-worktrees, finishing-a-development-branch, subagent-driven-development |
|
||
| Meta | writing-skills, using-superpowers |
|
||
|
||
L'elenco viene dalla pagina GitHub del repository.
|
||
|
||
### Filosofia
|
||
|
||
- test sempre scritti prima del codice;
|
||
- metodo sistematico invece di tentativi a caso;
|
||
- la semplicità come obiettivo principale;
|
||
- prove invece di affermazioni: verificare prima di dichiarare che qualcosa funziona.
|
||
|
||
### Da sapere
|
||
|
||
- Non è una skill singola ma una metodologia: va installata come plugin (o come insieme di skill) e funziona al meglio negli agenti che lavorano in locale e sanno lanciare subagent e creare worktree git.
|
||
- Il README non indica requisiti tecnici (versioni, dipendenze); chiede solo una delle piattaforme supportate e, per alcune, il riavvio delle sessioni dopo l'installazione.
|
||
- Se usi più piattaforme, va installato separatamente su ciascuna.
|
||
- Su Muse gli hook richiedono un'approvazione alla prima installazione; su Grok Build CLI il comando di installazione usa `--trust`. In generale un plugin può portare hook e script: controlla la fonte prima di installare.
|
||
- L'avviso di Gen Agent Trust Hub su skills.sh non è spiegato: non so a cosa si riferisca.
|
||
|
||
## Installazione
|
||
|
||
### Claude Code e Codex
|
||
|
||
**Claude Code**, dal marketplace ufficiale:
|
||
|
||
```text
|
||
/plugin install superpowers@claude-plugins-official
|
||
```
|
||
|
||
oppure dal marketplace di Superpowers:
|
||
|
||
```text
|
||
/plugin marketplace add obra/superpowers-marketplace
|
||
/plugin install superpowers@superpowers-marketplace
|
||
```
|
||
|
||
| Comando | Significato |
|
||
|---|---|
|
||
| `/plugin install superpowers@claude-plugins-official` | installa il plugin dal marketplace ufficiale di Anthropic |
|
||
| `/plugin marketplace add obra/superpowers-marketplace` | aggiunge il marketplace dell'autore |
|
||
| `/plugin install superpowers@superpowers-marketplace` | installa il plugin da quel marketplace |
|
||
|
||
**Codex App:** apri **Plugins** nella barra laterale, trova Superpowers nella sezione *Coding*, clicca `+` e segui le istruzioni.
|
||
|
||
**Codex CLI:** apri `/plugins`, cerca `superpowers` e scegli `Install Plugin`.
|
||
|
||
Dopo l'installazione riavvia la sessione. Non serve richiamare le skill a mano: `using-superpowers` le attiva da sola quando la richiesta è pertinente.
|
||
|
||
Gestione: il README dice che gli aggiornamenti dipendono dalla piattaforma e spesso sono automatici, ma non dà comandi per Claude Code e Codex. Per elencare, aggiornare o rimuovere il plugin usa il gestore dei plugin dell'agente (`/plugin` in Claude Code, `/plugins` in Codex); i comandi esatti non li ho verificati.
|
||
|
||
**Altre installazioni:** su skills.sh il comando per la sola skill iniziale è:
|
||
|
||
```bash
|
||
npx skills add https://github.com/obra/superpowers --skill using-superpowers
|
||
```
|
||
|
||
Installa però solo `using-superpowers`, non le altre skill: per l'intero insieme usa i plugin qui sopra. Il README elenca anche comandi per altri agenti, per esempio `gemini extensions install https://github.com/obra/superpowers` (Gemini CLI), `/add-plugin superpowers` (Cursor), `copilot plugin marketplace add obra/superpowers-marketplace` seguito da `copilot plugin install superpowers@superpowers-marketplace` (GitHub Copilot CLI), `devin plugins install obra/superpowers` (Devin CLI), `pi install git:github.com/obra/superpowers` (Pi). Nel README trovi anche Antigravity, Factory Droid, Grok Build CLI, Kimi Code, OpenCode, Qwen Code, Hermes Agent e Muse.
|
||
|
||
### App desktop di Claude e ChatGPT
|
||
|
||
Queste app caricano una skill alla volta come ZIP; il plugin completo non si può installare. Per provare almeno la skill iniziale:
|
||
|
||
```bash
|
||
git clone --depth 1 https://github.com/obra/superpowers.git
|
||
cd superpowers/skills && zip -r ~/using-superpowers.zip using-superpowers
|
||
```
|
||
|
||
Lo ZIP deve contenere la cartella `using-superpowers/` con dentro `SKILL.md`. Se vuoi anche le altre, crea uno ZIP per ciascuna (per esempio `brainstorming`) e caricale una per una.
|
||
|
||
**Claude (desktop o web)**
|
||
|
||
1. Attiva l'esecuzione del codice in **Settings → Capabilities**.
|
||
2. Vai in **Customize → Skills → + → Create skill → Upload a skill** e scegli lo ZIP.
|
||
3. Attiva l'interruttore della skill.
|
||
|
||
**ChatGPT (desktop o web)**
|
||
|
||
1. Vai in **Skills** nella barra laterale, poi **Create → Upload from your computer**, e scegli lo ZIP o la cartella.
|
||
2. Attendi l'analisi di sicurezza di ChatGPT.
|
||
3. Richiamala con `@` nella chat.
|
||
|
||
Le skill personali caricate su desktop e web non si sincronizzano: vanno caricate su ciascuna.
|
||
|
||
> **Limite:** Superpowers è pensato per agenti che lavorano su un progetto locale, con worktree git, subagent e test da eseguire. Nelle app di chat queste cose mancano: la skill può al massimo guidare la conversazione (brainstorming, piani), ma non il flusso completo. Non ho verificato come reagiscono le app a una skill che rimanda ad altre skill non caricate.
|
||
|
||
## Fonti
|
||
|
||
- [README di obra/superpowers](https://github.com/obra/superpowers)
|
||
- [SKILL.md di using-superpowers](https://github.com/obra/superpowers/blob/main/skills/using-superpowers/SKILL.md)
|
||
- [using-superpowers su skills.sh](https://skills.sh/obra/superpowers/using-superpowers)
|
||
- [Use skills in Claude – Claude Help Center](https://support.claude.com/en/articles/12512180-use-skills-in-claude)
|
||
- [Skills in ChatGPT – OpenAI Help Center](https://help.openai.com/en/articles/20001066-skills-in-chatgpt)
|