create-github-issues-for-unmet-specification-requirements

Acerca de create-github-issues-for-unmet-specification-requirements

Esta habilidad automatiza la creación de incidencias de GitHub para los requisitos de un archivo de especificación que aún no se han implementado en la base de código. Resuelve la brecha entre las especificaciones escritas y el código entregado convirtiendo sistemáticamente los requisitos no cumplidos en incidencias rastreables y accionables, reduciendo la posibilidad de que las necesidades documentadas se pierdan silenciosamente.

El flujo de trabajo es compacto: analiza el archivo de especificación para extraer todos los requisitos, verifica la base de código para determinar el estado de implementación de cada requisito, busca las incidencias existentes (vía search_issues) para evitar duplicados y crea una nueva incidencia por cada requisito no implementado (vía create_issue) utilizando la plantilla feature_request.yml del repositorio, recurriendo a la plantilla predeterminada cuando esta no está presente. Se espera que cada incidencia contenga un ID de requisito y una descripción claros, orientación sobre la implementación y criterios de aceptación, con etiquetas como feature o enhancement según corresponda. La verificación de implementación incluye buscar patrones de código relacionados en la base de código, revisar archivos de especificación relacionados bajo un directorio /spec/ y verificar que un requisito no se haya implementado parcialmente.

Se dirige a desarrolladores, líderes técnicos y mantenedores de proyectos que trabajan con documentos de especificación y desean mantener su gestor de incidencias sincronizado con los requisitos no cumplidos. Los casos de uso típicos incluyen la inicialización de un backlog a partir de una nueva especificación, la conciliación de una especificación frente a una base de código existente y la garantía de que cada requisito tenga una incidencia rastreable. Este es un flujo de trabajo ligero de lectura y creación: lee la especificación y el código, y escribe incidencias de GitHub mediante herramientas estándar, sin operaciones destructivas, manejo de credenciales ni ejecución de código, lo que lo convierte en una opción de bajo riesgo.

Preguntas frecuentes

¿Qué produce esta habilidad?

Una incidencia de GitHub por cada requisito no implementado encontrado en la especificación, cada una con un ID de requisito y descripción, orientación sobre la implementación, criterios de aceptación y etiquetas apropiadas como feature o enhancement.

¿Cómo evita crear incidencias duplicadas?

Antes de crear incidencias, busca las incidencias existentes (utilizando search_issues) y verifica que cada requisito no se haya implementado o implementado parcialmente en la base de código.

¿Qué plantilla de incidencia utiliza?

Utiliza la plantilla feature_request.yml del repositorio y recurre a la plantilla predeterminada si esta no está disponible.

¿Cómo determina si un requisito está implementado?

Busca patrones de código relacionados en la base de código y revisa los archivos de especificación relacionados bajo un directorio /spec/ para evaluar el estado de implementación.

¿Proporciono yo el archivo de especificación?

Sí. La habilidad opera sobre un archivo de especificación que le indicas, extrayendo todos los requisitos de este antes de verificar el estado de implementación.