Flusso di lavoro Spec-First
Definisci i requisiti prima di scrivere codice.
OpenSpecSviluppo Guidato da Specifiche per Assistenti AI
Una specifica leggera per creare e gestire progetti di assistenti AI.
Una specifica leggera per creare e gestire progetti di assistenti AI.
Benvenuto. Questa è la casa di tutto ciò che riguarda OpenSpec.
OpenSpec ti aiuta a concordare con il tuo assistente di codifica AI cosa costruire prima che venga scritto qualsiasi codice. Descrivi la modifica, l'AI redige una breve specifica e un elenco di attività, entrambi esaminate lo stesso piano, e poi il lavoro viene svolto. Niente più sorprese a metà strada quando scopri che l'AI ha costruito la cosa sbagliata.
Se non leggi nient'altro, leggi queste due pagine:
/opsx:propose (suggerimento: nella chat della tua AI, non nel terminale). Questo crea confusione a quasi tutti la prima volta.La seconda pagina è più importante di quanto sembri. OpenSpec ha due parti: uno strumento da riga di comando che esegui nel terminale, e i comandi slash che invii al tuo assistente AI. Saper distinguere tra i due ti evita il momento di confusione più comune.
L'abitudine migliore da sviluppare per prima: quando non sei sicuro di cosa costruire, inizia con
/opsx:explore. È un partner di riflessione senza rischi che legge il tuo codice, valuta le opzioni e trasforma un'idea vaga in un piano concreto prima che venga creato qualsiasi artefatto o codice. La guida Esplora prima spiega perché funziona.
Sei completamente nuovo. Inizia con Inizia, poi sfoglia velocemente Concetti chiave in sintesi. Quando qualcosa ti sembra poco chiaro, il FAQ e il Glossario sono a portata di mano.
Hai un problema ma non un piano. Questo è il caso più comune, e ha una risposta dedicata: Esplora prima. Usa /opsx:explore per pensarci insieme all'AI prima di impegnarti in qualsiasi cosa.
Hai una codebase esistente di grandi dimensioni. Non devi documentarla tutta. Usare OpenSpec in un progetto esistente mostra come iniziare con codice brownfield reale senza dover gestire l'intera codebase in una sola volta.
Voglio solo farlo funzionare. Installa, esegui openspec init, poi leggi Come funzionano i comandi in modo che il tuo primo comando slash finisca nel posto giusto.
Imparo con gli esempi. La pagina Esempi e Ricette accompagna attraverso modifiche reali dall'inizio alla fine: una piccola funzionalità, una correzione di bug, un refactor, un'esplorazione.
L'AI ha appena redatto un piano — e adesso? Leggilo. Revisionare una modifica mostra la verifica di due minuti che individua un errore di direzione mentre è ancora economico correggerlo, e Scrivere specifiche valide spiega di cosa è fatto un piano che vale la pena approvare.
Lavoro in un team. OpenSpec in un team mostra come una modifica si mappa su un branch e una pull request, e come i compagni di team revisionano un piano prima del codice.
Vengo dal vecchio flusso di lavoro. La Guida alla migrazione spiega cosa è cambiato e perché, e garantisce che il tuo lavoro esistente è al sicuro.
Voglio adattarlo al processo del mio team. Personalizzazione tratta la configurazione del progetto, schemi personalizzati e contesto condiviso.
Qualcosa non funziona. Risoluzione dei problemi raccoglie gli errori che le persone incontrano realmente, con le relative soluzioni.
| Documento | Cosa ti offre |
|---|---|
| Inizia | Installa, inizializza ed esegui la tua prima modifica da cima a fondo |
| Esplora prima | Usa /opsx:explore per valutare un'idea prima di impegnarti |
| Come funzionano i comandi | Dove vengono eseguiti i comandi slash, cosa significa "modalità interattiva", terminale vs chat |
| Concetti chiave in sintesi | Tutto il modello mentale in una pagina: specifiche, modifiche, delta, archivio |
| Installazione | npm, pnpm, yarn, bun, Nix e come verificare che l'installazione sia andata a buon fine |
| Documento | Cosa ti offre |
|---|---|
| Flussi di lavoro | Modelli comuni e quando usare ogni comando |
| Esempi e Ricette | Guide complete di modifiche reali, copiabili e incollabili |
| Scrivere specifiche valide | Come sono fatti un requisito e uno scenario solidi, e come dimensionare correttamente una modifica |
| Revisionare una modifica | La verifica di due minuti su un piano redatto prima che venga scritto qualsiasi codice |
| OpenSpec in un team | Come le modifiche si inseriscono in branch, pull request e revisioni |
| Usare OpenSpec in un progetto esistente | Adottare OpenSpec su una codebase brownfield di grandi dimensioni |
| Modifica e iterazione su una modifica | Aggiornare gli artefatti, tornare indietro, riconciliare modifiche manuali |
| Comandi | Riferimento per ogni comando slash /opsx:* |
| CLI | Riferimento per ogni comando da terminale openspec |
| Documento | Cosa ti offre |
|---|---|
| Concetti | La spiegazione dettagliata di specifiche, modifiche, artefatti, schemi e archivio |
| Flusso di lavoro OPSX | Perché il flusso di lavoro è fluido invece che suddiviso in fasi bloccate, più un'approfondimento sull'architettura |
| Glossario | Tutti i termini definiti in un unico posto |
| Documento | Cosa ti offre |
|---|---|
| Personalizzazione | Configurazione del progetto, schemi personalizzati, contesto condiviso |
| Multi-lingua | Genera artefatti in lingue diverse dall'inglese |
| Strumenti supportati | I più di 25 strumenti AI con cui OpenSpec si integra, e dove vengono salvati i file |
| Documento | Cosa ti offre |
|---|---|
| FAQ | Risposte rapide alle domande che le persone fanno più spesso |
| Risoluzione dei problemi | Soluzioni concrete per errori concreti |
| Guida alla migrazione | Passare dal vecchio flusso di lavoro a OPSX |
| Documento | Cosa ti offre |
|---|---|
| Store: Guida per l'utente | Pianifica in un repository dedicato quando il tuo lavoro coinvolge più repository o team |
| Contratto Agente | Le interfacce CLI leggibili dalle macchine su cui si basano gli agenti |
1. Installa npm install -g @fission-ai/openspec@latest
2. Inizializza cd your-project && openspec init
3. Esplora (nella chat della tua AI) /opsx:explore ← opzionale, ma un'abitudine eccellente
4. Proponi (nella chat della tua AI) /opsx:propose add-dark-mode
5. Costruisci (nella chat della tua AI) /opsx:apply
6. Archivia (nella chat della tua AI) /opsx:archiveI passaggi 1 e 2 avvengono nel tuo terminale. Il resto avviene nella chat del tuo assistente AI. Questa distinzione è l'unica cosa che vale la pena memorizzare, e Come funzionano i comandi spiega esattamente perché. Il passaggio 3 è opzionale, ma iniziare con /opsx:explore quando non sei sicuro è l'abitudine più utile da sviluppare.
openspec feedback "tuo messaggio" invia feedback direttamente dal tuo terminale (apre un problema su GitHub).Hai trovato qualcosa in questa documentazione che è sbagliato, obsoleto o poco chiaro? È un bug. Apri un problema o una pull request. I miglioramenti alla documentazione sono alcuni dei contributi più preziosi che puoi fare.