triage

Descripción general de la skill de triage

Qué hace triage

triage es una skill de triage de issues de GitHub para mover los issues entrantes a través de una máquina de estados basada en roles. Te ayuda a clasificar reportes, decidir si hace falta más información y derivar el trabajo a un agente AFK o a un mantenedor humano. Si necesitas una skill de triage para Issue Tracking, está pensada para reducir las dudas y mantener un manejo coherente de los issues.

Para quién encaja mejor

Usa la skill de triage si gestionas una cola de issues muy activa, quieres un proceso de entrada repetible o necesitas una forma estructurada de convertir reportes de errores desordenados en trabajo accionable. Es especialmente útil cuando necesitas separar bug de enhancement y luego mover cada issue a needs-triage, needs-info, ready-for-agent, ready-for-human o wontfix.

Qué la diferencia

El principal diferenciador es la máquina de estados explícita junto con la disciplina de roles. La skill no se limita a “resumir el issue”; espera exactamente un rol de categoría y un rol de estado, e incluye un requisito estricto de que todo comentario de triage o mensaje del issue empiece con un aviso de divulgación. Eso importa si necesitas resultados predecibles, enrutamiento consciente de políticas y un flujo de triage que pueda entregarse sin fricción a otro agente.

Cómo usar la skill de triage

Instala y lee primero

Instálala con:

npx skills add mattpocock/skills --skill triage

Para la instalación de triage, empieza por SKILL.md y después lee AGENT-BRIEF.md y OUT-OF-SCOPE.md. Esos archivos explican el formato persistente del brief y cómo se registran las ideas rechazadas, que son las dos partes con más probabilidades de afectar la calidad real del triage. El repo no incluye scripts auxiliares ni carpetas extra de referencia, así que esos tres archivos son el núcleo práctico.

Dale a la skill la entrada correcta

El uso de triage funciona mejor cuando le pasas el título del issue, el cuerpo, cualquier etiqueta existente y el objetivo exacto de la pasada de triage. Las entradas sólidas le indican a la skill si quieres clasificación, más información, un brief para agente o una decisión final de rechazo.

Forma recomendada del prompt:

• “Haz triage de este issue de GitHub. Clasifícalo como bug o enhancement, elige el rol de estado correcto y di si debe ir a un agente AFK o quedarse con un humano.”
• “Aquí está el hilo del issue y las etiquetas actuales. Aplica la máquina de estados de triage y redacta el comentario con el aviso obligatorio.”
• “Esto parece insuficientemente especificado. Determina si pertenece a needs-info o ready-for-agent y explica qué criterios de aceptación faltan.”

Usa el flujo de trabajo, no solo la etiqueta

Una guía práctica de triage es tratar la salida como enrutamiento, no como taxonomía. Primero confirma si el issue es un bug o una mejora. Luego comprueba si es accionable, si está bloqueado por información del reportero o si está explícitamente fuera de alcance. Si está listo para trabajo de agente, el brief debe describir expectativas de comportamiento y criterios de aceptación, no rutas de archivo ni pasos de implementación.

Ten en cuenta las reglas del repositorio

Dos detalles afectan de forma material la calidad de la salida: el requisito del aviso y la regla de “exactamente un rol de categoría más un rol de estado”. Si el estado del issue es ambiguo, la skill indica que debes marcar el conflicto y preguntar al mantenedor antes de cambiar nada más. Ese es el momento correcto para parar y aclarar en lugar de forzar una etiqueta.

Preguntas frecuentes sobre triage

¿Triage es solo para etiquetas de issues de GitHub?

No. La skill está construida alrededor del seguimiento de issues al estilo GitHub, pero su función principal es decidir el estado del issue y enrutar el trabajo. Si tu tracker usa cadenas de etiquetas distintas, los roles canónicos siguen importando y debes mapearlos a tu sistema antes de actuar.

¿La necesito si puedo escribir un prompt normal?

Un prompt normal puede clasificar un issue, pero la skill de triage añade un modelo de estados repetible, un patrón para redactar briefs y un manejo explícito de lo que queda fuera de alcance. Eso es valioso cuando quieres decisiones coherentes en muchos issues, no resúmenes puntuales.

¿Triaged es apta para principiantes?

Sí, si ya entiendes las etiquetas básicas de issues. La skill de triage es más fácil de usar que escribir un prompt de política a medida porque te dice qué estados existen y qué significa cada transición. El error de principiante más común es omitir el contexto del issue y pedir una etiqueta sin cuerpo, sin discusión y sin estado actual.

¿Cuándo no debería usar triage?

No uses triage para planificación profunda de implementación ni para revisión de código. Es para entrada, enrutamiento y decisiones de preparación. Si el issue ya tiene una especificación completa y necesitas ayuda de diseño o codificación, encaja mejor otra skill o un prompt directo de implementación.

Cómo mejorar la skill de triage

Aporta más contexto del issue

La skill de triage mejora cuando incluyes el cuerpo completo del issue, los comentarios visibles, las etiquetas actuales y cualquier nota del mantenedor. Un título aislado suele llevar a un enrutamiento débil porque la skill no puede saber si el reporte es reproducible, si ya fue respondido o si le faltan datos clave.

Pide la decisión que realmente necesitas

Si tu objetivo es “ready for agent”, dilo así. Si tu objetivo es “should this be closed as wontfix”, indícalo directamente. El mejor uso de triage es específico sobre el límite de decisión, porque así la skill puede optimizar para el estado correcto en lugar de producir un resumen genérico.

Mejora la calidad del traspaso

Cuando un issue se mueve a ready-for-agent, pide un agent brief que exponga el comportamiento, las restricciones y los criterios de aceptación en un lenguaje persistente. Evita pedir instrucciones de implementación a nivel de archivo salvo que de verdad las necesites; la guía del repositorio favorece contratos de comportamiento porque sobreviven mejor a los cambios del código.

Itera sobre la primera pasada

Si la primera pasada de triage es demasiado tentativa, afínala con una de estas tres adiciones: pasos para reproducir, comportamiento esperado frente a comportamiento real, o por qué el issue importa para los usuarios. Esos detalles suelen decidir si el issue pertenece a needs-info, ready-for-human o wontfix, y hacen que la skill de triage sea más resolutiva en la segunda pasada.