Perfiles

Elige qué flujos de trabajo se instalan y si se instalan como skills, comandos o ambos.

Un perfil es tu preferencia sobre qué flujos de trabajo de OpenSpec (los skills y comandos de tu herramienta de IA) se instalan en tu máquina. El perfil predeterminado es core. Incluye o excluye flujos de trabajo y tu selección se guarda como el perfil custom.

El conjunto core

El perfil core instala seis flujos de trabajo que cubren todo el ciclo, desde la idea hasta el archivado:

Flujo de trabajo	Para qué sirve
explore	Analizar una idea antes de que se convierta en una propuesta de cambio
propose	Crear una propuesta de cambio y generar todos sus artefactos de planificación en un solo paso
apply	Implementar las tareas de una propuesta de cambio
update	Revisar los artefactos de planificación existentes de una propuesta de cambio
sync	Fusionar las actualizaciones de especificaciones de una propuesta de cambio en specs/ sin archivarla
archive	Mover una propuesta de cambio finalizada al archivo

Cada uno enlaza a su contrato completo: argumentos, qué crea y con qué responde.

Ampliar el conjunto: flujos de trabajo opcionales

Hay seis flujos de trabajo más disponibles además del conjunto core. Tres de ellos (new, continue, ff) crean los artefactos de una propuesta de cambio uno por uno, en lugar de todos a la vez como propose.

Flujo de trabajo	Para qué sirve
new	Iniciar una propuesta de cambio como un esqueleto vacío
continue	Crear el siguiente artefacto de planificación de una propuesta de cambio, uno por uno
ff	Crear una propuesta de cambio y todos los artefactos de planificación que necesita la implementación, en una sola pasada
verify	Comprobar que la implementación coincide con los artefactos de la propuesta de cambio
bulk-archive	Archivar varias propuestas de cambio a la vez
onboard	Aprender el flujo de trabajo realizando una propuesta de cambio real de principio a fin

Para cambiar el conjunto, ejecuta el selector interactivo:

openspec config profile

El selector pregunta qué configurar (entrega, flujos de trabajo o ambos), luego muestra los doce flujos de trabajo como casillas de verificación, con los instalados marcados. Cualquier selección que no coincida exactamente con los seis del core se guarda como el perfil custom, así que también puedes desmarcar flujos de trabajo del core que no uses.

Entrega: skills, comandos o ambos

La entrega es un ajuste del perfil que te permite elegir que solo se instalen skills o solo comandos. El valor predeterminado es both. Configura tu proyecto explica las dos formas y por qué existen ambas. El contrato exacto del campo está en Ajustes de la CLI (config.json).

Dos formas de cambiarlo:

De forma interactiva: ejecuta openspec config profile y elige "Delivery only". Así se cambia a solo skills:

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

Directamente: un solo comando, sin preguntas:

openspec config set delivery skills   # o: both, commands

La entrega nunca cambia el nombre del perfil. core y custom describen únicamente el conjunto de flujos de trabajo, y volver a core conserva tu ajuste de entrega.

Cambiar de perfil

Cambiar de perfil consta de dos pasos: cambia el perfil en tu máquina y luego actualiza cada proyecto para aplicarlo.

1. Cambia el perfil:

   openspec config profile        # interactivo
   openspec config profile core   # restablecer a los seis del core (conserva la entrega)

2. Ejecuta la actualización en cada proyecto en el que trabajes:

   openspec update

Cuando tu directorio actual es un proyecto OpenSpec existente, el flujo interactivo te ofrece ejecutar el paso 2 allí por ti.