Profils
Choisissez les workflows installés, et s'ils s'installent en tant que skills, commandes, ou les deux.
Un profil correspond à vos préférences quant aux workflows OpenSpec (les skills et commandes dans votre outil IA) installés sur votre machine. Le profil par défaut est core. Incluez ou excluez des workflows et votre sélection est enregistrée en tant que profil custom.
L'ensemble de base
Le profil core installe six workflows, couvrant l'ensemble du cycle, de l'idée à l'archivage :
| Workflow | Utilité |
|---|---|
explore | Réfléchir à une idée avant qu'elle ne devienne une proposition de changement |
propose | Créer une proposition de changement et générer tous ses artefacts de planification en une seule étape |
apply | Implémenter les tâches d'une proposition de changement |
update | Réviser les artefacts de planification existants d'une proposition de changement |
sync | Fusionner les mises à jour de spec d'une proposition de changement dans specs/ sans l'archiver |
archive | Déplacer une proposition de changement terminée vers les archives |
Chacun est lié à son contrat complet : arguments, ce qu'il crée et ce à quoi il répond.
Enrichir l'ensemble : workflows optionnels
Six workflows supplémentaires sont disponibles au-delà de l'ensemble de base. Trois d'entre eux (new, continue, ff) créent une proposition de changement artefact par artefact, au lieu de tout générer d'un coup comme propose.
| Workflow | Utilité |
|---|---|
new | Démarrer une proposition de changement comme un échafaudage vide |
continue | Créer l'artefact de planification suivant dans une proposition de changement, un par un |
ff | Créer une proposition de changement et tous les artefacts de planification dont l'implémentation a besoin, en une seule passe |
verify | Vérifier que l'implémentation correspond aux artefacts de la proposition de changement |
bulk-archive | Archiver plusieurs propositions de changement en une seule fois |
onboard | Apprendre le workflow en réalisant une véritable proposition de changement de bout en bout |
Pour modifier l'ensemble, lancez le sélecteur interactif :
openspec config profileLe sélecteur demande ce qu'il faut configurer (la livraison, les workflows, ou les deux), puis liste les douze workflows sous forme de cases à cocher, avec ceux installés étant cochés. Toute sélection qui n'est pas exactement les six workflows de base est enregistrée comme profil custom, vous pouvez donc également décocher les workflows de base que vous n'utilisez pas.
Livraison : skills, commandes, ou les deux
La livraison est un paramètre de profil qui vous permet de choisir de n'installer que des skills ou que des commandes. La valeur par défaut est both. La configuration de votre projet explique les deux formes et pourquoi elles existent toutes les deux. Le contrat exact du champ se trouve dans Paramètres CLI (config.json).
Deux façons de le modifier :
Interactivement : lancez openspec config profile et choisissez « Livraison uniquement ». Voici comment passer en skills uniquement :
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) yDirectement : une seule commande, sans invite :
openspec config set delivery skills # ou : both, commandsLa livraison ne modifie jamais le nom du profil. core et custom décrivent uniquement l'ensemble de workflows, et revenir à core conserve votre paramètre de livraison.
Changer de profil
Le changement se fait en deux étapes : modifiez le profil sur votre machine, puis mettez à jour chaque projet pour l'appliquer.
Modifiez le profil :
bashopenspec config profile # interactif openspec config profile core # réinitialiser aux six de base (conserve la livraison)Exécutez la mise à jour dans chaque projet dans lequel vous travaillez :
bashopenspec update
Lorsque votre répertoire courant est un projet OpenSpec existant, le flux interactif vous propose d'exécuter l'étape 2 pour vous.