Flusso di Lavoro Spec-First
Definisci i requisiti prima di scrivere codice.
OpenSpecSviluppo Guidato dalle Specifiche per Assistenti AI
Una specifica leggera per costruire e gestire progetti di assistenti AI.
Benvenuto. Questa è la casa di tutto ciò che riguarda OpenSpec.
OpenSpec aiuta te e il tuo assistente di codifica AI a concordare su cosa costruire prima che venga scritto qualsiasi codice. Tu descrivi la modifica, l'AI redige una breve specifica e un elenco di attività, entrambi guardate lo stesso piano, e poi il lavoro viene eseguito. Niente più scoperte a metà strada che l'AI ha costruito la cosa sbagliata.
Se non leggi altro, leggi queste due pagine:
/opsx:propose (suggerimento: nella chat dell'AI, non nel terminale). Questo confonde quasi tutti almeno una volta.Quella seconda pagina conta più di quanto sembri. OpenSpec ha due metà: uno strumento a riga di comando che esegui nel tuo terminale e i comandi slash che dai al tuo assistente AI. Sapere quale è quale ti risparmia il momento di confusione più comune.
La migliore abitudine da costruire per prima: quando non sei sicuro di cosa costruire, inizia con
/opsx:explore. È un partner di pensiero senza rischi che legge il tuo codice, valuta le opzioni e affina un'idea vaga in un piano concreto prima che esista qualsiasi artefatto o codice. La guida Esplora Prima spiega il perché.
Sono completamente nuovo. Inizia con Per Iniziare, poi sfoglia Concetti Fondamentali in Sintesi. Quando qualcosa sembra misterioso, le FAQ e il Glossario sono a portata di mano.
Ho un problema ma non un piano. Questo è il caso comune e ha una risposta dedicata: Esplora Prima. Usa /opsx:explore per ragionarci con l'AI prima di impegnarti in qualsiasi cosa.
Ho un grande codebase esistente. Non documenti tutto. Usare OpenSpec in un Progetto Esistente mostra come iniziare su codice reale, brownfield, senza strafare.
Voglio solo farlo funzionare. Installa, esegui openspec init, poi leggi Come Funzionano i Comandi così il tuo primo comando slash atterra nel posto giusto. Oppure affida la configurazione al tuo assistente con il prompt di installazione assistita dall'AI.
Imparo dagli esempi. La pagina Esempi e Ricette illustra modifiche reali dall'inizio alla fine: una piccola funzionalità, una correzione di bug, un refactoring, un'esplorazione.
L'AI ha appena redatto un piano — e ora? Leggilo. Revisionare una Modifica mostra il passaggio di due minuti che individua una svolta sbagliata quando è ancora poco costosa, e Scrivere Buone Specifiche copre di cosa è fatto un piano degno di approvazione.
Lavoro in un team. OpenSpec in un Team mostra come una modifica si mappa su un branch e una pull request, e come i colleghi 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 copre la configurazione del progetto, gli schemi personalizzati e il contesto condiviso.
Qualcosa è rotto. Risoluzione dei Problemi raccoglie i guasti che le persone incontrano realmente, con le soluzioni.
| Documento | Cosa ti offre |
|---|---|
| Per Iniziare | Installa, inizializza ed esegui la tua prima modifica dall'inizio alla fine |
| Esplora Prima | Usa /opsx:explore per ragionare su un'idea prima di impegnarti |
| Come Funzionano i Comandi | Dove vengono eseguiti i comandi slash, cosa significa "modalità interattiva", terminale vs chat |
| Concetti Fondamentali in Sintesi | L'intero modello mentale su una pagina: specifiche, modifiche, delta, archivio |
| Installazione | npm, pnpm, yarn, bun, Nix, un prompt che affida la configurazione al tuo assistente AI e come verificare che funzioni |
| Documento | Cosa ti offre |
|---|---|
| Flussi di Lavoro | Pattern comuni e quando usare ciascun comando |
| Esempi e Ricette | Procedure complete di modifiche reali, copiabili e incollabili |
| Scrivere Buone Specifiche | Come sono fatti un requisito e uno scenario solidi e come dimensionare correttamente una modifica |
| Revisionare una Modifica | Il passaggio di due minuti su un piano abbozzato 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 un grande codebase brownfield |
| Modificare e Iterare su una Modifica | Aggiorna gli artefatti, torna indietro, riconcilia le modifiche manuali |
| Comandi | Riferimento per ogni comando slash /opsx:* |
| CLI | Riferimento per ogni comando terminale openspec |
| Documento | Cosa ti offre |
|---|---|
| Concetti | La spiegazione estesa di specifiche, modifiche, artefatti, schemi e archivio |
| Flusso di Lavoro OPSX | Perché il flusso di lavoro è fluido invece che vincolato alle fasi, più un'immersione profonda nell'architettura |
| Glossario | Ogni termine definito 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 30+ strumenti AI con cui OpenSpec si integra e dove finiscono i file |
| Vetrina della Community | Progetti e risorse costruiti con e per OpenSpec |
| Documento | Cosa ti offre |
|---|---|
| FAQ | Risposte rapide alle domande più frequenti |
| Risoluzione dei Problemi | Soluzioni concrete per guasti concreti |
| Guida alla Migrazione | Passaggio dal flusso di lavoro legacy a OPSX |
| Documento | Cosa ti offre |
|---|---|
| Store: Guida per l'Utente | Pianifica nel suo repository quando il tuo lavoro si estende su più repository o team |
| Contratto Agente | Le superfici CLI leggibili da macchina che gli agenti guidano |
1. Install npm install -g @fission-ai/openspec@latest
2. Initialize cd your-project && openspec init
3. Explore (in your AI chat) /opsx:explore ← optional, but a great habit
4. Propose (in your AI chat) /opsx:propose add-dark-mode
5. Build (in your AI chat) /opsx:apply
6. Archive (in your AI chat) /opsx:archiveI passaggi 1 e 2 avvengono nel tuo terminale. Il resto avviene nella chat del tuo assistente AI. Questa suddivisione è 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 sei incerto è l'abitudine che vale più la pena formare.
openspec feedback "your message" invia feedback direttamente dal tuo terminale (apre un problema su GitHub).Hai trovato qualcosa in questi documenti che è sbagliato, obsoleto o confuso? È un bug. Apri un problema o una PR. I miglioramenti alla documentazione sono alcuni dei contributi più preziosi che puoi fare.