Ejemplos de gestión de issues
Ejemplos paso a paso para flujos de gestión de issues y triaje de proyectos. Cada ejemplo muestra el prompt en lenguaje natural y las acciones de meta-tools que el servidor ejecuta.
Triaje de issues
Sección titulada «Triaje de issues»flowchart LR
A[Ver Issues<br/>Abiertos] --> B[Asignar y<br/>Etiquetar]
B --> C[Vincular Issues<br/>Relacionados]
C --> D[Seguir en<br/>Milestone]
D --> E{Resuelto?}
E -->|Sí| F[Cerrar Issue]
E -->|No| G[Añadir Comentario<br/>y Discutir]
G --> B
style A fill:#3b82f6,color:#fff
style F fill:#22c55e,color:#fff
Ver issues abiertos
Sección titulada «Ver issues abiertos»Prompt: “Muéstrame todos los issues abiertos en el proyecto backend con la etiqueta ‘bug’”
gitlab_issue → action: list, project_id: "my-group/backend", state: "opened", labels: "bug"Devuelve: títulos de issues, autores, etiquetas, milestones, asignados y fechas de creación.
Asignar y etiquetar
Sección titulada «Asignar y etiquetar»Prompt: “Asigna el issue #123 a johndoe y añade las etiquetas ‘priority::high’ y ‘team::backend‘“
gitlab_issue → action: update, project_id: "my-group/backend", issue_iid: 123, assignee_ids: [45], add_labels: "priority::high,team::backend"Triaje masivo por milestone
Sección titulada «Triaje masivo por milestone»Prompt: “Muéstrame todos los issues sin asignar en el milestone Sprint 15”
gitlab_issue → action: list, project_id: "my-group/backend", milestone: "Sprint 15", assignee_id: 0Devuelve: issues sin asignados que necesitan atención antes de que comience el sprint.
Cerrar issues resueltos
Sección titulada «Cerrar issues resueltos»Prompt: “Cierra el issue #456 con un comentario explicando la corrección”
gitlab_issue → action: note_create, project_id: "my-group/backend", issue_iid: 456, body: "Corregido en MR !89 — el timeout era causado por..."gitlab_issue → action: update, project_id: "my-group/backend", issue_iid: 456, state_event: "close"Análisis de issues con IA
Sección titulada «Análisis de issues con IA»Resumir un issue
Sección titulada «Resumir un issue»Prompt: “Resume el issue #234 y todos sus comentarios”
gitlab_summarize_issue (sampling) → lee descripción del issue y todas las notas, produce resumenDevuelve: declaración del problema, puntos clave de discusión, soluciones propuestas, estado actual y bloqueantes.
Encontrar deuda técnica
Sección titulada «Encontrar deuda técnica»Prompt: “Identifica la deuda técnica en los issues del proyecto backend”
gitlab_find_technical_debt (sampling) → analiza patrones de issues, etiquetas y antigüedadDevuelve: elementos de deuda categorizados (calidad de código, brechas de testing, infraestructura, documentación) con calificaciones de severidad.
Vinculación de issues
Sección titulada «Vinculación de issues»Crear issues relacionados
Sección titulada «Crear issues relacionados»Prompt: “Vincula el issue #100 como relacionado al issue #200 en el proyecto backend”
gitlab_issue → action: link_create, project_id: "my-group/backend", issue_iid: 100, target_issue_iid: 200, link_type: "relates_to"Crear relaciones de bloqueo
Sección titulada «Crear relaciones de bloqueo»Prompt: “Marca el issue #300 como bloqueante del issue #400”
gitlab_issue → action: link_create, project_id: "my-group/backend", issue_iid: 300, target_issue_iid: 400, link_type: "blocks"Ver vínculos de issues
Sección titulada «Ver vínculos de issues»Prompt: “Muéstrame todos los issues relacionados al issue #100”
gitlab_issue → action: link_list, project_id: "my-group/backend", issue_iid: 100Devuelve: issues vinculados con tipos de relación (relates_to, blocks, is_blocked_by).
Etiquetas y milestones
Sección titulada «Etiquetas y milestones»Organizar con etiquetas
Sección titulada «Organizar con etiquetas»Prompt: “Crea una etiqueta con ámbito ‘priority::critical’ con color rojo en el proyecto backend”
gitlab_label → action: create, project_id: "my-group/backend", name: "priority::critical", color: "#CC0000"Seguimiento de progreso de milestone
Sección titulada «Seguimiento de progreso de milestone»Prompt: “Muéstrame el progreso del milestone Sprint 15”
gitlab_milestone → action: get, project_id: "my-group/backend", milestone_id: 15Devuelve: porcentaje de completado, conteo de issues abiertos/cerrados, fecha de inicio, fecha límite y días restantes.
Generar informe de milestone
Sección titulada «Generar informe de milestone»Prompt: “Genera un informe detallado para el milestone Q2”
gitlab_generate_milestone_report (sampling) → analiza issues del milestone, MRs y velocidadDevuelve: resumen ejecutivo, métricas de completado, tendencias de velocidad, elementos de riesgo y fecha estimada de finalización.
Discusiones de issues
Sección titulada «Discusiones de issues»Añadir un comentario
Sección titulada «Añadir un comentario»Prompt: “Comenta en el issue #123: ‘Reproducido en staging — el error solo ocurre con peticiones concurrentes‘“
gitlab_issue → action: note_create, project_id: "my-group/backend", issue_iid: 123, body: "Reproducido en staging — el error solo ocurre con peticiones concurrentes"Iniciar una discusión con hilos
Sección titulada «Iniciar una discusión con hilos»Prompt: “Crea un hilo de discusión en el issue #123 sobre la arquitectura propuesta”
gitlab_issue → action: discussion_create, project_id: "my-group/backend", issue_iid: 123, body: "Discutamos la arquitectura propuesta para esta funcionalidad..."Reacciones con emoji
Sección titulada «Reacciones con emoji»Prompt: “Añade una reacción de pulgar arriba al issue #123”
gitlab_issue → action: award_emoji_create, project_id: "my-group/backend", issue_iid: 123, name: "thumbsup"Búsqueda entre proyectos
Sección titulada «Búsqueda entre proyectos»Buscar issues por palabra clave
Sección titulada «Buscar issues por palabra clave»Prompt: “Busca issues que mencionen ‘memory leak’ en todos mis proyectos”
gitlab_search → scope: "issues", search: "memory leak"Devuelve: issues coincidentes en todos los proyectos accesibles con títulos, descripciones y rutas de proyecto.
Buscar dentro de un grupo
Sección titulada «Buscar dentro de un grupo»Prompt: “Encuentra todos los issues abiertos con etiqueta ‘security’ en el grupo platform”
gitlab_issue → action: list, group_id: "platform", state: "opened", labels: "security"Devuelve: issues relacionados con seguridad en todos los proyectos del grupo.