Skill Writing Plans
Converti un progetto approvato in compiti revisionabili con interfacce e verifiche.
Community · Jesse Vincent / Prime Radiant| Autore | Jesse Vincent / Prime Radiant |
|---|---|
| Licenza | MIT |
| Fonte | obra/superpowers · SKILL.md su GitHub |
| Sito del progetto | primeradiant.com/superpowers |
| Funziona in | Claude Code · Codex, Gemini CLI, Cursor, Copilot |
| Letta dalla fonte il |
writing-plans trasforma una specifica approvata in piano per un ingegnere senza contesto precedente. Registra percorsi esatti, interfacce, vincoli e comandi di verifica.
Il piano è un documento di passaggio, non un’implementazione finita. Raggruppa modifiche coerenti con input e output espliciti per coordinare costruttori diversi.
Dallo SKILL.md della skill: writing-plans
Cosa fa
- Leggi la specifica approvata ed esamina il codice rilevante.
- Definisci vincoli globali, interfacce e compiti revisionabili.
- Rivedi il piano e concorda il modo di esecuzione.
Cosa ottieni
- Piano in docs/superpowers/plans/YYYY-MM-DD-<feature>.md con passi e verifiche.
Quando usarla
- Passare modifiche in più fasi a chi non ha letto la conversazione.
Quando non usarla
- Requisiti ancora aperti: usa prima brainstorming.
Cosa richiede
- Specifica approvata, agente con file e accesso al progetto.
- Esecuzione, test e commit richiedono strumenti e permessi del progetto.
File della skill
| File o cartella | A cosa serve |
|---|---|
SKILL.md | Struttura, granularità e requisiti di passaggio. |
Licenza trovata nel repository il 2026-11-19: MIT.
Prompt di esempio
Scrivine uno dopo l'installazione; nominare la skill fa sì che venga usata.
- Trasforma questo progetto approvato in piano con interfacce e comandi di verifica.
- Controlla modifiche coerenti invece di un compito per file.
- Pianifica questa migrazione per un nuovo ingegnere con vincoli globali.
Come installare writing-plans
Installazione e permessi
Il plugin completo conserva link a brainstorming ed esecuzione. La cartella di pianificazione contiene solo SKILL.md.
La fonte include passi test-first e commit. Adatta l’esecuzione alle regole del repository; scrivere il piano non li esegue.
Una skill è una cartella con un file SKILL.md. La installi una volta sola; l'agente legge la sua breve descrizione all'inizio di ogni sessione e carica le istruzioni complete solo quando una richiesta corrisponde. Scegli dove la usi:
Claude Code: dal marketplace dei plugin
- Avvia Claude Code in un terminale con
claude. - Questo plugin si trova nel marketplace ufficiale di Anthropic, che Claude Code aggiunge da solo al primo avvio.
- Installa il plugin. Claude Code ne mostra prima i dettagli: controlla cosa aggiungerà (skill, hook, server MCP), poi scegli se è per te, per tutti su questo repository o solo per te in questo repository.
/plugin install superpowers@claude-plugins-official - Digita / e cerca
/superpowers:writing-plans, oppure chiedi semplicemente di svolgere il compito.
Dalla shell invece che da una sessione:
claude plugin install superpowers@claude-plugins-officialClaude Code: copia la cartella nella tua cartella delle skill
Metti la cartella della skill in ~/.claude/skills/ per usarla in tutti i progetti su questo computer, oppure in .claude/skills/ dentro un repository per condividerla con chiunque ci lavori (fanne il commit).
git clone --depth 1 https://github.com/obra/superpowers.git
mkdir -p ~/.claude/skills
cp -R superpowers/skills/writing-plans ~/.claude/skills/Claude Code rileva le skill nuove o modificate in queste cartelle durante la sessione. Se la cartella delle skill non esisteva quando è iniziata la sessione, esegui una volta /reload-skills. Poi digita /writing-plans o descrivi semplicemente il compito.
Su Windows, esegui i comandi in Git Bash o WSL, oppure copia la cartella nello stesso percorso con Esplora file.
Codex, Gemini CLI, Cursor e GitHub Copilot
Questi agenti leggono le stesse cartelle SKILL.md. L'unica cartella di progetto accettata da tutti e quattro è .agents/skills/, quindi questo comando ci copia la skill:
git clone --depth 1 https://github.com/obra/superpowers.git
mkdir -p .agents/skills
cp -R superpowers/skills/writing-plans .agents/skills/| Agente | Cartella del progetto | La tua cartella utente | Note |
|---|---|---|---|
| OpenAI Codex | .agents/skills/ | ~/.agents/skills/ | Digita $ o esegui /skills per scegliere una skill; Codex ne sceglie una anche da solo quando il tuo compito corrisponde. |
| Gemini CLI | .agents/skills/.gemini/skills/ | ~/.agents/skills/~/.gemini/skills/ | Oppure installa da Git con gemini skills install <git URL> --path <folder> --consent. Il 18 giugno 2026 Google ha sostituito Gemini CLI con Antigravity CLI per gli utenti del piano gratuito e di Google One; Antigravity usa .agents/skills/ in un progetto e ~/.gemini/config/skills/ per te. |
| Cursor | .agents/skills/.cursor/skills/ | ~/.agents/skills/~/.cursor/skills/ | Digita / nella chat Agent per scegliere una skill. Cursor legge anche le cartelle .claude/skills/ di Claude Code. |
| GitHub Copilot | .github/skills/.agents/skills/.claude/skills/ | ~/.copilot/skills/~/.agents/skills/ | Funziona in Copilot CLI, nel cloud agent e nella modalità agente di VS Code, Visual Studio e JetBrains (il supporto negli IDE dipende dalla versione). Oppure esegui gh skill install OWNER/REPOSITORY SKILL (anteprima pubblica, GitHub CLI 2.90.0 o successiva). |
Fonti per questi passaggi
Verificati sulla documentazione di ciascun fornitore il 2026-11-14:
Un piano che sopravvive al contesto
Vincoli globali valgono tra compiti; le interfacce dichiarano input e output e riducono assunzioni nascoste nel passaggio.
Rivedi prima di eseguire. Un comando dettagliato resta proposta finché non è eseguito e verificato.
Domande su writing-plans
Esegue il piano?
No. Lo scrive, rivede e passa al metodo concordato.
Che contesto serve a un compito?
Percorsi esatti, interfacce, vincoli, passi e comandi concreti di verifica.
Ogni file è un compito?
No. Servono modifiche coerenti e revisionabili; i confini dei file non bastano.
Serve un servizio a pagamento?
Non specifica servizi aggiuntivi. Agente o API possono comunque avere costi.
Altre skill IA
Skill correlate
Skill Brainstorming
Community · Jesse Vincent / Prime RadiantTrasforma un’idea iniziale in un progetto concordato prima di implementare.Skill Subagent-Driven Development
Community · Jesse Vincent / Prime RadiantEsegui il piano con nuovi implementatori, revisioni mirate e registro dei compiti.planning-with-files skill
Community · OthmanAdiConserva piani e progressi in file con hook secondo l’host.Skill To-Spec
Community · Matt PocockRegistra decisioni concordate come specifica e pubblicala nel tracker configurato.Skill To-Tickets
Community · Matt PocockDividi specifiche in fette verticali dimostrabili con dipendenze esplicite.Self-hosting n8n skill
Community · Romuald CzłonkowskiDistribuisci e mantieni n8n con Docker, HTTPS Caddy, servizi privati e backup verificati.