OpenSpecSviluppo Guidato dalle Specifiche per Assistenti AI

La nostra filosofia:

→ fluido non rigido
→ iterativo non a cascata
→ semplice non complesso
→ progettato per brownfield non solo greenfield
→ scalabile da progetti personali a livello aziendale

Segui @0xTab su X per aggiornamenti · Unisciti al Discord di OpenSpec per aiuto e domande.

Vederlo in azione ​

Tu: /opsx:propose add-dark-mode
AI:  Creata openspec/changes/add-dark-mode/
     ✓ proposal.md — perché lo stiamo facendo, cosa sta cambiando
     ✓ specs/       — requisiti e scenari
     ✓ design.md    — approccio tecnico
     ✓ tasks.md     — checklist di implementazione
     Pronto per l'implementazione!

Tu: /opsx:apply
AI:  Implementazione dei task in corso...
     ✓ 1.1 Aggiungi provider del contesto del tema
     ✓ 1.2 Crea componente di toggle
     ✓ 2.1 Aggiungi variabili CSS
     ✓ 2.2 Collega localStorage
     Tutti i task completati!

Tu: /opsx:archive
AI:  Archiviato in openspec/changes/archive/2025-01-23-add-dark-mode/
     Specifiche aggiornate. Pronto per la prossima funzionalità.

Avvio Rapido ​

Richiede Node.js 20.19.0 o superiore.

Installa OpenSpec globalmente:

npm install -g @fission-ai/openspec@latest

Quindi naviga nella directory del tuo progetto e inizializza:

cd your-project
openspec init

Ora di' alla tua AI: /opsx:propose <quello-che-vuoi-costruire>

Se desideri il flusso di lavoro esteso (/opsx:new, /opsx:continue, /opsx:ff, /opsx:verify, /opsx:sync, /opsx:bulk-archive, /opsx:onboard), selezionalo con openspec config profile e applicalo con openspec update.

Documentazione ​

→ Guida Introduttiva: primi passi
→ Flussi di Lavoro: combinazioni e pattern
→ Comandi: comandi slash e skill
→ CLI: riferimento per il terminale
→ Strumenti Supportati: integrazioni e percorsi di installazione
→ Concetti: come tutto si incastra
→ Multi-Lingua: supporto multilingue
→ Personalizzazione: adattalo a te

Perché OpenSpec? ​

Gli assistenti di programmazione AI sono potenti ma imprevedibili quando i requisiti vivono solo nella cronologia della chat. OpenSpec aggiunge un livello di specifica leggero in modo che ci si accordi su cosa costruire prima che venga scritto qualsiasi codice.

• Accordati prima di costruire — umano e AI si allineano sulle specifiche prima che il codice venga scritto
• Rimani organizzato — ogni modifica ha la sua cartella con proposta, specifiche, design e task
• Lavora in modo fluido — aggiorna qualsiasi artefatto in qualsiasi momento, senza fasi rigide
• Usa i tuoi strumenti — funziona con oltre 20 assistenti AI tramite comandi slash

Come ci confrontiamo ​

vs. Spec Kit (GitHub) — Approfondito ma pesante. Fasi rigide, molto Markdown, setup in Python. OpenSpec è più leggero e ti permette di iterare liberamente.

vs. Kiro (AWS) — Potente ma sei vincolato al loro IDE e limitato ai modelli Claude. OpenSpec funziona con gli strumenti che già usi.

vs. niente — La programmazione AI senza specifiche significa prompt vaghi e risultati imprevedibili. OpenSpec porta prevedibilità senza la cerimonia.

Aggiornare OpenSpec ​

Aggiorna il pacchetto

npm install -g @fission-ai/openspec@latest

Aggiorna le istruzioni per l'agente

Esegui questo all'interno di ogni progetto per rigenerare la guida AI e assicurarti che gli ultimi comandi slash siano attivi:

openspec update

Note sull'Uso ​

Selezione del modello: OpenSpec funziona meglio con modelli ad alto ragionamento. Raccomandiamo Opus 4.5 e GPT 5.2 sia per la pianificazione che per l'implementazione.

Igiene del contesto: OpenSpec beneficia di una finestra di contesto pulita. Cancella il contesto prima di iniziare l'implementazione e mantieni una buona igiene del contesto durante l'intera sessione.

Contribuire ​

Piccole correzioni — Fix di bug, correzioni di refusi e miglioramenti minori possono essere inviati direttamente come PR.

Modifiche più grandi — Per nuove funzionalità, refactoring significativi o modifiche architettoniche, invia prima una proposta di modifica OpenSpec in modo da poterci allineare su intenti e obiettivi prima che inizi l'implementazione.

Quando scrivi le proposte, tieni a mente la filosofia di OpenSpec: serviamo un'ampia varietà di utenti con diversi agenti di programmazione, modelli e casi d'uso. Le modifiche dovrebbero funzionare bene per tutti.

Il codice generato dall'AI è benvenuto — purché sia stato testato e verificato. Le PR che contengono codice generato dall'AI dovrebbero menzionare l'agente di programmazione e il modello utilizzati (es., "Generato con Claude Code usando claude-opus-4-5-20251101").

Sviluppo ​

• Installa le dipendenze: pnpm install
• Build: pnpm run build
• Test: pnpm test
• Sviluppa la CLI localmente: pnpm run dev o pnpm run dev:cli
• Commit convenzionali (una riga): type(scope): subject

Altro ​

Licenza ​

MIT