Skip to content

Profili ​

Scegli quali workflow vengono installati e se vengono installati come skill, comandi o entrambi.

Un profilo rappresenta la tua preferenza su quali workflow di OpenSpec (gli skill e i comandi nel tuo strumento IA) vengono installati sulla tua macchina. Il profilo predefinito è core. Includi o escludi workflow e la tua selezione viene salvata come profilo custom.

Il set principale ​

Il profilo core installa sei workflow, coprendo l'intero ciclo dall'idea all'archiviazione:

WorkflowA cosa serve
exploreRagiona su un'idea prima che diventi una proposta di modifica
proposeCrea una proposta di modifica e genera tutti i suoi artefatti di pianificazione in un unico passaggio
applyImplementa le attività di una proposta di modifica
updateRivedi gli artefatti di pianificazione esistenti di una proposta di modifica
syncUnisci gli aggiornamenti delle specifiche di una proposta di modifica in specs/ senza archiviarla
archiveSposta una proposta di modifica completata nell'archivio

Ognuno rimanda al suo contratto completo: argomenti, cosa crea e con cosa risponde.

Espandere il set: workflow opzionali ​

Sei ulteriori workflow sono disponibili oltre al set principale. Tre di essi (new, continue, ff) creano una proposta di modifica artefatto per artefatto, invece che tutto insieme come fa propose.

WorkflowA cosa serve
newAvvia una proposta di modifica come scheletro vuoto
continueCrea il successivo artefatto di pianificazione in una proposta di modifica, uno alla volta
ffCrea una proposta di modifica e tutti gli artefatti di pianificazione necessari all'implementazione, in un unico passaggio
verifyVerifica che l'implementazione corrisponda agli artefatti della proposta di modifica
bulk-archiveArchivia più proposte di modifica contemporaneamente
onboardImpara il workflow eseguendo una vera proposta di modifica dall'inizio alla fine

Per modificare il set, esegui il selettore interattivo:

bash
openspec config profile

Il selettore chiede cosa configurare (delivery, workflow o entrambi), quindi elenca tutti i dodici workflow come caselle di controllo, con quelli installati selezionati. Qualsiasi selezione che non corrisponda esattamente ai sei workflow principali viene salvata come profilo custom, quindi puoi anche deselezionare i workflow principali che non utilizzi.

Delivery: skill, comandi o entrambi ​

Delivery è un'impostazione del profilo che ti permette di scegliere di installare solo skill o solo comandi. Il valore predefinito è both. Configura il tuo progetto spiega le due forme e il motivo per cui entrambe esistono. Il contratto esatto del campo si trova in Impostazioni CLI (config.json).

Due modi per modificarlo:

Interattivamente: esegui openspec config profile e scegli "Delivery only". Ecco il passaggio a solo skill:

Current profile settings
  Delivery: both

? What do you want to configure? Delivery only
? Delivery mode (how workflows are installed): Skills only

Config changes:
  delivery: both -> skills
? Apply changes to this project now? (Y/n) y

Direttamente: un comando, senza prompt:

bash
openspec config set delivery skills   # oppure: both, commands

Delivery non modifica mai il nome del profilo. core e custom descrivono solo il set di workflow, e il ritorno a core mantiene la tua impostazione di delivery.

Cambiare profilo ​

Il cambio avviene in due passaggi: modifica il profilo sulla tua macchina, quindi aggiorna ogni progetto per applicarlo.

  1. Modifica il profilo:

    bash
    openspec config profile        # interattivo
    openspec config profile core   # ripristina i sei principali (mantiene delivery)
  2. Esegui l'aggiornamento in ogni progetto in cui lavori:

    bash
    openspec update

Quando la directory corrente è un progetto OpenSpec esistente, il flusso interattivo si offre di eseguire il passaggio 2 per te.