Spec Kit: de intención comprobable a aceptación trazable
Qué es Spec Kit: conectar requisitos, implementación y aceptación
Comprende el CLI Specify, las instrucciones del agente y los artefactos persistentes sin confundir una especificación con un compilador o certificado de publicación.
Qué aprenderás
- Tres responsabilidades, no un generador mágico
- Explicar por qué existe cada cambio
- Empezar con una funcionalidad acotada
Antes de empezar
- Conceptos básicos de requisitos, Git y pruebas
- Distinguir desarrollo local y despliegue de aplicación
Trazar una funcionalidad desde intención hasta evidencia y separar contratos de comportamiento verificado.
Conclusiones clave
- Configuración CLI, juicio del agente y aceptación humana son responsabilidades distintas.
- Los artefactos persistentes vinculan intención con evidencia.
- Una lista completada no demuestra una funcionalidad publicada y operativa.
Tres responsabilidades, no un generador mágico
En la revisión d848fb4, GitHub Spec Kit combina el CLI Specify, instrucciones para agentes y plantillas de artefactos de funcionalidad. El CLI instala y configura el proceso; el agente interpreta las instrucciones; las personas deciden requisitos y aceptan resultados. No sustituye al modelo ni aloja la aplicación resultante.
El enfoque conserva la intención en spec.md, las decisiones técnicas en plan.md y el trabajo en tasks.md. Describir las especificaciones como ejecutables expresa una metodología, no garantiza que cualquier texto se compile de forma determinista en software correcto. Una especificación convincente también puede contener un supuesto equivocado.
Explicar por qué existe cada cambio
La secuencia establece principios, especifica resultados, planifica, genera tareas, implementa y comprueba convergencia. Para una lista de lectura pequeña, la especificación puede exigir conservar elementos después de reiniciar; el plan elige almacenamiento; las tareas indican cambios y pruebas para cumplir ese requisito.
Así aparece una cadena revisable entre necesidad y evidencia. Una tarea marcada es solamente una observación: no demuestra por sí sola que el comportamiento funcione, que se hayan probado todos los escenarios o que producción contenga la misma revisión. Documentación, implementación y publicación son estados diferentes.
Empezar con una funcionalidad acotada
Elige un recorrido de usuario que aporte valor por sí solo, no una especificación enorme de todo el producto. Conserva objetivos excluidos y preguntas pendientes. La plantilla pide historias priorizadas, pruebas independientes, escenarios de aceptación, requisitos funcionales, resultados medibles y supuestos; los marcadores no son requisitos terminados.
Esta serie lee siete archivos fijados, incluidas instrucciones de análisis y convergencia, instalación y dos entradas de scripts. Se prueba un modelo sintético separado del contrato de añadido. No instalamos Specify, ejecutamos un agente, corrimos scripts upstream ni medimos velocidad de entrega.
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
Elige un recorrido útil de forma independiente.
- 2
Define resultados observables y exclusiones.
- 3
Traza requisitos, plan, tareas y verificación.
Ejemplo para copiar
{
"ejemplo": true,
"funcionalidad": "lista local de lectura",
"requisito": "conservar elementos tras reiniciar",
"tareaMarcada": false,
"comportamientoVerificado": false,
"produccionVerificada": false
}Preguntas frecuentes
¿Spec Kit es un modelo de lenguaje?
No. Proporciona herramientas y material de proceso para integraciones de agentes.
¿Converged significa que ya está publicado?
No. Revisión, entrega y verificación de producción son pasos separados.
Fuentes
- Spec Kit / README.mdFuente verificada 2026-09-14
- Spec Kit / templates/spec-template.mdFuente verificada 2026-09-14
- Spec Kit / templates/commands/converge.mdFuente verificada 2026-09-14