Communitygithub.com

Lev-it/lev-skills

Mueve issues a través de una máquina de estados con roles de triaje: categoriza, reproduce, refina si es necesario y escribe briefs listos para agentes.

¿Qué es lev-skills?

Esta skill implementa un proceso de triaje automatizado para issues en el rastreador de issues del proyecto, utilizando una máquina de estados con roles específicos. Permite categorizar issues como 'bug' o 'mejora' y asignar estados como 'needs-triage', 'needs-info', 'ready-for-agent', 'ready-for-human' o 'wontfix'. Es útil para equipos que gestionan múltiples issues y necesitan un flujo de trabajo consistente y eficiente, asegurando que cada issue esté correctamente evaluado antes de ser delegado a un agente automático o a un desarrollador humano. La skill se invoca mediante el comando `/triage` y guía al mantenedor a través de la recopilación de contexto, reproducción (solo para bugs), refinamiento mediante grilling, y la aplicación del resultado correspondiente, incluyendo la generación de briefs para agentes. Soporta plataformas compatibles con skills de IA como Claude Code, Cursor y Codex.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Lev-it/lev-skills/tree/HEAD/.claude/skills/triage

Preguntar en tu IA favorita

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

Documentación

Triage

Mueve los issues del rastreador de issues del proyecto a través de una pequeña máquina de estados con roles de triaje.

Cada comentario o issue publicado en el rastreador durante el triaje debe comenzar con este descargo de responsabilidad:

> *Esto fue generado por IA durante el triaje.*

Documentos de referencia

Roles

Dos roles de categoría:

  • bug — algo está roto
  • enhancement — nueva funcionalidad o mejora

Cinco roles de estado:

  • needs-triage — el mantenedor necesita evaluarlo
  • needs-info — esperando que el reportero proporcione más información
  • ready-for-agent — completamente especificado, listo para un agente AFK
  • ready-for-human — necesita implementación humana
  • wontfix — no se va a aplicar

Cada issue triaje debe llevar exactamente un rol de categoría y un rol de estado. Si hay conflictos entre roles de estado, márcalo y pregunta al mantenedor antes de hacer cualquier otra cosa.

Estos son nombres canónicos de roles — las etiquetas reales en el rastreador de issues pueden diferir. Deberías tener el mapeo disponible; si no, ejecuta /setup-matt-pocock-skills.

Transiciones de estado: un issue sin etiqueta normalmente va a needs-triage primero; desde allí pasa a needs-info, ready-for-agent, ready-for-human o wontfix. needs-info vuelve a needs-triage cuando el reportero responde. El mantenedor puede anular en cualquier momento — señala transiciones que parezcan inusuales y pregunta antes de proceder.

Invocación

El mantenedor invoca /triage y describe lo que quiere en lenguaje natural. Interpreta la solicitud y actúa. Ejemplos:

  • "Muéstrame todo lo que necesita mi atención"
  • "Veamos el #42"
  • "Mueve el #42 a ready-for-agent"
  • "¿Qué está listo para que los agentes lo tomen?"

Mostrar lo que necesita atención

Consulta el rastreador de issues y presenta tres grupos, del más antiguo al más reciente:

  1. Sin etiqueta — nunca triaje.
  2. needs-triage — evaluación en curso.
  3. needs-info con actividad del reportero desde las últimas notas de triaje — necesita reevaluación.

Muestra recuentos y un resumen de una línea por issue. Deja que el mantenedor elija.

