Instalación y Configuración

Requisitos del Sistema

Antes de instalar Spec-Kit, asegúrate de tener:

Requisito	Versión Mínima	Verificar
Python	3.11+	python --version
Git	2.0+	git --version
uv	Última	uv --version

Instalación de uv

uv es un gestor de paquetes Python ultrarrápido escrito en Rust.

macOS / Linux

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

Windows (PowerShell)

irm https://astral.sh/uv/install.ps1 | iex

Verificar Instalación

uv --version

Instalación de Spec-Kit

Instalación Persistente (Recomendada)

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

Esto instala specify como comando global disponible en tu terminal.

Instalación en Proyecto

# Crear entorno virtual
uv venv

# Activar entorno
source .venv/bin/activate  # Linux/macOS
.venv\Scripts\activate     # Windows

# Instalar dependencia
uv pip install \
  git+https://github.com/github/spec-kit.git

Verificar Instalación

specify --help

Configuración con Agentes AI

Spec-Kit funciona mediante comandos slash integrados en agentes AI.

Claude Code

1. Inicia Claude Code en tu proyecto:

claude

2. Usa los comandos slash directamente:

/speckit.constitution

GitHub Copilot

1. Abre tu editor con Copilot habilitado
2. En el chat de Copilot, usa los comandos slash

Cursor

1. Abre Cursor en tu proyecto
2. En el chat AI, usa los comandos slash

Estructura de Carpetas

Spec-Kit crea la siguiente estructura:

proyecto/
├── .spec/
│   ├── constitution.md    # Principios del proyecto
│   ├── specs/             # Especificaciones funcionales
│   │   └── *.md
│   ├── plans/             # Planes técnicos
│   │   └── *.md
│   └── tasks/             # Tareas desglosadas
│       └── *.md
└── src/                   # Código generado

Configuración Opcional

.speckit.yaml

Puedes crear un archivo de configuración:

version: "1.0"

constitution:
  path: ".spec/constitution.md"

specs:
  directory: ".spec/specs"

plans:
  directory: ".spec/plans"

tasks:
  directory: ".spec/tasks"

output:
  directory: "src"

Solución de Problemas

Error: Python no encontrado

# Instalar Python con pyenv
curl https://pyenv.run | bash
pyenv install 3.12
pyenv global 3.12

Error: uv no reconocido

Añade uv al PATH:

export PATH="$HOME/.cargo/bin:$PATH"

Error: specify no encontrado

Reinstala con:

uv tool install --force specify-cli \
  --from git+https://github.com/github/spec-kit.git

Siguiente Paso

→ Capítulo 3: Flujo de Trabajo y Comandos