Skip to main content
Los Prompts Personalizados te dan control total sobre cómo Kody analiza tu código y comunica los hallazgos. Personaliza qué busca la IA en cada categoría de revisión y cómo presenta las sugerencias para que coincidan con los estándares y el estilo de comunicación de tu equipo.

Acceder a la Configuración de Prompts Personalizados

Configura tus prompts personalizados para todos los repositorios de tu organización

¿Por Qué Usar Prompts Personalizados?

Estándares Específicos del Equipo

Alinea las revisiones de Kody con los estándares de codificación únicos de tu equipo, patrones arquitectónicos y mejores prácticas

Optimización del Modelo

Crea prompts optimizados para las fortalezas de tu modelo de IA específico al usar BYOK

Control del Enfoque

Dirige la atención de Kody hacia los problemas que más importan a tu proyecto y reduce el ruido

Estilo de Comunicación

Personaliza cómo Kody presenta las sugerencias — detallado para problemas críticos o conciso para los menores

Cómo Funcionan los Prompts Personalizados

Los Prompts Personalizados operan en dos niveles:

Prompts de Categoría

Define qué busca Kody en cada categoría de revisión:
Enfoque: Corrección del código y problemas de ejecuciónCobertura predeterminada:
  • Interrupciones de ejecución (excepciones no manejadas)
  • Resultados incorrectos (salida incorrecta)
  • Fugas de recursos (archivos, conexiones, memoria)
  • Corrupción de estado (estados inválidos de objetos/datos)
  • Errores de lógica (flujo de control incorrecto)
  • Condiciones de carrera (problemas de acceso concurrente)
Longitud máxima: 2000 caracteres

Prompts de Sugerencia

Controla cómo Kody comunica cada sugerencia individual. Esto personaliza el formato y tono del mensaje que aparece en los comentarios del PR, como:
Tu prompt personalizado le indica a Kody cómo escribir los mensajes de sugerencia. El prompt recibe contexto sobre el nivel de severidad, descripción del problema, código sugerido y si es una violación de Kody Rules. Kody usa este contexto junto con tu prompt para generar mensajes apropiados para cada sugerencia. Puedes personalizar el tono, el nivel de detalle y el estilo de comunicación según las necesidades de tu equipo — desde explicaciones detalladas para problemas críticos hasta feedback conciso para los menores.

Referencias Externas

Todos los prompts personalizados — de Categoría, Sugerencia y Resumen de PR — soportan referencias a archivos reales de los repositorios a los que Kody tiene acceso. Cuando guardas una actualización, Kody detecta automáticamente las referencias externas y las resuelve para revisiones futuras.
  • Usa @file:path/to/file.ts para apuntar a archivos en el repositorio que estás editando; Kody intentará ubicar la ruta localmente primero.
  • Incluye @repo:org/project cuando hagas referencia a archivos de otro repositorio o cuando edites prompts a nivel global.
  • Prefiere rutas de estilo blob precisas en lugar de marcadores de posición para que el modelo pueda encontrar el archivo correcto de manera confiable.
  • Después de guardar, Kody procesa las referencias en segundo plano. Verifica el indicador de estado junto al editor de prompts para confirmar cuándo se completa la resolución.

Mejores Prácticas

Sé Específico para Tu Contexto

Sí: Específico al Contexto

No: Demasiado Genérico

Evita la Redundancia Entre Prompts

Cada categoría debe tener un enfoque distinto. No repitas las mismas instrucciones en diferentes prompts.
Categoría de Errores: Enfócate en la corrección de ejecución, excepciones de puntero nulo y limpieza de recursos en nuestros servicios Java.Categoría de Seguridad: Enfócate en inyección SQL, XSS y CSRF en nuestros endpoints de API. Verifica la sanitización de entrada y las consultas parametrizadas.Categoría de Rendimiento: Enfócate en consultas N+1, índices de base de datos faltantes y bucles ineficientes en el procesamiento de datos.Resultado: Cada prompt tiene un enfoque claro y sin superposición.
Categoría de Errores: Verifica punteros nulos, inyección SQL y consultas lentas.Categoría de Seguridad: Busca inyección SQL, punteros nulos y problemas de rendimiento.Categoría de Rendimiento: Encuentra consultas lentas, punteros nulos y vulnerabilidades de seguridad.Problema: Todos los prompts se superponen, confundiendo al modelo y reduciendo la calidad de la revisión.

Ten Cuidado con los Ejemplos

Esto describe el patrón de forma amplia, capturando múltiples variaciones.

Mantén las Sugerencias Escaneables

Para los prompts de sugerencia, haz que los mensajes sean fáciles de escanear ya que los desarrolladores revisan muchos a la vez:
Jerarquía clara, información importante primero

Usa el Contexto de Forma Significativa

