Archivar un cambio completado en el flujo de trabajo experimental.
Selección de almacén: Si el usuario nombra un almacén (un almacén es un repositorio OpenSpec independiente registrado en esta máquina) o el trabajo reside en uno, ejecuta openspec store list --json para descubrir los ids de almacén registrados, luego pasa --store <id> en los comandos que leen o escriben specs y cambios (new change, status, instructions, list, show, validate, archive, doctor, context). Otros comandos no toman la bandera. Las sugerencias impresas por los comandos ya llevan la bandera; mantenla en seguimientos. Sin un almacén, los comandos actúan sobre la raíz local openspec/ más cercana.
Entrada: Opcionalmente, especifica un nombre de cambio. Si se omite, verifica si se puede inferir del contexto de la conversación. Si es vago o ambiguo, DEBES solicitar los cambios disponibles.
Pasos
-
Si no se proporciona un nombre de cambio, solicita una selección
Ejecuta
openspec list --jsonpara obtener los cambios disponibles. Usa la herramienta AskUserQuestion para permitir que el usuario seleccione.Muestra solo los cambios activos (no archivados). Incluye el esquema utilizado para cada cambio si está disponible.
IMPORTANTE: No adivines ni selecciones automáticamente un cambio. Siempre deja que el usuario elija.
-
Verificar el estado de finalización de los artefactos
Ejecuta
openspec status --change "<nombre>" --jsonpara verificar la finalización de los artefactos.Analiza el JSON para entender:
schemaName: El flujo de trabajo que se está utilizandoplanningHome,changeRoot,artifactPathsyactionContext: contexto de ruta y alcanceartifacts: Lista de artefactos con su estado (doneu otro)
Si algún artefacto no está
done:- Muestra una advertencia enumerando los artefactos incompletos
- Usa la herramienta AskUserQuestion para confirmar que el usuario quiere continuar
- Continúa si el usuario confirma
-
Verificar el estado de finalización de las tareas
Lee el archivo de tareas (típicamente
tasks.md) para verificar si hay tareas incompletas.Cuenta las tareas marcadas con
- [ ](incompleta) vs- [x](completa).Si se encuentran tareas incompletas:
- Muestra una advertencia indicando el número de tareas incompletas
- Usa la herramienta AskUserQuestion para confirmar que el usuario quiere continuar
- Continúa si el usuario confirma
Si no existe el archivo de tareas: Continúa sin advertencia relacionada con tareas.
-
Evaluar el estado de sincronización de los specs delta
Usa
artifactPaths.specs.existingOutputPathsdel JSON de estado para verificar si hay specs delta. Si no existen, continúa sin solicitud de sincronización.Si existen specs delta:
- Compara cada spec delta con su spec principal correspondiente en
openspec/specs/<capacidad>/spec.md - Determina qué cambios se aplicarían (adiciones, modificaciones, eliminaciones, renombres)
- Muestra un resumen combinado antes de solicitar
Opciones de solicitud:
- Si se necesitan cambios: "Sincronizar ahora (recomendado)", "Archivar sin sincronizar"
- Si ya están sincronizados: "Archivar ahora", "Sincronizar de todos modos", "Cancelar"
Si el usuario elige sincronizar, usa la herramienta Task (subagent_type: "general-purpose", prompt: "Usa la herramienta Skill para invocar openspec-sync-specs para el cambio ''. Análisis de specs delta: <incluye el resumen del análisis de specs delta>"). Continúa para archivar independientemente de la elección.
- Compara cada spec delta con su spec principal correspondiente en
-
Realizar el archivado
Crea un directorio
archivebajoplanningHome.changesDirsi no existe:mkdir -p "<planningHome.changesDir>/archive"Genera el nombre de destino usando la fecha actual:
YYYY-MM-DD-<nombre-del-cambio>Verificar si el destino ya existe:
- Si sí: Fallar con error, sugerir renombrar el archivo existente o usar una fecha diferente
- Si no: Mover
changeRootal directorio de archivo
mv "<changeRoot>" "<planningHome.changesDir>/archive/YYYY-MM-DD-<nombre>" -
Mostrar resumen
Muestra un resumen de finalización del archivado que incluya:
- Nombre del cambio
- Esquema que se utilizó
- Ubicación del archivo
- Si los specs se sincronizaron (si corresponde)
- Nota sobre cualquier advertencia (artefactos/tareas incompletos)
Salida en caso de éxito
## Archivo Completado
**Cambio:** <nombre-del-cambio>
**Esquema:** <nombre-del-esquema>
**Archivado en:** la ruta de archivo derivada de `planningHome.changesDir`/YYYY-MM-DD-<nombre>/
**Specs:** ✓ Sincronizados con los specs principales (o "Sin specs delta" o "Sincronización omitida")
Todos los artefactos completos. Todas las tareas completas.
Guardarraíles
- Siempre solicita la selección del cambio si no se proporciona
- Usa el gráfico de artefactos (openspec status --json) para verificar la finalización
- No bloquees el archivado por advertencias, solo informa y confirma
- Preserva
.openspec.yamlal mover al archivo (se mueve con el directorio) - Muestra un resumen claro de lo que sucedió
- Si se solicita sincronización, usa el enfoque openspec-sync-specs (impulsado por el agente)
- Si existen specs delta, siempre ejecuta la evaluación de sincronización y muestra el resumen combinado antes de solicitar