Descripción General

​

Dos tipos en la interfaz de Kody Rules

​

Reglas de Revisión

​

Crear Reglas Personalizadas

​

Variables, Referencias a Archivos y Funciones MCP

• Nivel de Archivo:
  • fileDiff - Los cambios específicos realizados en el archivo individual que se está analizando
• Nivel de PR:
  • pr_title - El título del Pull Request
  • pr_description - La descripción/cuerpo del Pull Request
  • pr_total_additions - Número total de líneas agregadas
  • pr_total_deletions - Número total de líneas eliminadas
  • pr_total_files - Número total de archivos modificados
  • pr_total_lines_changed - Número total de líneas modificadas
  • pr_files_diff - Diff completo de todos los cambios en todo el Pull Request
  • pr_tags - Etiquetas asociadas al Pull Request
  • pr_author - Autor del Pull Request
  • pr_number - Número del Pull Request

• @file:path/to/file.ts - Referencia archivos en el mismo repositorio donde estás editando la regla
  • Úsalo cuando referencias plantillas, ejemplos o archivos de configuración dentro de tu repositorio actual
  • Ejemplo: @file:src/services/userService.ts
• @repo:org/project - Referencia archivos en otro repositorio o cuando configuras reglas fuera del contexto de un repositorio
  • Úsalo cuando apliques consistencia entre múltiples repositorios o referencíes estándares compartidos
  • Ejemplo: @repo:team/api-standards

• Kody identifica las referencias a archivos automáticamente cuando guardas una regla
• Las referencias se resuelven en segundo plano — observa el indicador de estado junto al editor para confirmar la finalización
• Usa rutas de estilo blob precisas (p. ej., src/utils/helpers.ts) en lugar de marcadores de posición
• El contenido de los archivos se inyecta en el contexto de la regla, permitiendo a Kody comparar, validar o aplicar patrones
• Funciona tanto en reglas de Nivel de Archivo como de Nivel de Pull Request

• Operaciones de repositorio: Listar repositorios, obtener archivos, contenido e idiomas del repositorio
• Análisis de PR: Obtener detalles del pull request, listar commits, analizar contenido de archivos del PR
• Recuperación de contenido de archivos: Obtener contenido de archivos y diffs
• Validación entre archivos: Realizar análisis avanzado entre múltiples archivos
• Integraciones personalizadas: Cualquier servidor MCP que hayas conectado como plugin (Jira, herramientas personalizadas, etc.)

• Usa rutas de archivos específicas en lugar de marcadores de posición genéricos
• Referencia archivos estables que representen los estándares de tu equipo
• Verifica que las referencias a archivos existan antes de guardar las reglas para evitar errores de resolución
• Combina variables, referencias a archivos y funciones MCP para una validación exhaustiva

​

Reglas a Nivel de Archivo

• Comparar con archivos de referencia usando @file o @repo
• Obtener archivos relacionados o datos del repositorio usando funciones MCP
• Combinar variables, referencias a archivos y funciones MCP para validar patrones, verificar consistencia o aplicar reglas arquitectónicas

• Nombre de la regla: Define claramente el propósito de la regla
• Execution mode: Per file (el valor por defecto)
• Path: Limita las reglas a archivos o directorios específicos usando patrones glob (déjalo vacío para aplicarla a todos los archivos)
• Instructions: Usa fileDiff, referencia archivos con @file/@repo y llama a funciones MCP para componer reglas potentes con contexto enriquecido. Las reglas nuevas pueden empezar desde una plantilla con Start with a popular template
• Severity: Establece en Critical, High (el valor por defecto), Medium o Low
• Advanced settings: Inheritable (activado por defecto; consulta Herencia de Reglas) y Code examples (Bad example / Good example)

// Riesgo de bucle infinito si el incremento no es exactamente 1
for (let i = 0; i != 10; i += 2) {
  console.log(i); // Imprimirá 0, 2, 4, 6, 8, 10, 12, 14... para siempre
}

// Riesgo si el array se modifica durante la iteración
let items = [1, 2, 3, 4, 5];
for (let i = 0; i != items.length; i++) {
  if (items[i] === 3) {
    items.push(6); // Modifica la longitud, puede causar bucle infinito
  }
}

// Seguro: el bucle siempre terminará
for (let i = 0; i < 10; i += 2) {
  console.log(i); // Imprimirá 0, 2, 4, 6, 8 y se detendrá
}

// Seguro incluso si el array se modifica
let items = [1, 2, 3, 4, 5];
for (let i = 0; i < items.length; i++) {
  if (items[i] === 3) {
    items.push(6); // El bucle aún terminará de forma segura
  }
}

​

Reglas a Nivel de Pull Request

• Validar metadatos del PR usando variables como pr_title, pr_description, pr_author
• Referenciar archivos de configuración o plantillas usando @file o @repo
• Obtener contexto adicional usando funciones MCP (p. ej., verificar si archivos relacionados existen, validar contra la estructura del repositorio)
• Combinar variables de PR, referencias a archivos y funciones MCP para crear reglas de validación exhaustivas

• Cada archivo de servicio debe tener un archivo de prueba correspondiente
• La descripción del PR debe ser completa, indicando claramente qué se agregó o eliminó
• Cuando se crea una nueva ruta en un controlador, debe registrarse en routes.json
• Usa pr_total_lines_changed para señalar PRs que superan los límites de tamaño
• Combina pr_files_diff con funciones MCP para validar dependencias entre archivos
• Referencia @file:routes.json para asegurar que las nuevas rutas estén registradas
• Usa funciones MCP para verificar si existen archivos de prueba para los archivos de servicio modificados

