Versiones, artefactos y límites de Spec Kit

Este itinerario se comprobó con Spec Kit v1.0.4 el 2026-09-07. Fija una versión en lugar de instalar contenido cambiante de main durante un taller. El contrato de la aplicación y las pruebas pertenecen al estudiante; Spec Kit no es un compilador, un límite de seguridad en tiempo de ejecución ni evidencia de que el código generado funcione.

Un cambio importante respecto a las lecciones importadas

La integración de Copilot de v1.0.4 usa skills de forma predeterminada:

.github/skills/speckit-constitution/SKILL.md
.github/skills/speckit-specify/SKILL.md
.github/skills/speckit-plan/SKILL.md
...
.specify/memory/constitution.md
.specify/templates/
.specify/scripts/

La invocación correspondiente usa un guion, por ejemplo /speckit-specify. La disposición opcional de comandos sigue siendo compatible:

specify init --here --integration copilot --script sh --integration-options="--commands"

Esa disposición genera archivos de agentes, archivos de prompts complementarios y ajustes de VS Code. Sus prompts usan nombres con puntos, como /speckit.specify. Usa una sesión Local para archivos de prompts: las sesiones de Agent Host no los consumen.

[!IMPORTANT] La guía de instalación de v1.0.4 aún ilustra comandos con puntos, mientras que la referencia y el código de integración de Copilot especifican las skills como opción predeterminada. Inspecciona los archivos generados y el selector del host elegido. No mezcles las dos disposiciones ni presupongas que una captura antigua describa la versión instalada.

Instala solo en el directorio de herramientas de la unidad de trabajo

Sigue la configuración de cachés y directorio de herramientas. La versión seleccionada requiere Python 3.11 o posterior y uv para la vía de instalación recomendada.
Si Specify ya está instalado, inspecciona specify version y uv tool list antes de cambiar nada.

Cuando sea necesario instalar, elige una vía revisada:

uv tool install specify-cli --from git+https://github.com/github/spec-kit.git@v1.0.4

La alternativa oficial de PyPI es:

uv tool install specify-cli==1.0.4

Usa el ejecutable del UV_TOOL_BIN_DIR configurado. En ese terminal:
```
export PATH="$UV_TOOL_BIN_DIR:$PATH"
specify version
specify init --help
```
Mostrar una versión es una comprobación de disponibilidad, no evidencia de procedencia del paquete. Registra también el origen de instalación y la versión.

Inicializa una copia del ejercicio, no el contenido formativo

specify init --here --integration copilot --script sh

Usa --script ps en PowerShell. No ejecutes la inicialización en la raíz de Awesome Copilot Adventures. Primero crea una copia desechable, inicializa su línea base local de Git, inspecciona los archivos existentes de .github y .specify y revisa la fusión propuesta. No uses --force para superar conflictos que no hayas inspeccionado.

Spec Kit puede fusionar o actualizar su propia estructura inicial. «Repositorio existente» no es una promesa de que todas las personalizaciones permanezcan idénticas byte por byte.

Flujo de trabajo y puntos de control de evidencia

Skill predeterminada	Artefacto o acción	Verificación humana
`/speckit-constitution`	Principios del proyecto en `.specify/memory/constitution.md`	Reglas aplicables; ninguna implementación ajena al alcance
`/speckit-specify`	Especificación de la función bajo `specs/`	Comportamiento del usuario, IDs, objetivos excluidos y casos límite
`/speckit-clarify`	Resolver requisitos ausentes	Decisiones registradas, sin ampliación silenciosa del alcance
`/speckit-plan`	Diseño técnico y contratos	Pila elegida, interfaces preservadas, pruebas y riesgos
`/speckit-tasks`	Trabajo ordenado por dependencias	Cada requisito tiene una tarea y una comprobación
`/speckit-analyze`	Coherencia entre artefactos	Se resuelve la cobertura ausente o contradictoria
`/speckit-checklist`	Lista de comprobación de calidad de requisitos	La lista no es una batería de pruebas ejecutada
`/speckit-implement`	Implementar las tareas aprobadas	Inspeccionar el diff y la salida real de pruebas
`/speckit-converge`	Comparar el código con especificación, plan y tareas	Verificar independientemente la finalización informada

Inspecciona las rutas reales generadas en lugar de suponer un número de directorio de función. Usa el comando con puntos correspondiente solo si seleccionaste intencionalmente el modo de comandos.

La entrada de ejemplo es lenguaje natural, no un analizador inventado de opciones de línea de comandos:

/speckit-constitution Use requirements.md and the existing baseline tests.
Require deterministic local tests, no secrets, preservation of the public contract,
and one bounded implementation slice at a time.

No presentes --text ni --files como opciones compatibles de estos flujos de agentes. Adjunta los archivos mediante el host o nombra sus rutas en la solicitud.

Tres casos distintos de desarrollo

Caso	Estado inicial	Riesgo principal	Punto de control antes de implementar
Proyecto nuevo	Requisitos y ninguna implementación	Construir demasiado	Contrato de aceptación pequeño y objetivos excluidos explícitos
Función en proyecto existente	Aplicación funcional y pruebas existentes	Romper a los consumidores actuales	Línea base exitosa más nueva prueba de regresión fallida
Modernización	Código y datos existentes y un cambio técnico requerido	Perder compatibilidad o datos	Caracterización, comprobaciones de importación y reversión

Los nombres de los flujos de Spec Kit no hacen idénticos estos casos. El laboratorio de modernización mantiene deliberadamente fijo el comportamiento de negocio mientras cambia el almacenamiento.

Condiciones de detención

Detente tras dos iteraciones de reparación sin éxito, un fallo inexplicado de la línea base, un cambio de dependencias no revisado o una propuesta destructiva. Registra el bloqueo y actualiza el plan. No dejes que un ciclo automático de convergencia se ejecute indefinidamente.