Sobre el proyecto
Spec Kit es un kit de herramientas de código abierto de GitHub que ayuda a los equipos a usar el Desarrollo Guiado por Especificaciones (SDD) con agentes de codificación de IA. En lugar de tratar las especificaciones como andamiaje desechable, SDD hace que las especificaciones sean ejecutables: generan directamente implementaciones funcionales. El kit proporciona un proceso guiado por especificaciones listo para usar que se puede personalizar o reemplazar con tu propio flujo de trabajo.
El componente principal es Specify CLI, instalado mediante uv o PyPI. Después de ejecutar `specify init`, configura un proyecto e instala comandos slash o habilidades de agente para agentes de codificación de IA comunes. Las integraciones compatibles incluyen más de 30 agentes de codificación basados en CLI e IDE, como Copilot, Codex, Claude Code y otros.
Los comandos slash principales siguen un flujo de trabajo estructurado:
- `/speckit.constitution` — establecer principios del proyecto y pautas de desarrollo
- `/speckit.specify` — definir qué construir (requisitos e historias de usuario)
- `/speckit.plan` — crear un plan de implementación técnica
- `/speckit.tasks` — descomponer el plan en tareas accionables
- `/speckit.taskstoissues` — convertir tareas en issues de GitHub
- `/speckit.implement` — ejecutar tareas para construir la funcionalidad
- `/speckit.converge` — comparar la implementación con la especificación, el plan y las tareas, y agregar el trabajo restante como nuevas tareas
Los comandos opcionales incluyen `/speckit.clarify` para aclarar áreas poco especificadas, `/speckit.analyze` para verificaciones de consistencia entre artefactos y `/speckit.checklist` para listas de verificación de calidad personalizadas.
El repositorio también incluye extensiones opcionales. Una extensión de corrección de errores agrega un flujo de trabajo de evaluar → corregir → probar para correcciones de errores acotadas y basadas en evidencia. Una extensión de evaluación de ideas proporciona un flujo de trabajo de admisión → investigación → definición → modelado → decisión para convertir ideas en bruto en decisiones documentadas de continuar / necesita aclaración / descartar.
La personalización se admite mediante tres mecanismos: las extensiones agregan nuevos comandos y plantillas, los presets anulan cómo se comportan las plantillas y comandos existentes, y los bundles empaquetan conjuntos curados de extensiones, presets, pasos y flujos de trabajo en configuraciones basadas en roles (por ejemplo, product manager, analista de negocio, investigador de seguridad, desarrollador). Las anulaciones locales del proyecto permiten ajustes puntuales. Las plantillas se resuelven en tiempo de ejecución, mientras que los comandos de extensión y preset se aplican en el momento de la instalación.
Spec Kit también incluye comandos de autogestión como `specify self check`, `specify self upgrade --dry-run` y `specify self upgrade`, con opciones para fijar etiquetas de versión específicas. Los recursos de la comunidad incluyen extensiones, presets, bundles, tutoriales y proyectos relacionados en el sitio de documentación. El proyecto se usa a sí mismo: los mantenedores usan Spec Kit al desarrollar Spec Kit, en particular para funcionalidades sustanciales, mediante un flujo de trabajo automatizado de evaluación de funcionalidades.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.