Preparar el entorno de GitHub Spec Kit

Se conserva el nombre del archivo para los enlaces entrantes. El producto es GitHub Spec Kit, no «GitHub Dev Kit». C# Dev Kit es una extensión de VS Code independiente.

Resumen del laboratorio

[!NOTE] Un CLI instalado no es evidencia de que el host seleccionado haya descubierto sus skills.

Conceptos · Primera tarea · Lista de evidencias · Restablecer

Objetivos de aprendizaje

• Fija y verifica Specify CLI y su integración.
• Distingue el modo de skills de la disposición opcional de comandos.
• Evita sobrescribir la personalización de un proyecto existente.

Antes de empezar

Lee los límites del entorno y los recursos y la referencia de Spec Kit con versión etiquetada. Elige una pila de aplicación. SQL Server LocalDB no es un requisito: el itinerario local usa contratos de Node/TypeScript y la compatibilidad con SQLite incluida en Python.

Conceptos y casos de uso

Specify instala la estructura inicial del flujo de trabajo. Un agente de programación con IA consume esa estructura. La aplicación funciona sobre el entorno de ejecución que elijas en el plan. Instalar una CLI de Python no exige que tu aplicación esté escrita en Python.

Escenario del ejercicio

Prepararás un proyecto para un ejercicio de proyecto nuevo, proyecto existente o modernización. El propósito es el descubrimiento y un diff de inicialización seguro, no la implementación.

Tarea 1 - Verificar las herramientas antes de instalar

1. Inspecciona Git, el entorno de ejecución seleccionado para la aplicación, Python y uv.
2. Configura las cachés y las rutas de herramientas en tu unidad de trabajo usando la configuración compartida.
3. Comprueba si ya existe una instalación de Specify. Instala v1.0.4 solo cuando sea necesario, mediante una de las vías documentadas en la referencia.
4. Registra specify version, el origen de instalación y specify init --help.
5. No pegues una transcripción de versión de ejemplo como si procediera de tu máquina.

Tarea 2 - Seleccionar la integración

1. Elige la disposición predeterminada de skills de Copilot para este itinerario.
2. Inspecciona los archivos .github/skills/speckit-*/SKILL.md generados tras la inicialización.
3. Verifica que el host seleccionado descubra /speckit-constitution y /speckit-specify. Las skills son capacidades pertinentes, no nuevos roles de agente obligatorios.
4. Si eliges intencionalmente --integration-options="--commands", usa Local para sus archivos de prompts y los comandos generados con puntos. Registra esa elección.

Tarea 3 - Inicializar sin sobrescribir

1. Prepara el fixture del laboratorio 13, 14 o 17 en un directorio sin usar.

2. Abre únicamente esa copia y registra un commit de referencia de Git.

3. Inspecciona .github, .specify y la configuración del editor existentes.

4. Ejecuta:

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

5. Revisa la confirmación de directorio no vacío y el diff resultante. Si la inicialización propone sustituir un archivo que necesitas, detente y resuelve el conflicto deliberadamente.

6. En Windows elige --script ps; no ejecutes un instalador remoto con omisión de políticas ni desactives la validación de certificados para eludir los controles de la organización.

Verifica tu trabajo

• La versión y el origen de instalación están registrados.
• La integración se descubre realmente en el espacio de trabajo y host elegidos.
• Los archivos generados coinciden con la disposición seleccionada de skills o comandos.
• La aplicación original y las pruebas de referencia permanecen sin cambios.
• No se requirió ninguna base de datos, suscripción, identidad global ni repositorio público.

Solución de problemas

Práctica independiente

Compara los archivos generados por los modos de skills y comandos en dos proyectos de prueba separados. Explica cuáles son portables y cuáles son específicos del host.

Restablecimiento

Cierra el espacio de trabajo de prueba. Conserva el diff de inicialización y elimina únicamente esa copia de prueba cuando ya no sea necesaria. No desinstales herramientas compartidas usadas por otros laboratorios.

Referencias oficiales

• Instalación de Spec Kit v1.0.4
• Integración con Copilot
• Archivos de prompts en VS Code
• Agent Skills