​

Composición de Reglas Potentes

• Usa fileDiff para analizar los cambios específicos en un archivo
• Referencia archivos relacionados con @file:path/to/template.ts para comparar con patrones
• Llama a funciones MCP para obtener datos del repositorio o verificar si existen archivos relacionados
• Ejemplo: “Analiza fileDiff y asegúrate de que siga el patrón en @file:src/utils/example.ts. Usa MCP para verificar que existan archivos de prueba relacionados.”

• Usa variables de PR (pr_title, pr_description, pr_files_diff, etc.) para validar metadatos del PR y tamaño
• Referencia archivos de configuración con @file:config.json o @repo:org/shared-config para aplicar consistencia
• Llama a funciones MCP para realizar validación entre archivos, verificar la estructura del repositorio u obtener el historial de commits
• Ejemplo: “Si pr_files_diff contiene nuevas rutas, verifica que estén registradas en @file:routes.json. Usa MCP para verificar si existen archivos de prueba correspondientes para todos los archivos de servicio modificados.”

• Referencia archivos de otros repositorios con @repo:org/project para mantener consistencia entre proyectos
• Combina con funciones MCP para validar contra estándares o plantillas compartidos
• Ejemplo: “Asegúrate de que los endpoints de la API sigan el patrón definido en @repo:org/api-standards. Usa MCP para obtener el documento de estándares más reciente.”

• Las funciones MCP se ejecutan durante la evaluación de la regla, habilitando reglas que se adaptan al estado actual del repositorio
• Obtén datos en tiempo real sobre archivos, commits o la estructura del repositorio
• Ejemplo: “Usa MCP para verificar la estructura actual del repositorio y asegurarte de que los nuevos archivos sigan los patrones de directorio existentes.”

​

Importar desde la Biblioteca de Reglas

• En Code review → Kody Rules (pestaña Review Rules), haz clic en Discovery para abrir la biblioteca de reglas (Rules Marketplace). También puedes llegar desde Browse the library cuando la lista de reglas está vacía, o buscando Rules library en la paleta de comandos ⌘K.
• Empieza por Featured, o cambia a Browse para buscar en el catálogo completo y filtrar reglas por Severity, Language o Packs.
• Abre una regla y haz clic en Add to my rules, usando el selector de repositorios junto a él para elegir Global o los repositorios (y directorios) que deben recibir la regla.

• Seguridad: “Prohibir el uso del hash MD5 inseguro.”
• Mantenibilidad: “Limitar los componentes React a menos de 150 líneas.”

​

Memorias

​

Cómo Funcionan las Memorias

• Inyectadas en todas partes: Las Memorias se incluyen en el análisis de revisión de código (entre archivos, salvaguardas, reglas a nivel de PR) y en las interacciones conversacionales
• Contexto de alta prioridad: Las Memorias son tratadas como orientación de alta prioridad por la IA, asegurando que las convenciones de tu equipo se apliquen de manera consistente
• Mejores sugerencias futuras: Las Memorias ayudan a Kody a no repetir las mismas suposiciones equivocadas sobre tu repositorio
• Deduplicación inteligente: Cuando se crea una nueva memoria, Kody usa un mecanismo de resolución basado en LLM para determinar si crearla, omitirla (si es duplicada) o actualizar una memoria existente

​

Crear Memorias

​

Vía Conversación

@kody remember: este repositorio refleja una API de terceros, así que algunos campos del payload se mantienen intencionalmente en snake_case.

@kody please remember: este servicio sigue arquitectura hexagonal y deja los adapters en los bordes.

@kody este repositorio refleja una API de terceros, así que algunos campos del payload se mantienen intencionalmente en snake_case.

@kody en este servicio, las pruebas suelen vivir junto a los archivos de implementación y no en una carpeta central de tests.

@kody el módulo de facturación está a mitad de una migración, así que convienen cambios incrementales y no refactors amplios.

​

Vía la UI

1. En la barra lateral, elige Global (o el repositorio / directorio) en el selector de alcance en la parte superior del grupo Code review y abre Kody Rules. La memoria se crea en el alcance que elijas aquí
2. Cambia a la pestaña Memories
3. Haz clic en New memory (o Add a memory cuando la lista está vacía)
4. Completa Memory name e Instructions y haz clic en Create memory

​

Alcances de las Memorias

​

Aprobación de Memorias Generadas por LLM

1. Ve a Code review → Kody Rules en el alcance que quieras (Global, un repositorio o un directorio)
2. Haz clic en Configuration para abrir el panel lateral
3. Habilita Kody knowledge approval

• Las reglas y memorias generadas por IA entran en un estado pendiente y no están activas hasta que se aprueben
• Un badge en las pestañas Review Rules y Memories muestra el número de elementos pendientes
• Los elementos pendientes aparecen en la sección Pending review en la parte superior de la página, donde los apruebas o descartas (consulta Elementos pendientes más abajo)
• Tanto las nuevas creaciones como las actualizaciones de reglas/memorias existentes pasan por el flujo de aprobación

kodyKnowledgeApproval:
    enabled: true

​

Elementos pendientes

• Nuevas reglas y memorias: Elementos generados por IA en espera de aprobación. Elige Approve para activar el elemento o Discard para rechazarlo.
• Actualizaciones: Cambios propuestos a una regla o memoria existente, mostrados como un diff. Elige Update existing para aplicar el cambio, Create new instead para conservar el original y agregar la propuesta como un elemento separado, o Discard para rechazarla.

​

Próximos Pasos