Acceder a la Configuración de Prompts Personalizados
¿Por Qué Usar Prompts Personalizados?
Estándares Específicos del Equipo
Optimización del Modelo
Control del Enfoque
Estilo de Comunicación
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:- Error
- Seguridad
- Rendimiento
- 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)
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: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.tspara apuntar a archivos en el repositorio que estás editando; Kody intentará ubicar la ruta localmente primero. - Incluye
@repo:org/projectcuando 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.Ejemplo: Separación Correcta
Ejemplo: Separación Correcta
Anti-patrón: Prompts Redundantes
Anti-patrón: Prompts Redundantes
Ten Cuidado con los Ejemplos
- Bien: Descripción de Patrón
- Arriesgado: Ejemplo Específico
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:- Bien: Estructura Clara
- Mal: Bloque de Texto
Usa el Contexto de Forma Significativa
Solo diferencia los formatos de sugerencia cuando haya una razón real:- Bien: Diferencia Significativa
- Mal: Etiqueta Superficial
Casos de Uso
Requisitos Específicos del Sector
Requisitos Específicos del Sector
Optimización del Stack Tecnológico
Optimización del Stack Tecnológico
Ajuste Específico del Modelo
Ajuste Específico del Modelo
Comunicación Basada en Severidad
Comunicación Basada en Severidad
Feedback Directo y Conciso
Feedback Directo y Conciso
Sugerencias Educativas
Sugerencias Educativas
Tono Diferente para Reglas vs Sugerencias
Tono Diferente para Reglas vs Sugerencias
Solución de Problemas
Las Revisiones Son Demasiado Ruidosas
Las Revisiones Son Demasiado Ruidosas
- 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
Problemas Esperados No Detectados
Problemas Esperados No Detectados
- 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
Resultados Inconsistentes
Resultados Inconsistentes
- 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
No Sabes Qué Personalizar
No Sabes Qué Personalizar
- 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
¿Los prompts personalizados se aplican a todos los repositorios?
¿Los prompts personalizados se aplican a todos los repositorios?
- 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
¿Puedo ver los prompts predeterminados antes de personalizar?
¿Puedo ver los prompts predeterminados antes de personalizar?
¿Qué ocurre con los PRs existentes cuando cambio los prompts?
¿Qué ocurre con los PRs existentes cuando cambio los prompts?
@kody start-review para aplicar los nuevos prompts a los PRs existentes.¿Puedo personalizar los prompts con kodus-config.yml?
¿Puedo personalizar los prompts con kodus-config.yml?
kodus-config.yml.¿Debo personalizar todos los prompts o solo algunos?
¿Debo personalizar todos los prompts o solo algunos?
¿Cómo funcionan los prompts personalizados con BYOK?
¿Cómo funcionan los prompts personalizados con BYOK?
¿Cuál es la diferencia entre los prompts de Categoría y los prompts de Sugerencia?
¿Cuál es la diferencia entre los prompts de Categoría y los prompts de Sugerencia?
¿Puedo usar markdown en los prompts de sugerencia?
¿Puedo usar markdown en los prompts de sugerencia?
¿Qué ocurre si mi plantilla de sugerencia tiene errores de sintaxis?
¿Qué ocurre si mi plantilla de sugerencia tiene errores de sintaxis?
¿Los prompts de sugerencia funcionan tanto para Kody Rules como para sugerencias estándar?
¿Los prompts de sugerencia funcionan tanto para Kody Rules como para sugerencias estándar?
isKodyRule para crear diferentes mensajes para reglas vs sugerencias en el mismo prompt.