Características

Code reviews

Usa el flujo de trabajo de revisión integrado para obtener code reviews con IA directamente en tu IDE. Bob analiza los cambios y señala posibles problemas antes de que confirmes tu trabajo.

¿Por qué usar code reviews?

  • Detecta errores temprano: Identifica problemas antes de que lleguen a tu trabajo confirmado.
  • Ahorra tiempo: Aborda de forma proactiva los posibles comentarios de los revisores, reduciendo el tiempo de aprobación de PR.
  • Mejora la calidad del código: Obtén sugerencias para mejores prácticas de programación y mantenibilidad.
  • Valida contra issues: Asegúrate de que tus cambios se alinean con los requisitos del issue (se requiere GitHub).

Cómo funciona

El flujo de trabajo de revisión se ejecuta completamente en tu IDE. Bob proporciona un panel de revisión dedicado. Ábrelo usando el comando /review.

Bob revisa el diff entre tus branches seleccionadas, luego señala posibles problemas en el panel Bob Findings. Opcionalmente puedes incluir un issue de GitHub para validar que tus cambios cumplen sus requisitos.

Las revisiones se ejecutan con auto-aprobación. Bob procede por todos los pasos de análisis sin requerir confirmación manual.

Revisar tu código

Requisitos previos

  • Acceso a los branches locales o remotos que quieres comparar.
  • Para validación de issues: una cuenta de GitHub y la URL del issue (se requiere GitHub para las funciones relacionadas con issues).
Nota:

Bob puede trabajar con GitHub y GitLab para comparaciones de branches. Sin embargo, la validación de issues requiere GitHub.

Iniciar una revisión

Abre el panel de revisión de Bob desde tu barra lateral usando el comando /review o el icono del panel de revisión. El panel proporciona una interfaz visual para configurar e iniciar tu revisión.

Selecciona el branch contra el que quieres comparar desde el dropdown de branches. Puedes comparar contra tu branch actual, branches locales, branches remotos o el branch predeterminado de tu repositorio.

Activa Incluir cambios no confirmados si quieres incluir modificaciones locales que aún no se han confirmado.

Opcionalmente, selecciona un issue de GitHub de la lista de issues para validar que tus cambios cumplen sus requisitos.

Haz clic en Iniciar revisión para comenzar.

Bob revisa tus cambios y muestra los hallazgos en el panel Bob Findings.

Opciones de revisión

Seleccionar un branch de comparación

El selector desplegable de branches muestra:

  • Branch actual: Tu branch activo.
  • Branch predeterminado: El branch predeterminado de tu repositorio (marcado con una insignia).
  • Branches remotos: Branches de tu repositorio remoto (marcados con una insignia).
  • Branches locales: Otros branches locales (marcados con una insignia).

Puedes comparar main remoto contra main local, tu branch actual contra cualquier otro branch, o cualquier combinación de refs.

Mostrar cambios no confirmados

Activa la casilla Incluir cambios no confirmados para incluir modificaciones locales sin confirmar en tu revisión. Esta opción se activa automáticamente al revisar tu branch actual.

Configurar exclusiones de revisión

Puedes excluir archivos o patrones específicos de los code reviews:

Abre la configuración de Bob.

Navega a la pestaña Bob Findings.

En Exclusiones de revisión, añade patrones glob para los archivos a excluir (p. ej., .vscode/**, *.test.ts).

Los archivos excluidos no aparecerán en la lista de archivos del panel de revisión y no se analizarán durante las revisiones.

Usar Bob Findings

Una vez que Bob completa una revisión, los hallazgos aparecen en el panel Bob Findings. Puedes interactuar con estos hallazgos de varias formas:

Ver hallazgos

  • Haz clic en cualquier hallazgo en el panel Bob Findings para ver los detalles completos.
  • Usa @issues en el menú desplegable de contexto de la interfaz de chat para referenciar hallazgos en la conversación.
  • Navega al archivo haciendo clic en el hallazgo para ver el código en contexto con anotaciones en línea.

Para más información sobre las menciones de contexto, consulta menciones de contexto.

Actuar sobre los hallazgos

Cada hallazgo proporciona la siguiente acción:

  • Corregir con Bob: Pide a Bob que corrija el problema automáticamente. Bob creará una tarea para abordar el hallazgo.
  • Descartar: Elimina el hallazgo del panel si no es relevante.

Consejos y mejores prácticas

  • Combinar con revisiones manuales: Usa las revisiones automatizadas de Bob como primer paso antes de las revisiones de código humanas.
  • Validar la cobertura de issues: Incluye un issue de GitHub para asegurarte de que tus cambios cumplen completamente los requisitos antes de crear un pull request.
  • Configurar exclusiones: Excluye archivos de prueba, código generado o archivos de configuración que no necesitan revisión.
  • Comparar contra branches remotos: Usa el selector de branches para revisar tu trabajo contra los últimos cambios remotos.
¿Cómo es este tema?