Skip to main content
¿No quieres configurarlo manualmente? Pega un enlace a esta página en una sesión de Devin y pídele que lo configure todo por ti.
1

Escribe una skills de documentación

Empieza creando una skill para la tarea que quieras estandarizar. En este ejemplo, crearemos una skill que genere documentación de API cada vez que un miembro del equipo agregue una etiqueta a un ticket.Ve a Customize > Skills y haz clic en + (New skill). Asígnale el nombre add-docs.Escribe instrucciones paso a paso concretas. Haz referencia a rutas de archivo y convenciones reales para que Devin siga los estándares de tu equipo:Cuanto más específica sea tu skill, mejores resultados obtendrás. Haz referencia a las plantillas de documentación, guías de estilo y herramientas que tu equipo usa realmente. Consulta Cómo escribir una buena skill para obtener más información.
2

Sincronizar la skill con Linear

Conecta tu integración con Linear si aún no lo has hecho: ve a Settings > Connections > Linear y haz clic en Connect. Selecciona los equipos a los que Devin debe tener acceso.Una vez conectada, desplázate hasta Skills y haz clic en Add skill. Selecciona add-docs en el menú desplegable. Así se crea la etiqueta de la skill en Linear, dentro del grupo de etiquetas Devin Skills; la lista de Skills muestra la etiqueta que debes usar (@skills:add-docs si ninguna otra skill sincronizada tiene ese nombre) junto con un botón para copiarla.A partir de ahora, cuando alguien agregue esa etiqueta a un ticket, Devin iniciará una sesión con tu skill.
Para que las etiquetas de skills se sincronicen automáticamente con Linear, tu workspace de Linear debe tener Manage workspace labels configurado en All members (en Settings > Security de Linear). Si no está habilitado, tendrás que crear las etiquetas manualmente en Linear.
3

Etiquetar tickets y generar documentación

Cuando un miembro del equipo agrega la etiqueta @skills:add-docs a un ticket como este:
ENG-215: Add POST /api/v2/webhooks endpoint — accepts a URL and event types, validates the URL is reachable, stores the subscription, and returns the webhook ID.
Devin inicia automáticamente una sesión y sigue tu skill de documentación:
  • Lee el ticket: obtiene la descripción del endpoint, los parámetros y cualquier PR vinculado
  • Localiza el código fuente: encuentra el handler de la ruta, el esquema de validación de la solicitud y los tipos de respuesta
  • Genera la documentación: crea una página nueva en docs/api/ con el mismo formato que ya usas
  • Abre un PR: incluye la nueva página de documentación y la barra lateral actualizada
Esto también funciona bien para operaciones por lotes: selecciona varios tickets con Cmd+A, haz clic derecho y agrega la etiqueta @skills:add-docs para generar la documentación de varios endpoints en paralelo.
Con la Integración con Linear instalada, Devin tiene acceso nativo a las herramientas de Linear, por lo que tu skill puede indicarle a Devin que actualice las etiquetas o el estado del ticket según el resultado. Como las etiquetas pueden activar otras automatizaciones, puedes encadenar flujos de trabajo; p. ej., una vez generada la documentación, una etiqueta Docs Ready podría avisar al redactor técnico para que la revise.
4

Crea más skills para tu equipo

El mismo patrón funciona para cualquier tarea recurrente. Crea una skill, sincronízala como etiqueta y tu equipo podrá activarla desde cualquier ticket. Estas son algunas ideas:
  • @skills:write-tests — Agrega cobertura de pruebas para la funcionalidad descrita en un ticket
  • @skills:refactor — Refactoriza código siguiendo las convenciones de tu equipo
  • @skills:security-audit — Revisa el código en busca de vulnerabilidades de seguridad y abre un PR con las correcciones
  • @skills:migrate — Ejecuta una migración estandarizada (actualización de dependencias, cambio de versión de la API)
También puedes configurar automatizaciones para que Devin empiece a trabajar sin que nadie tenga que aplicar ninguna etiqueta. Ve a Settings > Connections > Linear, desplázate hasta Automations, haz clic en Add automation y configura una automatización que se dispare cuando los tickets pasen a un estado o una etiqueta específicos.