mattpocock/triage

Clasifica incidencias a través de una máquina de estados impulsada por roles de triaje.

¿Qué es triage?

Este skill define un sistema de triaje para incidencias (issues) basado en una máquina de estados, donde distintos roles (triage roles) gestionan el flujo de trabajo. Es útil cuando un usuario desea crear una incidencia, clasificarla, revisar errores o solicitudes de características entrantes, preparar incidencias para un agente AFK (ausente) o gestionar el ciclo de vida de las incidencias. El skill establece roles como 'triage', 'review', 'afk' y 'done', y define transiciones entre estados: desde 'open' hasta 'needs-review', 'in-progress' y 'resolved'. Esto permite que el agente de IA (como Claude Code) pueda asignar automáticamente una incidencia al rol adecuado según su contenido, notificar a los responsables y avanzar la incidencia a través del flujo de trabajo sin intervención manual. Es compatible con plataformas como GitHub y GitLab, y se activa mediante comandos como `/triage` en los comentarios de la incidencia o mediante eventos webhook. La implementación utiliza un archivo `triage-rules.yaml` para definir las reglas de transición y roles, lo que facilita la personalización del comportamiento según las necesidades del proyecto.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/mattpocock/skills/tree/main/skills/triage

Installed? Explore more Productividad y colaboración skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace triage?

Clasifica incidencias a través de una máquina de estados impulsada por roles de triaje. Úse este skill cuando un usuario quiera crear una incidencia, clasificar incidencias, revisar errores o solicitudes de características entrantes, preparar incidencias para un agente AFK o gestionar el flujo de trabajo de incidencias.

Descripción

Este skill implementa un sistema de triaje para incidencias (issues) utilizando una máquina de estados. Los roles definidos son:

  • triage: responsable de la clasificación inicial
  • review: encargado de la revisión técnica
  • afk: para incidencias que requieren atención del agente cuando esté disponible
  • done: finaliza el proceso cuando la incidencia se cierra o resuelve

Estados de la máquina de estados

  • open: incidencia recién creada
  • needs-triage: esperando clasificación
  • needs-review: pendiente de revisión
  • in-progress: en proceso de resolución
  • resolved: resuelta y lista para cerrar

Uso

Este skill se activa cuando:

  • Se crea una nueva incidencia
  • Un usuario comenta /triage en una incidencia
  • Se recibe un webhook de GitHub/GitLab

Configuración

El comportamiento se configura mediante el archivo triage-rules.yaml en la raíz del repositorio. Ejemplo:

roles:
  triage:
    assign: "@triage-team"
    transitions:
      - from: open
        to: needs-triage
  review:
    assign: "@review-team"
    transitions:
      - from: needs-triage
        to: needs-review

Comandos

  • /triage: inicia el flujo de triaje en la incidencia actual
  • /triage assign @usuario: asigna la incidencia a un usuario específico
  • /triage status: muestra el estado actual de la incidencia en el flujo

Notas

  • Las transiciones automáticas pueden personalizarse en triage-rules.yaml
  • Los roles pueden ser equipos o usuarios individuales
  • Las incidencias con etiqueta bug o feature se clasifican automáticamente según las reglas

Ejemplo de flujo

  1. Usuario crea incidencia (estado: open)
  2. El skill detecta la creación y la mueve a needs-triage
  3. El rol triage revisa y asigna a needs-review
  4. El rol review trabaja en ella y la mueve a in-progress
  5. Al cerrar, pasa a resolved

Ver documentación completa en GitHub.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

mattpocock/ask-matt

Ask which skill or flow fits your situation. A router over the skills in this repo.

mattpocock/caveman

Ultra-compressed communication mode. Cuts token usage ~75% by dropping filler, articles, and pleasantries while keeping full technical accuracy. Use when user says "caveman mode", "talk like caveman", "use caveman", "less tokens", "be brief", or invokes /caveman.

mattpocock/claude-handoff

Hand the current conversation off to a fresh background agent that picks up the work immediately.

mattpocock/codebase-design

Shared vocabulary for designing deep modules. Use when the user wants to design or improve a module's interface, find deepening opportunities, decide where a seam goes, make code more testable or AI-navigable, or when another skill needs the deep-module vocabulary.

mattpocock/design-an-interface

Generate multiple radically different interface designs for a module using parallel sub-agents. Use when user wants to design an API, explore interface options, compare module shapes, or mentions "design it twice".

mattpocock/diagnose

Disciplined diagnosis loop for hard bugs and performance regressions. Reproduce → minimise → hypothesise → instrument → fix → regression-test. Use when user says "diagnose this" / "debug this", reports a bug, says something is broken/throwing/failing, or describes a performance regression.

mattpocock/diagnosing-bugs

Diagnosis loop for hard bugs and performance regressions. Use when the user says "diagnose"/"debug this", or reports something broken/throwing/failing/slow.

mattpocock/domain-modeling

Build and sharpen a project's domain model. Use when the user wants to pin down domain terminology or a ubiquitous language, record an architectural decision, or when another skill needs to maintain the domain model.

mattpocock/edit-article

Edit and improve articles by restructuring sections, improving clarity, and tightening prose. Use when user wants to edit, revise, or improve an article draft.

mattpocock/git-guardrails-claude-code

Set up Claude Code hooks to block dangerous git commands (push, reset --hard, clean, branch -D, etc.) before they execute. Use when user wants to prevent destructive git operations, add git safety hooks, or block git push/reset in Claude Code.

mattpocock/grilling

Grill the user relentlessly about a plan or design. Use when the user wants to stress-test a plan before building, or uses any 'grill' trigger phrases.

mattpocock/grill-me

Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".

mattpocock/grill-with-docs

Grilling session that challenges your plan against the existing domain model, sharpens terminology, and updates documentation (CONTEXT.md, ADRs) inline as decisions crystallise. Use when user wants to stress-test a plan against their project's language and documented decisions.

mattpocock/handoff

Compact the current conversation into a handoff document for another agent to pick up.

mattpocock/implement

Implement a piece of work based on a PRD or set of issues.

mattpocock/implement-spec

Implement a specification in code.

mattpocock/improve-codebase-architecture

Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.

mattpocock/loop-me

Grill me about specs for the workflows I want to build, within this workspace.

mattpocock/migrate-to-shoehorn

Migrate test files from `as` type assertions to @total-typescript/shoehorn. Use when user mentions shoehorn, wants to replace `as` in tests, or needs partial test data.

mattpocock/obsidian-vault

Search, create, and manage notes in the Obsidian vault with wikilinks and index notes. Use when user wants to find, create, or organize notes in Obsidian.

Skills relacionados