OpenSpec: convertir una petición de código en documentos revisables
Primeros pasos con OpenSpec: especificar una exportación CSV
Inicializa un proyecto desechable y revisa un escenario con entrada y salida conocidas.
Qué aprenderás
- Preparar una prueba reversible
- Inicializar y elegir la interfaz correcta
- Dar al escenario una condición verificable
Antes de empezar
- Conocimientos básicos de Git y Node
- Repositorio de ejemplo desechable
Explica dependencias y evidencia pendiente sin ejecutar automáticamente el comando recomendado.
Conclusiones clave
- La inicialización escribe instrucciones.
- latest es un destino cambiante.
- Una entrada conocida permite verificar el resultado.
Preparar una prueba reversible
Utiliza un repositorio de ejemplo o un worktree aislado y conserva los cambios existentes. El README inspeccionado requiere Node.js 20.19.0 o posterior. Registra la versión instalada porque latest seguirá cambiando.
El comando npm mostrado procede del README y modifica la instalación global. Revisa ese efecto antes de ejecutarlo. Aquí se documenta el procedimiento; no se afirma haber probado la instalación ni la integración.
Inicializar y elegir la interfaz correcta
Ejecuta openspec init dentro del proyecto de prueba e inspecciona los archivos modificados. La inicialización muestra la invocación correspondiente a cada herramienta. Introduce la propuesta en el asistente, no en la terminal.
Pide una exportación que defina comas entrecomilladas y resultados vacíos. Revisa propuesta, especificaciones y diseño antes de implementar. El perfil predeterminado incluye explore y propose; los comandos ampliados requieren cambiar el perfil y actualizarlo.
Dar al escenario una condición verificable
Escribe una fila conocida y su salida escapada esperada. El esquema usa un encabezado Requirement y otro Scenario con cuatro almohadillas, además de WHEN y THEN. Cada tarea debe explicar cómo comprobar su finalización.
Detén la prueba si la inicialización afecta otro proyecto o la propuesta inventa comportamiento. Revisa el diff y restaura únicamente los cambios del ensayo que te pertenecen, sin descartar trabajo ajeno.
Cómo elegir
| Criterio | Opción A | Opción B |
|---|---|---|
| Best when | You need predictable behavior and easy auditing | You need adaptive optimization and have reliable telemetry |
| Main risk | May leave performance on the table | Can become difficult to explain or debug |
Pasos de implementación
- 1
Comprueba Node y conserva el espacio original.
- 2
Inicializa e inspecciona la invocación.
- 3
Aprueba el escenario antes de implementar.
Ejemplo para copiar
node --version
npm install -g @fission-ai/openspec@latest
cd your-trial-project
openspec --version
openspec initPreguntas frecuentes
¿Dónde escribo el comando de propuesta?
En el asistente compatible, con la forma que imprime la inicialización.
¿Conviene empezar en una copia con cambios pendientes?
Es preferible un ejemplo o worktree aislado que conserve esos cambios.
Fuentes
- OpenSpec / README.mdFuente verificada 2026-09-23
- OpenSpec / schemas/spec-driven/schema.yamlFuente verificada 2026-09-23