Solo diferencia los formatos de sugerencia cuando haya una razón real:
Distinción clara: las reglas son requisitos, las sugerencias son recomendaciones

Casos de Uso

Escenario: Aplicación de salud con requisitos de cumplimiento HIPAAPrompt de Seguridad Personalizado:
Beneficio: Kody detecta problemas específicos de cumplimiento que las revisiones de seguridad genéricas podrían pasar por alto.
Escenario: Aplicación React/Node.js con patrones específicosPrompt de Errores Personalizado:
Beneficio: Las revisiones se centran exactamente en los problemas específicos de tu stack.
Escenario: Uso de Gemini 2.5 Flash vía BYOK para optimización de costosPrompt de Rendimiento Personalizado:
Beneficio: Formato de salida estructurado que Gemini maneja excepcionalmente bien, mejorando la calidad de la revisión.
Escenario: Quieres explicaciones detalladas para problemas críticos pero feedback conciso para los menoresPrompt de Sugerencia Personalizado:
Beneficio: Los problemas críticos obtienen contexto adicional mientras los menores permanecen breves, mejorando la eficiencia de la revisión.
Escenario: El equipo prefiere feedback mínimo y accionablePrompt de Sugerencia Personalizado:
Beneficio: Cada sugerencia es breve y directa sin contexto adicional.
Escenario: Los desarrolladores junior se benefician de explicaciones detalladasPrompt de Sugerencia Personalizado:
Beneficio: Cada sugerencia incluye contexto educativo sobre su importancia.
Escenario: Las Kody Rules son requisitos estrictos, las sugerencias son recomendacionesPrompt de Sugerencia Personalizado:
Beneficio: Distinción clara entre reglas obligatorias y sugerencias opcionales.

Solución de Problemas

Síntomas: Demasiadas sugerencias de bajo valor después de la personalizaciónSoluciones:
  • Haz los prompts más específicos y enfocados
  • Agrega exclusiones para patrones que quieras ignorar
  • Eleva el umbral mínimo de severidad en Control de Sugerencias
  • Verifica la redundancia entre los prompts de categoría
Síntomas: Kody no detecta problemas que deberíaSoluciones:
  • Revisa tu prompt para ver si es demasiado estrecho o específico a ejemplos
  • Verifica si el problema cae en una categoría que no personalizaste
  • Intenta restablecer los valores predeterminados para ver si el problema es detectado
  • Considera si el problema podría clasificarse bajo una severidad diferente
Síntomas: El mismo tipo de problema a veces se señala y otras veces noSoluciones:
  • Asegúrate de que los prompts sean claros y sin ambigüedades
  • Elimina instrucciones contradictorias entre diferentes prompts
  • Verifica si estás usando ejemplos demasiado específicos
  • Considera si los diferentes modelos en primario/fallback tienen capacidades distintas
Síntomas: Quieres usar prompts personalizados pero no sabes por dónde empezarSoluciones:
  • Comienza ejecutando revisiones predeterminadas durante una semana
  • Anota patrones en falsos positivos o problemas no detectados
  • Personaliza solo el prompt específico relacionado con esos patrones
  • Mantén otros prompts en valores predeterminados hasta que veas una necesidad clara

Preguntas Frecuentes

Depende de dónde los configures:
  • Configuración global: Se aplica a todos los repositorios de tu organización
  • Configuración por repositorio: Anula la configuración global para ese repositorio específico
Esto te permite tener estándares a nivel de organización con overrides específicos por repositorio cuando sea necesario.
Sí. Haz clic en cualquier prompt en la configuración para ver el contenido predeterminado.
Los cambios solo afectan a las revisiones nuevas. Vuelve a ejecutar con @kody start-review para aplicar los nuevos prompts a los PRs existentes.
No. Los prompts personalizados son solo de interfaz web para garantizar cambios intencionales. Otros ajustes (rutas ignoradas, ramas) pueden usar kodus-config.yml.
Solo personaliza los prompts con necesidades claras y específicas. Mantén los demás en valores predeterminados para beneficiarte de nuestras mejoras. Empieza con 1-2 prompts.
Funciona perfectamente. Adapta los prompts a las fortalezas de tu modelo. Tanto el primario como el fallback usan los mismos prompts personalizados.
Los prompts de Categoría controlan qué analiza Kody en cada categoría de revisión. Los prompts de Sugerencia controlan cómo Kody presenta los hallazgos a tu equipo. Puedes personalizar ambos de forma independiente.
Sí. Los prompts de sugerencia soportan formato markdown estándar, incluyendo negrita, cursiva, bloques de código y enlaces.
Kody volverá al formato de sugerencia predeterminado y te notificará del error en la configuración.
Sí. Usa la variable isKodyRule para crear diferentes mensajes para reglas vs sugerencias en el mismo prompt.