Spec Kit scrive i documenti.DotMD è dove li rivedi.

Cos’è GitHub Spec Kit

Spec Kit è il toolkit open source di GitHub per lo sviluppo guidato dalle spec. Non sostituisce il tuo agente. Aggiunge uno strumento a riga di comando, specify, che prepara il progetto, e una serie di comandi da eseguire nella chat dell’agente. L’agente scrive; Spec Kit gli dà i passi e la struttura.

Supporta molti agenti, tra cui Claude Code, Codex CLI e Cursor. L’elenco completo è nella pagina delle integrazioni di Spec Kit.

Installa e inizializza

Servono Python 3.11 o successivo e uv. Poi:

uv tool install specify-cli
specify init my-project --integration claude

Il flag --integration accetta la chiave del tuo agente: claude per Claude Code, codex per Codex CLI, cursor-agent per Cursor. La pagina di Spec Kit elenca la chiave di ogni altro agente.

I comandi, in ordine

Li scrivi nella chat dell’agente, non nel terminale:

1. /speckit-constitution
2. /speckit-specify: scrive spec.md.
3. /speckit-plan: scrive plan.md.
4. /speckit-tasks: scrive tasks.md.
5. /speckit-implement: costruisce a partire dalle attività.
6. /speckit-converge

La scrittura di un comando cambia da agente ad agente: alcuni usano /speckit.specify, altri un trattino o un $. Spec Kit spiega le forme per ogni agente nelle sue note sull’invocazione dei comandi.

Rivedi ogni passo in DotMD

Spec Kit ti chiede di rivedere ogni risultato prima di continuare. DotMD ne fa una vera revisione invece di una scorsa nel terminale.

1. Apri il progetto

   Premi ⌘O e scegli la cartella del progetto. I file scritti da Spec Kit compaiono nella barra laterale man mano che vengono creati, renderizzati con titoli, elenchi e tabelle.

2. Commenta la riga esatta

   Leggi spec.md, seleziona un requisito sbagliato o vago e premi ⌥⌘M. Scrivi cosa cambiare. I commenti li conserva DotMD, non il file.

3. Fai correggere all’agente

   Di’ all’agente: “Go through my comments in DotMD.” Li legge via MCP e modifica il file. Ogni correzione è mostrata accanto al suo commento, il testo vecchio in rosso e il nuovo in verde. Accetta o riapri ciascuna.

4. Solo allora esegui il comando successivo

   Quando la spec è giusta, esegui /speckit-plan, e ripeti per il piano e per le attività. Un errore preso nella spec costa un commento; preso nel codice, costa un rifacimento.

Controllare tasks.md

L’elenco delle attività è una checklist Markdown, e DotMD renderizza le liste di attività con le loro caselle, così vedi a colpo d’occhio cosa è fatto e cosa resta. Prima di eseguire /speckit-implement, leggi le attività come le leggerà l’agente: in ordine, ciascuna piccola, nessuna mancante. Se hai eseguito il passo di analisi di Spec Kit, trattane i risultati allo stesso modo: aprili in DotMD e commenta quelli con cui non sei d’accordo.

Collegare l’agente a DotMD richiede una riga; le guide a Claude Code, Codex e Cursor la mostrano.

Perché rivedere ogni file

Spec Kit è veloce: un comando e compare un intero documento. Quella velocità è il rischio. Se la spec ha un requisito sbagliato e tu esegui il comando successivo senza leggerla, il piano e le attività si basano su di esso, e così il codice. Leggere con attenzione spec.md una volta sola è il controllo più economico dell’intero processo.

Domande su Spec Kit

Altre domande