Controles de alcance de diff: Modos de análisis STRICT, NEARBY y RELAXED
¿Qué es el alcance de diff?
El alcance de diff controla cuánto contexto considera la IA al analizar tus cambios. Por defecto, AI Diff Review se enfoca en las líneas que realmente cambiaste, pero puedes expandir este alcance para incluir líneas cercanas o incluso el archivo completo. Esta configuración afecta tanto la calidad del análisis como la puntuación de la puerta de commit.
Modos de alcance
Modo STRICT
En modo STRICT, la IA solo considera hallazgos que están directamente en líneas modificadas. Este es el enfoque más enfocado y asegura que la puntuación de la puerta de commit solo refleje problemas que realmente introdujiste.
Mejor para:
- Puntuación precisa de la puerta de commit
- Enfocarse solo en problemas nuevos
- Commits pequeños y enfocados
- Cuando quieres ignorar problemas preexistentes
Consideraciones:
- Puede perder problemas relacionados con tus cambios pero no directamente en líneas modificadas
- Menos contexto para que la IA entienda tus cambios
- Puede producir menos hallazgos en general
Modo NEARBY
El modo NEARBY incluye una ventana configurable de líneas alrededor de tus cambios (por defecto: ±N líneas). Esto proporciona más contexto mientras aún se enfoca en el área que modificaste.
Mejor para:
- Análisis equilibrado con contexto
- Entender el impacto de los cambios en el código circundante
- La mayoría de los casos de uso de propósito general
- Cuando quieres algo de contexto sin analizar archivos completos
Consideraciones:
- El tamaño de la ventana afecta el alcance del análisis—ventanas más grandes incluyen más contexto
- Puede marcar problemas en código cercano que no modificaste
- La puntuación de la puerta de commit incluye hallazgos cercanos
Modo RELAXED
El modo RELAXED considera el archivo completo al analizar cambios. Esto proporciona contexto máximo y ayuda a la IA a entender el impacto completo de tus modificaciones.
Mejor para:
- Análisis completo
- Entender cómo los cambios afectan el archivo completo
- Esfuerzos de refactorización
- Cuando quieres insight máximo de IA
Consideraciones:
- Puede marcar muchos problemas preexistentes
- La puntuación de la puerta de commit incluye todos los hallazgos del archivo
- Un alcance de análisis más grande significa más tiempo de procesamiento
- Puede ser abrumador para archivos grandes
Configurar el alcance
Para configurar el alcance de diff:
- Ve a Configuración → Herramientas → AI Diff Review
- Navega a la sección Controles de alcance de diff
- Selecciona tu modo preferido (STRICT, NEARBY o RELAXED)
- Si usas NEARBY, establece el tamaño de la ventana (número de líneas a incluir en cada lado)
Impacto en la puerta de commit
El alcance de diff afecta directamente la puntuación de la puerta de commit:
- STRICT: Solo los hallazgos en líneas modificadas contribuyen a la puntuación
- NEARBY: Los hallazgos dentro de la ventana contribuyen a la puntuación
- RELAXED: Todos los hallazgos en archivos modificados contribuyen a la puntuación
Por defecto, los elementos INFO globales o no dirigidos se ignoran para la puerta, independientemente del modo de alcance. Esto asegura que la puerta se enfoque en problemas relacionados con tus cambios.
Elegir el modo correcto
Para proyectos sensibles a la seguridad
Usa STRICT o NEARBY con una ventana pequeña. Esto asegura que la puerta de commit solo bloquee basándose en problemas que realmente introdujiste, no problemas preexistentes.
Para mejora de calidad de código
Usa el modo RELAXED para obtener retroalimentación completa sobre archivos completos. Esto ayuda a identificar áreas de mejora más allá de solo tus cambios.
Para equipos grandes
Usa el modo STRICT para asegurar que las puertas de commit sean justas y solo bloqueen basándose en problemas nuevos. Esto previene frustración de ser bloqueado por problemas de código preexistentes.
Para refactorización
Usa el modo RELAXED para entender cómo tu refactorización afecta el archivo completo. Esto proporciona mejor contexto para tomar decisiones informadas.
Mejores prácticas
Comenzar con el valor por defecto
El modo RELAXED por defecto funciona bien para la mayoría de los casos de uso. Comienza ahí y ajusta según tus necesidades.
Coincidir con tu flujo de trabajo
Elige un modo de alcance que coincida con cómo trabaja tu equipo. Si prefieres commits enfocados, usa STRICT. Si haces revisiones completas, usa RELAXED.
Considerar el tamaño del archivo
Para archivos muy grandes, el modo RELAXED puede ser abrumador. Considera usar NEARBY con un tamaño de ventana razonable en su lugar.
Revisar hallazgos
Independientemente del modo de alcance, revisa los hallazgos cuidadosamente. Incluso en modo RELAXED, enfócate en abordar problemas relacionados con tus cambios primero.
Combinar con otras configuraciones
El alcance de diff funciona junto con otras configuraciones:
- Inclusión de contenido completo: Cuando está habilitada, el modo RELAXED tiene más contexto con el que trabajar
- Límite de contexto relacionado: Limita cuánto código relacionado se incluye, funcionando junto con los controles de alcance
- Nivel de puerta de commit: El alcance afecta lo que contribuye a la puntuación de la puerta
Conclusión
Los controles de alcance de diff te dan control detallado sobre cómo AI Diff Review analiza tu código. Al elegir el modo correcto para tus necesidades, puedes equilibrar análisis completo con retroalimentación enfocada.
El modo STRICT asegura precisión, NEARBY proporciona contexto equilibrado, y RELAXED ofrece insights completos. Experimenta con diferentes modos para encontrar lo que funciona mejor para tu flujo de trabajo.
Recuerda que puedes cambiar el modo de alcance en cualquier momento en la configuración, así que no te sientas encerrado en tu elección inicial. Ajusta según sea necesario basándote en el tipo de trabajo que estás haciendo.
¿Listo para configurar tu alcance de análisis? Instala AI Diff Review y explora los diferentes modos de alcance disponibles.