Triaje de un issue específico

  1. Recopila contexto. Lee el issue completo (cuerpo, comentarios, etiquetas, reportero, fechas). Analiza cualquier nota de triaje anterior para no volver a preguntar lo ya resuelto. Explora el código usando el glosario de dominio del proyecto, respetando las ADR en el área. Lee .out-of-scope/*.md y resalta cualquier rechazo previo que se parezca a este issue.

  2. Recomienda. Informa al mantenedor tu recomendación de categoría y estado con razonamiento, además de un breve resumen del código relevante para el issue. Espera instrucciones.

  3. Reproduce (solo bugs). Antes de cualquier refinamiento, intenta la reproducción: lee los pasos del reportero, rastrea el código relevante, ejecuta pruebas o comandos. Reporta qué ocurrió: reproducción exitosa con ruta de código, reproducción fallida, o detalles insuficientes (una fuerte señal de needs-info). Una reproducción confirmada hace un brief mucho más robusto para el agente.

  4. Refina (si es necesario). Si el issue necesita más detalle, ejecuta las skills /grilling y /domain-modeling juntas — refina el issue una pregunta a la vez, afinando los términos del dominio y actualizando CONTEXT.md/ADR a medida que se toman decisiones.

  5. Aplica el resultado:

    • ready-for-agent — publica un comentario con un brief para agente (AGENT-BRIEF.md).
    • ready-for-human — misma estructura que un brief para agente, pero indica por qué no se puede delegar (juicios subjetivos, acceso externo, decisiones de diseño, pruebas manuales).
    • needs-info — publica notas de triaje (plantilla a continuación).
    • wontfix (bug) — explicación educada y luego cierra.
    • wontfix (mejora) — escribe en .out-of-scope/, enlázalo desde un comentario y luego cierra (OUT-OF-SCOPE.md).
    • needs-triage — aplica el rol. Comentario opcional si hay avance parcial.

Anulación rápida de estado

Si el mantenedor dice "mueve el #42 a ready-for-agent", confía en él y aplica el rol directamente. Confirma lo que vas a hacer (cambios de rol, comentario, cierre) y luego actúa. Omite el refinamiento. Si mueves a ready-for-agent sin una sesión de refinamiento, pregunta si quieren escribir un brief para agente.

Plantilla para needs-info

## Notas de Triaje

**Lo que hemos establecido hasta ahora:**

- punto 1
- punto 2

**Lo que aún necesitamos de ti (@reporter):**

- pregunta 1
- pregunta 2

Captura todo lo resuelto durante el refinamiento bajo "establecido hasta ahora" para no perder el trabajo. Las preguntas deben ser específicas y accionables, no "proporcione más información".

Reanudar una sesión anterior

Si existen notas de triaje previas en el issue, léelas, verifica si el reportero ha respondido alguna pregunta pendiente y presenta una imagen actualizada antes de continuar. No vuelvas a preguntar lo ya resuelto.

Individual skills in this repo

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

Lev-it/lev-skills

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

Lev-it/lev-skills

Premium brand-kit image generation skill for creating high-end brand-guidelines boards, logo systems, identity decks, and visual-world presentations. Trained for minimalist, cinematic, editorial, dark-tech, luxury, cultural, security, gaming, developer-tool, and consumer-app brand systems. Optimized for intentional logo concepting, refined composition, sparse typography, strong symbolic meaning, premium mockups, art-directed imagery, and flexible grid layouts.

Lev-it/lev-skills

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

Lev-it/lev-skills

Ink terminal renderer for json-render that turns JSON specs into interactive terminal UIs. Use when working with @json-render/ink, building terminal UIs from JSON, creating terminal component catalogs, or rendering AI-generated specs in the terminal.

Lev-it/lev-skills

Interactive QA session where user reports bugs or issues conversationally, and the agent files GitHub issues. Explores the codebase in the background for context and domain language. Use when user wants to report bugs, do QA, file issues conversationally, or mentions "QA session".

Lev-it/lev-skills

Facilitate a structured sprint retrospective — what went well, what didn't, and prioritized action items with owners and deadlines. Use when running a retrospective, reflecting on a sprint, creating action items from team feedback, or learning how to run effective retros.

Lev-it/lev-skills

Review the changes since a fixed point (commit, branch, tag, or merge-base) along two axes — Standards (does the code follow this repo's documented coding standards?) and Spec (does the code match what the originating issue/PRD asked for?). Runs both reviews in parallel sub-agents and reports them side by side. Use when the user wants to review a branch, a PR, work-in-progress changes, or asks to "review since X".

Lev-it/lev-skills

Test-driven development. Use when the user wants to build features or fix bugs test-first, mentions "red-green-refactor", or wants integration tests.

Lev-it/lev-skills

Teach the user a new skill or concept, within this workspace.

Lev-it/lev-skills

Turn the current conversation into a PRD and publish it to the project issue tracker — no interview, just synthesis of what you've already discussed.

Lev-it/lev-skills

Create product backlog items in Why-What-Acceptance format — independent, valuable, testable items with strategic context. Use when writing structured backlog items, breaking features into work items, or using the WWA format.

Skills relacionados