Skip to main content

Clasificación automática de errores con Linear

Devin investiga automáticamente los errores en cuanto se aplica una etiqueta en Linear.
AuthorCognition
CategoryGestión de proyectos
FeaturesIntegraciones, Playbooks
1

Crea una guía de triaje

La automatización necesita un playbook que le diga a Devin cómo tu equipo hace el triage de bugs: no solo «arregla el bug», sino los pasos específicos que seguiría un ingeniero.Empieza duplicando el !triage playbook de plantilla y personalizándolo para tu stack. O ve a Settings > Playbooks y crea un nuevo playbook con la macro !triage-bug. Aquí tienes un ejemplo:Cuanto más específico sea tu playbook, mejor hará Devin el triage de errores. Haz referencia a los patrones reales de tu equipo: convenciones de registro de errores, frameworks de pruebas, reglas de nomenclatura de ramas. Consulta la documentación de playbooks para más información sobre cómo escribir playbooks eficaces, o usa Advanced Devin para generar un playbook por ti.
Conecta el Datadog MCP (u otros servicios de logging/monitorización) y da a Devin acceso de solo lectura a la base de datos para que pueda revisar logs, métricas y consultar datos como parte de su investigación.
2

Conecta el disparador de la automatización

Ahora conecta el playbook a Linear para que se ejecute automáticamente cuando se le asigne una etiqueta a un bug.
  1. Ve a Settings > Integrations > Linear (primero conecta la integración si aún no lo has hecho — guía de configuración)
  2. En Synced playbook labels, haz clic en Add playbook y selecciona !triage-bug — esto crea una etiqueta correspondiente en el grupo de etiquetas “Devin Playbooks” de Linear
  3. Desplázate hasta Automation triggers y haz clic en Add trigger:
    • Teams: Selecciona el equipo donde se registran los bugs (por ejemplo, “Engineering”)
    • Labels: Selecciona Bug (o la etiqueta que tu equipo use para reportar bugs)
    • Playbook: Selecciona !triage-bug
  4. Guarda el trigger
Los triggers usan edge detection: solo se activan cuando un ticket pasa a cumplir la condición (por ejemplo, cuando alguien agrega la etiqueta Bug), no para tickets que ya la tienen. Esto significa que no activarás Devin por accidente en todo tu backlog existente.
Para que las etiquetas de playbooks se sincronicen automáticamente con Linear, tu espacio de trabajo de Linear debe tener Manage workspace labels configurado como All members (se encuentra en Settings > Security de Linear). Si eso no está habilitado, tendrás que crear las etiquetas manualmente en Linear.
3

Etiqueta un error y observa cómo Devin lo investiga

Cuando un ingeniero agrega la etiqueta Bug a un ticket de Linear como este:
ENG-487: Los usuarios ven un error 500 al enviar el formulario de contacto en /contact. Empezó después del despliegue del viernes pasado. El stack trace apunta a validateEmail() en src/lib/forms.ts.
Devin inicia automáticamente una sesión y sigue tu playbook de triaje:
  • Lee el ticket — extrae el título, la descripción y cualquier comentario en Linear
  • Busca en la base de código — encuentra src/lib/forms.ts, el controlador de la ruta en src/routes/contact.ts y las pruebas de validación del formulario
  • Revisa los cambios recientes — ejecuta git log --since="last Friday" -- src/lib/forms.ts y detecta un commit que refactorizó la expresión regular del email
Los hallazgos de Devin se sincronizan automáticamente de vuelta al ticket de Linear mediante la integración. Todo esto sucede sin que nadie asigne el ticket a Devin: solo la etiqueta desencadena todo el flujo de trabajo.
Con la integración de Linear instalada, Devin tiene acceso nativo a las herramientas de Linear, por lo que tu playbook puede instruir a Devin para actualizar las etiquetas de los tickets según sus hallazgos. Por ejemplo, tu playbook de triaje podría indicar a Devin que agregue una etiqueta Clear Fix, Needs Review o Lacking Context según el resultado. Dado que las etiquetas pueden activar otras automatizaciones, puedes encadenar flujos de trabajo; por ejemplo, una etiqueta Clear Fix podría iniciar una segunda sesión de Devin que escriba la corrección.
4

Optimiza el ciclo

Después de algunas triages, perfecciona el sistema en función de lo que Devin hace bien y de dónde necesita más orientación.Mejora el playbook basándote en sesiones reales. Si Devin omite sistemáticamente algo (por ejemplo, no revisar los logs o pasar por alto un servicio relacionado), añade ese paso a tu playbook de !triage-bug. Puedes usar Advanced Devin para analizar sesiones anteriores y mejorar automáticamente tu playbook o crear entradas de Knowledge para patrones que Devin deba seguir en todas las sesiones, como “siempre revisa primero el panel de seguimiento de errores” o “nuestros logs del servicio de auth están en CloudWatch, no en Datadog.”Añade un playbook de corrección cuando estés listo. Una vez que confíes en el triage de Devin, crea un segundo playbook como !fix-bug que vaya más lejos: escribir una corrección, añadir una prueba de regresión y abrir un PR. Asígnalo a una etiqueta independiente para que tu equipo pueda elegir entre “solo dime qué está mal” y “arréglalo por mí”: