Una revisión que comenta todo se silencia
Una buena revisión de pull request deja tres comentarios, no treinta. Si un revisor automatizado señala cada desviación, el equipo las salta, y el comentario importante se pierde entre los demás.
Para decidir qué casos merecen un comentario, necesitas las convenciones de código que tu equipo hace cumplir, las que está dispuesto a tolerar y las partes del codebase donde un cambio pequeño igual puede importar. El contexto también importa. Un test faltante para un endpoint experimental y uno para la ruta de facturación son el mismo tipo de problema, con un peso muy distinto.
El agent deja comentarios que enuncian un punto y luego se detienen. No aprueba, no fusiona ni bloquea revisiones. Un humano que ya tiene nombre a cargo corre la revisión.
Cómo se construye el agent en Agent Studio
Los prompt skills enuncian los criterios que tu equipo aplica en las revisiones: las reglas que haces cumplir, no una guía de estilo, y las convenciones que decidiste de propósito no vigilar.
Un segundo prompt skill destaca las áreas sensibles del codebase, como facturación, autenticación y migración de datos. El peso varía según dónde se hace un cambio, por esas áreas.
El system prompt limita el número de comentarios y exige que se ordenen. El agent tiene que elegir qué importa, no producir una lista completa.
Un comentario debe enunciar la consecuencia, no solo la desviación. Si solo dice que se podría haber omitido una convención, es ruido. Si dice que esta ruta ahora se puede usar dos veces, es una revisión.
Un trigger Webhook recibe eventos de pull request. El nodo GitHub pasa el diff, el issue relacionado y el historial reciente del archivo al nodo Agent Chat.
El nodo GitHub publica los comentarios de vuelta como comentarios de revisión asignados al agent, para que no se traten como si vinieran de un colega.
El agent no fusiona ni aprueba ningún cambio, y no bloquea ninguno. Cuando se publica un comentario, cualquier ítem que involucre un área sensible se envía a un revisor designado.
De qué está hecho este agent
- Prompt skills: lo que tu equipo hace cumplir y lo que decidió no vigilar.
- Prompt skills: las áreas sensibles donde un cambio pequeño carga peso.
- System prompt: un conjunto de comentarios limitado y ordenado, no una salida exhaustiva.
- System prompt: cada comentario enuncia la consecuencia, no la desviación.
- Webhook (Triggers) con GitHub (Integration): el diff, el issue vinculado y el historial reciente del archivo.
- Agent Chat (Util): comentarios publicados atribuidos al agent. Sin fusión, sin aprobación, sin bloqueo.
- Cuando un ActionFlow basta: Si solo necesitas comprobar que existen tests, un issue vinculado y una descripción, construye el flujo de trabajo. Esa comprobación quita la fricción de revisión más común.
Preguntas frecuentes
Empieza a crear flujos de IA
Crea una cuenta gratuita, abre una plantilla o un lienzo en blanco y ejecuta tu primer ActionFlow.
Boletín
Recibe actualizaciones del producto
Nodos nuevos, agents y notas de producto. Solo enviamos correo cuando merece la pena abrirlo.