/issue-templates

name: issue-templates
description: "Generar templates de issues para bug reports y feature requests"

Generar templates de issues

Resumen

Este skill genera plantillas de issues en formato YAML para GitHub, listas para colocar en `.github/ISSUE_TEMPLATE/`. Las plantillas estandarizan la informacion que reciben los mantenedores, lo que reduce el ir y venir de preguntas y acelera la resolucion de bugs y la evaluacion de nuevas funcionalidades.

Se generan dos plantillas: una para reportes de errores y otra para solicitudes de funcionalidad. Ambas usan el formato YAML nativo de GitHub, que permite campos estructurados con validacion.

Proceso

1. **Crear la estructura de directorios.** Verificar que existe `.github/ISSUE_TEMPLATE/`. Si no existe, crearla. Si ya hay plantillas previas, revisarlas con el usuario antes de sobreescribir.

2. **Generar la plantilla de bug report.** Crear `.github/ISSUE_TEMPLATE/bug_report.yml` con los siguientes campos:

• **name**: "Reporte de error"
• **description**: descripcion breve del proposito de la plantilla.
• **title**: prefijo `[Bug]: ` para facilitar el filtrado.
• **labels**: asignar automaticamente la etiqueta `bug`.
• **body**: formulario con los campos:
• Descripcion del error (textarea, obligatorio).
• Pasos para reproducir (textarea, obligatorio): instrucciones numeradas que permitan replicar el problema de forma consistente.
• Resultado esperado (textarea, obligatorio).
• Resultado actual (textarea, obligatorio).
• Entorno (dropdown o campos de texto): sistema operativo, navegador/runtime, version de la aplicacion.
• Capturas de pantalla o logs (textarea, opcional).

3. **Generar la plantilla de feature request.** Crear `.github/ISSUE_TEMPLATE/feature_request.yml` con los siguientes campos:

• **name**: "Solicitud de funcionalidad"
• **description**: descripcion breve del proposito de la plantilla.
• **title**: prefijo `[Feature]: `.
• **labels**: asignar automaticamente la etiqueta `feature`.
• **body**: formulario con los campos:
• Descripcion del problema (textarea, obligatorio): que situacion motiva esta solicitud.
• Solucion propuesta (textarea, obligatorio): como deberia funcionar la funcionalidad deseada.
• Alternativas consideradas (textarea, opcional): otras opciones que se han valorado y por que no son suficientes.
• Contexto adicional (textarea, opcional): capturas, mockups, enlaces o cualquier informacion complementaria.

4. **Crear el fichero de configuracion.** Opcionalmente, crear `.github/ISSUE_TEMPLATE/config.yml` para controlar el comportamiento del selector de plantillas:

• Desactivar issues en blanco si se quiere forzar el uso de plantillas.
• Anadir enlaces externos (foro, documentacion) como opciones de contacto alternativas.

5. **Verificar el resultado.** Comprobar que las plantillas se renderizan correctamente navegando a la pagina de creacion de issues del repositorio. Verificar que los campos obligatorios impiden enviar el formulario incompleto.

Que NO hacer

• No generar plantillas excesivamente largas: cuantos mas campos obligatorios, menos probable es que el usuario reporte un bug.
• No usar el formato Markdown antiguo (.md) si el repositorio soporta el formato YAML (.yml), ya que este ultimo ofrece validacion de campos.
• No incluir campos que no se vayan a usar para tomar decisiones.
• No olvidar asignar labels automaticas: ahorran tiempo en el triaje.