Prerrequisitos para Spec Kit

Python como base del ecosistema

GitHub Spec Kit está escrito en Python y se distribuye como un paquete Python instalable. Esto significa que el primer requisito para trabajar con Spec Kit es tener una versión de Python instalada en el sistema. La versión mínima requerida es Python 3.11, aunque se recomienda instalar la versión estable más reciente disponible.

Para comprobar si Python está instalado y qué versión se tiene, basta con ejecutar en la terminal:

python --version

En algunos sistemas Linux y macOS, el comando puede ser python3 en lugar de python. Si el resultado muestra una versión igual o superior a 3.11, el requisito queda cubierto.

Python 3.11 es la versión mínima porque Spec Kit utiliza funcionalidades del lenguaje introducidas en esa versión, como mejoras en el sistema de tipos y rendimiento del intérprete.

Si Python no está instalado, las opciones de instalación varían según el sistema operativo:

• Windows: descargar el instalador oficial desde python.org y asegurarse de marcar la opción "Add Python to PATH" durante la instalación.
• macOS: usar Homebrew con brew install python o descargar el instalador oficial.
• Linux: la mayoría de distribuciones incluyen Python preinstalado. En caso contrario, usar el gestor de paquetes del sistema (por ejemplo, sudo apt install python3 en Ubuntu/Debian).

El gestor de paquetes uv

uv es un gestor de paquetes y herramientas Python desarrollado por Astral. Es el mecanismo oficial para instalar la CLI de Spec Kit, tanto de forma persistente como para ejecuciones puntuales. uv destaca por su velocidad de resolución de dependencias y su capacidad de gestionar herramientas Python como binarios independientes.

Para instalar uv, el método recomendado depende del sistema operativo:

En macOS y Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh

En Windows (PowerShell):

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Una vez instalado, se puede verificar que uv funciona correctamente:

uv --version

Por qué uv y no pip

Spec Kit utiliza la funcionalidad uv tool install para instalar la CLI como una herramienta aislada en el sistema. A diferencia de pip install, que instala paquetes dentro de un entorno virtual o global, uv tool install crea un entorno aislado dedicado para la herramienta y la expone como un comando disponible en el PATH. Esto evita conflictos de dependencias con otros proyectos Python y garantiza que la CLI de Spec Kit funcione independientemente del entorno Python activo.

uv permite instalar herramientas Python como binarios independientes accesibles desde cualquier directorio, sin contaminar entornos virtuales de otros proyectos.

Git como control de versiones

Git es un requisito fundamental para trabajar con Spec Kit. La herramienta utiliza Git para varias funciones críticas del flujo SDD:

• Feature branching: Spec Kit crea y gestiona ramas Git automáticamente para cada feature especificada. La convención de nombres de ramas sigue el patrón spec/001-nombre-feature.
• Detección de contexto: los slash commands de Spec Kit determinan en qué feature se está trabajando a partir del nombre de la rama Git activa.
• Recuperación ante errores: al tener cada feature en su propia rama, es posible descartar una implementación fallida sin afectar al resto del proyecto.

Para verificar que Git está instalado:

git --version

Si no está instalado, se puede obtener desde git-scm.com o mediante el gestor de paquetes del sistema. Además de tener Git instalado, es recomendable tener configurados al menos el nombre y el correo electrónico:

git config --global user.name "Tu Nombre"
git config --global user.email "tu@email.com"

Esta configuración es necesaria para que los commits que Spec Kit pueda generar durante el flujo de trabajo tengan una autoría válida.

Agentes IA compatibles

Spec Kit no ejecuta código ni genera implementaciones por sí mismo. Su función es estructurar el flujo de trabajo y proporcionar los slash commands que un agente IA ejecuta. Por tanto, es necesario tener instalado y configurado al menos un agente IA compatible.

Agentes CLI

Los agentes de línea de comandos se ejecutan directamente desde la terminal y suelen ofrecer la integración más completa con los slash commands de Spec Kit:

| Agente | Comando de instalación | Directorio de comandos | |---|---|---| | Claude Code | npm install -g @anthropic-ai/claude-code | .claude/commands/ | | Gemini CLI | npm install -g @anthropic-ai/gemini-cli | .gemini/commands/ | | Codex CLI | npm install -g @openai/codex | .codex/commands/ | | Qwen Code | Instalación propia | .qwen/commands/ |

Agentes de IDE

Los agentes integrados en editores de código no requieren instalación independiente, sino que se activan como extensiones del editor:

| Agente | Editor | Directorio de comandos | |---|---|---| | GitHub Copilot | VS Code, JetBrains | .github/agents/ | | Cursor | Cursor IDE | .cursor/commands/ | | Windsurf | Windsurf IDE | .windsurf/workflows/ | | Kilo Code | VS Code | .kilocode/rules/ |

No todos los agentes descubren automáticamente los slash commands de Spec Kit. Claude Code y Copilot ofrecen la integración más completa, mientras que otros agentes pueden requerir invocación manual de los prompts.

Qué agente elegir

La elección del agente depende del flujo de trabajo habitual del desarrollador. Algunas consideraciones prácticas:

• Claude Code es el agente con mejor integración, ya que descubre todos los slash commands de forma nativa y opera desde la terminal con acceso completo al sistema de archivos.
• GitHub Copilot ofrece integración nativa en VS Code a través del directorio .github/agents/, con la ventaja de no requerir herramientas adicionales fuera del editor.
• Cursor funciona bien para desarrolladores que ya utilizan ese IDE como editor principal.
• Gemini CLI es una alternativa de línea de comandos con soporte para los templates de Spec Kit.

No es necesario comprometerse con un solo agente. La arquitectura de Spec Kit permite usar specify init con la opción --ai para generar los archivos de configuración de varios agentes simultáneamente, y cambiar entre ellos según la tarea.

Verificación del entorno

Una vez instalados todos los prerrequisitos, se puede ejecutar una comprobación rápida encadenando los comandos de verificación:

python --version
uv --version
git --version

Los tres comandos deben ejecutarse sin errores y mostrar versiones compatibles. Con Python 3.11+, uv instalado y Git configurado, el entorno está preparado para instalar la CLI de Spec Kit y comenzar a trabajar con Spec-Driven Development.

flowchart LR
    P["Python 3.11+"] --> U["uv"]
    U --> S["Specify CLI"]
    G["Git"] --> S
    A["Agente IA"] --> S

El diagrama muestra las dependencias que convergen en la CLI de Spec Kit: Python y uv como base para la instalación, Git para el control de versiones y feature branching, y un agente IA como interfaz de ejecución de los slash commands.