Implementa tareas de un cambio en OpenSpec.
Selección de almacén: Si el usuario nombra un almacén (un almacén es un repositorio independiente de OpenSpec registrado en esta máquina) o el trabajo reside en uno, ejecuta openspec store list --json para descubrir los IDs de los almacenes registrados, luego pasa --store <id> en los comandos que leen o escriben especificaciones y cambios (new change, status, instructions, list, show, validate, archive, doctor, context). Otros comandos no toman la bandera. Las pistas 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 al usuario los cambios disponibles.
Pasos
-
Seleccionar el cambio
Si se proporciona un nombre, úsalo. De lo contrario:
- Inferir del contexto de la conversación si el usuario mencionó un cambio
- Auto-seleccionar si solo existe un cambio activo
- Si es ambiguo, ejecuta
openspec list --jsonpara obtener los cambios disponibles y usa la herramienta AskUserQuestion para permitir que el usuario seleccione
Siempre anuncia: "Usando el cambio: " y cómo sobrescribir (ej.,
/opsx:apply <otro>). -
Verificar el estado para entender el esquema
openspec status --change "<nombre>" --jsonAnaliza el JSON para entender:
schemaName: El flujo de trabajo que se está utilizando (ej., "spec-driven")planningHome,changeRootyactionContext: alcance de planificación y restricciones de edición- Qué artefacto contiene las tareas (típicamente "tasks" para spec-driven, verifica el estado para otros)
-
Obtener las instrucciones de aplicación
openspec instructions apply --change "<nombre>" --jsonEsto devuelve:
contextFiles: ID del artefacto -> arreglo de rutas de archivo concretas (varía según el esquema: puede ser propuesta/especificaciones/diseño/tareas o especificación/pruebas/implementación/documentos)- Progreso (total, completadas, restantes)
- Lista de tareas con estado
- Instrucción dinámica basada en el estado actual
Manejar estados:
- Si
state: "blocked"(artefactos faltantes): mostrar mensaje, sugerir usar openspec-continue-change - Si
state: "all_done": felicitar, sugerir archivar - De lo contrario: proceder a la implementación
-
Leer los archivos de contexto
Lee cada ruta de archivo listada en
contextFilesde la salida de las instrucciones de aplicación. Los archivos dependen del esquema que se esté utilizando:- spec-driven: propuesta, especificaciones, diseño, tareas
- Otros esquemas: seguir los contextFiles de la salida del CLI
-
Mostrar el progreso actual
Muestra:
- Esquema que se está utilizando
- Progreso: "N/M tareas completadas"
- Resumen de tareas restantes
- Instrucción dinámica del CLI
-
Implementar tareas (bucle hasta terminar o bloquearse)
Para cada tarea pendiente:
- Mostrar en qué tarea se está trabajando
- Realizar los cambios de código necesarios
- Mantener los cambios mínimos y enfocados
- Marcar la tarea como completada en el archivo de tareas:
- [ ]→- [x] - Continuar con la siguiente tarea
Pausar si:
- La tarea no está clara → pedir aclaración
- La implementación revela un problema de diseño → sugerir actualizar artefactos
- Se encuentra un error o bloqueo → informar y esperar instrucciones
- El usuario interrumpe
-
Al completar o pausar, mostrar el estado
Muestra:
- Tareas completadas en esta sesión
- Progreso general: "N/M tareas completadas"
- Si todo está hecho: sugerir archivar
- Si está en pausa: explicar por qué y esperar instrucciones
Salida durante la implementación
## Implementando: <nombre-del-cambio> (esquema: <nombre-del-esquema>)
Trabajando en la tarea 3/7: <descripción de la tarea>
[...implementación en curso...]
✓ Tarea completada
Trabajando en la tarea 4/7: <descripción de la tarea>
[...implementación en curso...]
✓ Tarea completada
Salida al completar
## Implementación Completa
**Cambio:** <nombre-del-cambio>
**Esquema:** <nombre-del-esquema>
**Progreso:** 7/7 tareas completadas ✓
### Completado en esta sesión
- [x] Tarea 1
- [x] Tarea 2
...
¡Todas las tareas completadas! Listo para archivar este cambio.
Salida al pausar (problema encontrado)
## Implementación Pausada
**Cambio:** <nombre-del-cambio>
**Esquema:** <nombre-del-esquema>
**Progreso:** 4/7 tareas completadas
### Problema encontrado
<descripción del problema>
**Opciones:**
1. <opción 1>
2. <opción 2>
3. Otro enfoque
¿Qué te gustaría hacer?
Guardarraíles
- Continuar con las tareas hasta terminar o bloquearse
- Siempre leer los archivos de contexto antes de comenzar (de la salida de las instrucciones de aplicación)
- Si la tarea es ambigua, pausar y preguntar antes de implementar
- Si la implementación revela problemas, pausar y sugerir actualizaciones de artefactos
- Mantener los cambios de código mínimos y limitados a cada tarea
- Actualizar la casilla de la tarea inmediatamente después de completar cada tarea
- Pausar ante errores, bloqueos o requisitos poco claros; no adivinar
- Usar contextFiles de la salida del CLI, no asumir nombres de archivo específicos
Integración de flujo de trabajo fluido
Este skill soporta el modelo de "acciones sobre un cambio":
- Se puede invocar en cualquier momento: Antes de que todos los artefactos estén listos (si existen tareas), después de una implementación parcial, intercalado con otras acciones
- Permite actualizaciones de artefactos: Si la implementación revela problemas de diseño, sugiere actualizar artefactos; no está bloqueado por fases, trabaja de forma fluida.