Vai al contenuto

Skill To-Spec

Registra decisioni concordate come specifica e pubblicala nel tracker configurato.

Community · Matt Pocock
AutoreMatt Pocock
LicenzaMIT
Fontemattpocock/skills · SKILL.md su GitHub
Sito del progettowww.aihero.dev/skills-to-spec
Funziona inClaude Code · Codex, Gemini CLI, Cursor, Copilot
Letta dalla fonte il

to-spec sintetizza conversazioni già decise in specifiche. Usa codice, glossario e decisioni architetturali senza una nuova intervista sui requisiti.

Conferma punti di test, registra storie e ambito e pubblica nel tracker. Supporta Markdown con configurazione locale.

Dallo SKILL.md della skill: ## Out of Scope

Questa è una skill della community di Matt Pocock, 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 conversazione e decisioni pertinenti.
  2. Conferma punti di test e sintetizza la specifica.
  3. Pubblica con etichetta di triage configurata.

Cosa ottieni

  • Specifica con problema, soluzione, storie, decisioni, test ed esclusioni.

Quando usarla

  • Preservare decisioni per lavoro su più sessioni.

Quando non usarla

  • Requisiti indecisi o piccola modifica da una sessione.

Cosa richiede

  • Agente con contesto e tracker configurato tramite setup-matt-pocock-skills.
  • Tracker remoti richiedono autenticazione e permesso; Markdown locale evita servizi remoti.

File della skill

File o cartellaA cosa serve
SKILL.mdModello, conferma test e pubblicazione nel tracker.

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.

  • /to-spec — sintetizza l’export account concordato senza inventare requisiti.
  • /to-spec — conserva esclusioni e conferma prima i punti di test.
  • /to-spec #42 — trasforma questa mappa decisa in specifica realizzabile.

Come installare to-spec

Installazione e permessi

Installa e configura tracker ed etichette con setup-matt-pocock-skills. Rivedi la configurazione creata prima dell’uso.

Invocazione manuale: disable-model-invocation è true. Conferma destinazione e permessi; questo sito non crea issue.

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: 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/mattpocock/skills.git
mkdir -p ~/.claude/skills
cp -R skills/skills/engineering/to-spec ~/.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 /to-spec 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/mattpocock/skills.git
mkdir -p .agents/skills
cp -R skills/skills/engineering/to-spec .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:

Registrare decisioni già prese

Conserva vocabolario ed esclusioni reali del progetto. Non inventare decisioni per riempire sezioni.

Per più sessioni, passa a to-tickets. Mantieni entrambi nello stesso contesto per evitare di recuperare una issue enorme.

Domande su to-spec

Mi intervista?

Non fa una nuova intervista, ma verifica che i punti di test corrispondano alle aspettative.

GitHub è obbligatorio?

No. Usa Markdown locale o tracker remoto supportato configurato.

to-prd è lo stesso comando?

L’autore l’ha rinominato to-spec. Usa il nome attuale installato.

ready-for-agent può avviare lavoro indesiderato?

Sì. Un agente di polling può prendere la specifica padre come compito. Escludila esplicitamente dalla sua selezione.

Altre skill IA

Skill correlate

Categorie di skill