Skip to main content

​
Descripción General

Personaliza los mensajes que Kody envía al comienzo y al final de las revisiones de código. Esta función te permite adaptar el estilo de comunicación y agregar contexto o instrucciones específicas para tu equipo. En la barra lateral, abre Code review → What Kody writes. Los mensajes están en la sección Comments during the review, con una pestaña por mensaje: Review starts, Review ends y Review fails. Cada pestaña tiene una caja Message y un menú Reset to… (restaura el mensaje heredado, o el mensaje predeterminado en Global).

​
Comportamiento Predeterminado

Cuando no has personalizado ningún mensaje, Kody funciona de la siguiente manera:
  1. Mensaje Inicial: Kody envía un mensaje estándar de inicio de revisión
  2. Sugerencias: Kody proporciona todas las sugerencias de revisión de código
  3. Mensaje Final: Kody actualiza el mensaje inicial con un resumen de la revisión

​
Comportamiento con Mensajes Personalizados

Una vez que editas el mensaje de inicio o de fin de revisión por primera vez, el comportamiento de Kody cambia a:
  1. Mensaje Inicial: Kody envía tu mensaje de inicio de revisión personalizado
  2. Sugerencias: Kody proporciona todas las sugerencias de revisión de código
  3. Mensaje Final: Kody envía tu mensaje de fin de revisión personalizado (sin actualizar el mensaje inicial)
Esto crea una línea de tiempo completa: Mensaje Inicial → Sugerencias → Mensaje Final

​
Opciones de Configuración de Mensajes

​
Post this message

En las pestañas Review starts y Review ends, usa el selector Post this message para decidir cuándo Kody debe publicar ese mensaje (cada mensaje tiene su propio ajuste):
  • Importante: Los mensajes solo se envían cuando realmente se ejecuta una revisión.
    Si tu cadencia de revisión es Manual, los mensajes se publican solo cuando alguien ejecuta @kody start-review.
  • On every push (every_push): se publica cuando se abre el pull request y de nuevo después de cada nuevo push que active una revisión. Esto ocurre automáticamente solo cuando la cadencia es Automática o Auto-pausa.
  • Only when the PR opens (only_when_opened): se publica solo una vez, justo después de la primera ejecución de revisión. Si la cadencia es Manual, la primera ejecución de revisión es cuando llamas a @kody start-review. Los pushes futuros solo agregan sugerencias de revisión más la reacción habitual para que los autores sepan que la revisión volvió a ejecutarse.
  • Never (off): el mensaje no se publica; el texto se conserva para más adelante. Kody aún ejecuta la revisión y publica sugerencias.
Cuando un mensaje está en On every push o Only when the PR opens, Kody usa las plantillas que hayas completado. Si solo personalizas el mensaje de inicio, solo ese mensaje se envía; lo mismo aplica para el mensaje de fin. Esto mantiene la línea de tiempo familiar de Mensaje Inicial → Sugerencias → Mensaje Final siempre que el comportamiento permita publicar mensajes. Ejemplo (cadencia Manual)
PR abierto → sin mensaje aún
@kody start-review → mensaje de inicio → sugerencias → mensaje de fin

​
Contexto Dinámico

Puedes enriquecer tus mensajes personalizados con contexto dinámico usando el menú Add context junto a Message (en las pestañas Review starts y Review ends). Esto te permite incluir:

​
changedFiles

Un resumen de los archivos modificados, mostrando adiciones y eliminaciones por archivo. Proporciona un desglose detallado de lo que se modificó en el pull request.

​
changeSummary

Un resumen exhaustivo de todos los cambios en el pull request, ofreciendo una visión general del alcance completo de las modificaciones.

​
reviewOptions

Un reflejo de la configuración de revisión del equipo, mostrando qué categorías de revisión están habilitadas o deshabilitados para la revisión.

​
reviewCadence

Proporciona la política exacta de revisiones de seguimiento para que los autores sepan qué sucede después de la primera revisión automatizada:
  • Automática: Kody revisa cada push tan pronto como llega.
  • Auto-pausa: Kody revisa los pushes automáticamente, pero si detecta una “ráfaga de pushes” (por ejemplo, 3 pushes en 15 minutos, según tus umbrales) pausa las revisiones de seguimiento hasta que las reanudes. El contexto de cadencia incluye los límites de pushes y tiempo para que el equipo sepa cuándo puede activarse la pausa.
  • Manual: Kody espera a que alguien ejecute @kody start-review antes de hacer otra revisión.

​
reviewScope

Muestra qué nivel de configuración —global, repositorio o directorio— se usó para revisar este pull request, para que los autores sepan qué ajustes se aplicaron.

​
agentPrompt

Solo en el mensaje de fin de revisión. Agrupa las sugerencias de los comentarios de línea de la revisión, que no existen hasta que la revisión se ejecuta, por lo que no se ofrece en el mensaje de inicio.
Agrupa todas las sugerencias de la revisión en un único bloque de prompt para copiar y pegar (mostrado como un desplegable Open Agent Prompt). Pégalo en tu agente de código para aplicar todas las correcciones de la revisión de una vez.
Estas variables de contexto se completarán automáticamente con los datos reales de tu pull request cuando Kody envíe el mensaje.
En kodus-config.yml estos tokens se escriben con prefijo @ — @changedFiles, @changeSummary, @reviewOptions, @reviewCadence, @reviewScope, @agentPrompt — en cualquier posición dentro del content del mensaje. El menú Add context inserta los mismos tokens por ti en la interfaz web.

​
Mensaje de error

Aparte del par inicio/fin, puedes añadir tu propio texto al comentario que Kody publica cuando una revisión falla — por ejemplo cuando no hay proveedor BYOK configurado, o el proveedor rechazó la petición. Escríbelo en la pestaña Review fails. No hay un ajuste de activar/desactivar para este mensaje: el propio texto es el interruptor.
  • Vacío (por defecto) — Kody publica su mensaje de error estándar sin cambios.
  • Completado — tu texto se añade debajo del mensaje de error estándar.
Úsalo para dirigir a la gente al responsable interno o al runbook, en lugar de dejarles un fallo genérico:
Dejar content vacío mantiene el mensaje de error por defecto sin cambios.

​
Visibilidad de comentarios (ajustes globales)

Dos toggles que aplican a todos los comentarios de Kody, no solo a los mensajes personalizados. Están en la sección Comment visibility de What Kody writes:
Siempre puedes volver al comportamiento predeterminado deshabilitando ambos mensajes personalizados o limpiando el contenido del mensaje.