Vai al contenuto

Skill Writing Plans

Converti un progetto approvato in compiti revisionabili con interfacce e verifiche.

Community · Jesse Vincent / Prime Radiant
AutoreJesse Vincent / Prime Radiant
LicenzaMIT
Fonteobra/superpowers · SKILL.md su GitHub
Sito del progettoprimeradiant.com/superpowers
Funziona inClaude 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

Questa è una skill della community di Jesse Vincent / Prime Radiant, non verificata da noi né da Anthropic. Le skill possono dire all'agente di eseguire codice, leggere file o accedere alla rete. Prima di installarla, leggi il suo SKILL.md e ogni script nella cartella, e cerca qualsiasi cosa che non corrisponda a ciò che dichiara di fare.

Cosa fa

  1. Leggi la specifica approvata ed esamina il codice rilevante.
  2. Definisci vincoli globali, interfacce e compiti revisionabili.
  3. 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 cartellaA cosa serve
SKILL.mdStruttura, 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

  1. Avvia Claude Code in un terminale con claude.
  2. Questo plugin si trova nel marketplace ufficiale di Anthropic, che Claude Code aggiunge da solo al primo avvio.
  3. 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
  4. 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-official

Claude 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/
AgenteCartella del progettoLa tua cartella utenteNote
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).
Installa solo skill di cui ti fidi. Anthropic consiglia di usare solo skill di fonti affidabili e di leggere ogni file di qualsiasi altra skill prima di usarla: una skill può indurre l'agente a eseguire comandi, leggere file o inviare dati in modi che la sua descrizione non menziona.

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

Categorie di skill