Spec Kit: de intención comprobable a aceptación trazable
Instalar y actualizar Spec Kit no equivale a desplegar la aplicación
Elige una instalación fijada, variante de scripts e integración explícita y protege archivos existentes durante inicialización y actualización.
Qué aprenderás
- Instalar una herramienta de desarrollo
- Inicializar un proyecto vacío con decisiones explícitas
- Separar actualización y entrega
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
- Instalar el toolkit y desplegar la aplicación son hitos distintos.
- Elige explícitamente scripts e integración para practicar.
- Comprobar versión no demuestra procedencia del paquete.
Instalar una herramienta de desarrollo
La guía fijada exige Python 3.11 o posterior y describe distribución de specify-cli desde código fuente y PyPI. Recomienda uv y admite pipx. Windows dispone de scripts PowerShell sin requerir WSL; existen variantes Bash, PowerShell y Python.
Selecciona una versión deliberadamente y registra su procedencia. Un número antiguo usado como ejemplo no es una recomendación de la última versión. El commit de este artículo identifica evidencia, no promete ser la mejor edición para instalar. No instalamos ni actualizamos estas herramientas en el espacio de trabajo.
Inicializar un proyecto vacío con decisiones explícitas
El ejemplo supone Specify ya instalado y crea un directorio de práctica con scripts PowerShell. Cambia la integración solo después de comprobar las opciones de tu versión. Evita inicializar por la fuerza el repositorio actual no vacío mientras aprendes; inspecciona primero qué instrucciones y plantillas añadirá.
El README documenta --non-interactive para sesiones desatendidas y --ignore-agent-tools para obtener plantillas sin comprobar herramientas del agente. Este último no instala ni autentica el agente ausente. Specify version confirma disponibilidad y versión, pero no acredita el canal de distribución del ejecutable.
Separar actualización y entrega
El README distingue specify self check, self upgrade --dry-run y self upgrade real. La actualización sin modificadores ejecuta cambios, no se limita a mostrar un plan. Conserva personalizaciones, revisa compatibilidad y registra la instalación anterior y el estado del proyecto antes de actualizar un proceso de equipo.
Inicializar artefactos no publica la aplicación generada. Compilación, pruebas, configuración, despliegue y aceptación posterior pertenecen al proyecto objetivo. Este tutorial no creó recursos cloud, instaló hooks o paquetes ni publicó un servicio real.
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
Registra versión elegida y runtime compatible.
- 2
Inicializa un directorio nuevo y desechable.
- 3
Inspecciona archivos y disponibilidad del agente.
- 4
Previsualiza la actualización antes de ejecutarla.
Ejemplo para copiar
specify version
specify init speckit-practice --integration copilot --script ps --non-interactive
specify self check
specify self upgrade --dry-runPreguntas frecuentes
¿Windows necesita WSL obligatoriamente?
La guía inspeccionada admite scripts PowerShell directamente en Windows.
¿--ignore-agent-tools instala el agente?
No. Omite la comprobación; no aporta el agente ni autenticación.
Fuentes
- Spec Kit / docs/installation.mdFuente verificada 2026-09-14
- Spec Kit / README.mdFuente verificada 2026-09-14