instgrameMCP
Sitio de historias de Nabil ElNour
Servidor MCP alojado
npx add-mcp 'https://connect.composio.dev/mcp'Se instala en Claude Code, Codex, Cursor y más
Documentación
🌱 Spec Kit
Construye con una especificación, corrige un error o evalúa una idea — con tu agente de codificación.
Spec Kit es un kit de herramientas de código abierto que brinda a los agentes de codificación de IA procesos estructurados, plantillas reutilizables y resultados documentados. Comienza con un proceso listo para usar, personalízalo o trae el tuyo propio.
Elige tu proceso
| Lo que necesitas | Proceso | Resultado |
|---|---|---|
| Construir una función o aplicación | Desarrollo guiado por especificaciones | Una especificación llevada a través de la planificación, implementación y convergencia |
| Diagnosticar y reparar comportamiento defectuoso | Corrección de errores | Una causa evaluada, una corrección delimitada y una verificación registrada |
| Decidir si una idea merece inversión | Evaluación de ideas | Una decisión respaldada por evidencia: avanzar, aclarar o detener |
| Adoptar o crear un proceso diferente | Tu propio proceso | Un proceso adaptado o ensamblado a partir de primitivas reutilizables |
Estos son puntos de entrada independientes, no fases obligatorias. SDD viene incluido en el núcleo; la corrección de errores y la evaluación son extensiones opcionales que instalas cuando las necesitas, y las primitivas a continuación te permiten adoptar o crear otros procesos.
Capacidades
Spec Kit combina procesos listos para usar con mecanismos componibles:
| Capacidad | Mecanismo de Spec Kit |
|---|---|
| Conectarse o cambiar entre agentes de codificación | Integración |
| Añadir un comando, puerta de calidad o proceso completo | Extensión |
| Conectar un proceso a una herramienta o servicio externo | Extensión |
| Reaccionar a eventos del ciclo de vida del agente de codificación | Hook de eventos de extensión |
| Adaptar plantillas, comandos, terminología o metodología | Ajuste preestablecido |
| Aplicar estándares organizativos o regulatorios | Ajuste preestablecido |
| Sobrescribir una plantilla para un proyecto | Sobrescritura local del proyecto |
| Automatizar prompts, comandos, puertas y tareas de shell | Flujo de trabajo |
| Modificar un flujo de trabajo instalado sin bifurcarlo | Superposición de flujo de trabajo |
| Añadir comportamiento ejecutable reutilizable a los flujos de trabajo | Paso de flujo de trabajo |
| Instalar una configuración seleccionada para un rol o equipo | Paquete |
| Descubrir componentes de la comunidad | Catálogo |
| Alojar un catálogo privado de componentes aprobados | Catálogo |
| Acceder a catálogos privados y descargas de componentes | Autenticación |
| Trabajar sin conexión o detrás de un firewall | Fuentes locales y catálogos autoalojados |
| Inspeccionar qué capa proporciona un comando, plantilla o script | Inventario de artefactos |
Busca en los catálogos activos con comandos como specify extension search,
specify preset search, specify workflow search y specify bundle search.
Spec Kit incluye catálogos de la comunidad, y las organizaciones pueden añadir sus propias fuentes seleccionadas. Los listados de catálogos no son auditorías ni respaldos, así que revisa el código fuente de la comunidad antes de instalarlo o ejecutarlo.
Comenzar
Necesitas Python 3.11+, uv, y un agente de codificación de IA compatible en Linux, macOS o Windows. Para configuración solo CLI, ejecuta esto en tu terminal para instalar Spec Kit y crear un proyecto:
uv tool install specify-cli
specify init my-project --integration copilot
cd my-project
Los ejemplos usan el modo de habilidades predeterminado de GitHub Copilot. Reemplaza copilot con
tu clave de integración
para usar otro agente compatible.
¿Ya tienes código? Sigue la guía para proyectos existentes. Para versiones fijas, otros instaladores, CI o solución de problemas, consulta Instalación. Para actualizar una instalación existente, consulta Actualización.
Ahora inicia tu agente de codificación en el directorio del proyecto y elige un proceso
a continuación. Invoca cada habilidad /speckit-* en el chat de tu agente, una a la vez,
y revisa el resultado antes de continuar. Estas son habilidades del agente, no comandos
de terminal. Otros agentes y modos pueden usar
sintaxis de invocación diferente.
Desarrollo guiado por especificaciones
Define qué y por qué antes de decidir cómo construirlo. SDD convierte tus requisitos en una especificación, un plan técnico y tareas accionables, y luego guía la implementación contra esos artefactos.
Constitución una vez por proyecto; especificar → planificar → tareas → implementar → converger por función.
Invoca estas habilidades en el chat de tu agente:
/speckit-constitution Create principles focused on code quality, testing, and maintainability.
/speckit-specify Build a photo organizer with albums grouped by date and a tile preview of each album.
/speckit-plan Use Vite with vanilla JavaScript. Keep images local and store metadata in SQLite.
/speckit-tasks
/speckit-implement
/speckit-converge
Repite implementar → converger hasta que la convergencia informe Converged. Añade aclaraciones, listas de verificación y análisis de consistencia cuando necesites puertas de calidad adicionales.
Tutorial de SDD · Referencia de comandos
Corrección de errores
Mantén el diagnóstico, la reparación y la verificación separados para que el agente corrija la causa evaluada y verifique el síntoma original. No se requiere ningún flujo de trabajo de funciones de SDD primero.
Configuración CLI (terminal): instala la extensión opcional desde el directorio del proyecto:
specify extension add bug
Luego invoca las habilidades evaluar → corregir → probar en el chat de tu agente:
/speckit-bug-assess "Submitting an empty password crashes the login form." slug=login-crash
/speckit-bug-fix slug=login-crash
/speckit-bug-test slug=login-crash
Los informes viven en .specify/bugs/login-crash/. Revisa el veredicto final:
verified, partial o failed. La verificación faltante no es una corrección exitosa.
Tutorial de corrección de errores · Referencia de comandos
Evaluación de ideas
Reúne evidencia antes de comprometerte con una idea, ya sea que se convierta en software o no. Este proceso independiente funciona incluso en un proyecto sin código fuente.
Configuración CLI (terminal): instala la extensión opcional desde el directorio del proyecto:
specify extension add assess
Luego invoca las habilidades recepción → investigación → definir → dar forma → decidir en el chat de tu agente:
/speckit-assess-intake "Let users work offline and sync when they reconnect." slug=offline-mode
/speckit-assess-research slug=offline-mode
/speckit-assess-define slug=offline-mode
/speckit-assess-shape slug=offline-mode
/speckit-assess-decide slug=offline-mode
Los artefactos viven en .specify/assessments/offline-mode/, terminando en una
decisión avanzar / necesita aclaración / detener. Resuelve las incógnitas refinando los
artefactos Markdown existentes directamente o con el agente, en lugar de regenerar
etapas completas. Una decisión de go puede entregarse a /speckit-specify si eliges
construirla; detenerse con una razón documentada también es un resultado útil.
Tutorial de evaluación · Referencia de comandos
Personaliza o trae tu propio proceso
Las extensiones añaden capacidades, los ajustes preestablecidos adaptan el comportamiento existente, los flujos de trabajo automatizan pasos y los paquetes empaquetan una configuración basada en roles. Usa sobrescrituras locales del proyecto para cambios de plantilla puntuales.
Guía de personalización · Extensiones de la comunidad, ajustes preestablecidos, paquetes y tutoriales
Documentación
- Referencia de CLI y comandos de proceso
- Filosofía de SDD, metodología completa y evolución de especificaciones existentes
- Resumen en video e historial del proyecto
- Cómo Spec Kit usa Spec Kit
Historial de estrellas
Gracias a todos los que ayudan a que Spec Kit brille.
Soporte y contribuciones
Reportar un error o solicitar una función · Guía de contribuciones · Código de conducta
Spec Kit tiene licencia MIT.