Fonctionnalités

Code reviews

Utilise le workflow de révision intégré pour obtenir des code reviews alimentées par l'IA directement dans ton IDE. Bob analyse les modifications et signale les problèmes potentiels avant que tu ne commites ton travail.

Pourquoi utiliser les code reviews ?

  • Détecter les erreurs tôt : Identifie les problèmes avant qu'ils n'atteignent ton travail commité.
  • Gagner du temps : Anticipe les commentaires potentiels des reviewers, réduisant le temps d'approbation des PR.
  • Améliorer la qualité du code : Obtiens des suggestions pour de meilleures pratiques de programmation et une meilleure maintenabilité.
  • Valider par rapport aux issues : Assure-toi que tes modifications correspondent aux exigences des issues (GitHub requis).

Comment ça fonctionne

Le workflow de révision s'exécute entièrement dans ton IDE. Bob fournit un panel de révision dédié. Ouvre-le avec la commande /review.

Bob examine le diff entre tes branches sélectionnées, puis signale les problèmes potentiels dans le panel Bob Findings. Tu peux optionnellement inclure une issue GitHub pour valider que tes modifications répondent à ses exigences.

Les révisions s'exécutent avec auto-approbation. Bob procède à toutes les étapes d'analyse sans nécessiter de confirmation manuelle.

Réviser ton code

Prérequis

  • Accès aux branches locales ou distantes que tu veux comparer.
  • Pour la validation des issues : un compte GitHub et l'URL de l'issue (GitHub est requis pour les fonctionnalités liées aux issues).
Note :

Bob peut travailler avec GitHub et GitLab pour les comparaisons de branches. Cependant, la validation des issues nécessite GitHub.

Lancer une révision

Ouvre le panel de révision Bob depuis ta barre latérale avec la commande /review ou l'icône du panel de révision. Le panel fournit une interface visuelle pour configurer et démarrer ta révision.

Sélectionne la branche contre laquelle tu veux comparer depuis le menu déroulant des branches. Tu peux comparer avec ta branche actuelle, des branches locales, des branches distantes ou la branche par défaut de ton dépôt.

Active Inclure les modifications non commitées si tu veux inclure les modifications locales qui n'ont pas encore été commitées.

Optionnellement, sélectionne une issue GitHub dans la liste des issues pour valider que tes modifications répondent à ses exigences.

Clique sur Démarrer la révision pour commencer.

Bob révise tes modifications et affiche les résultats dans le panel Bob Findings.

Options de révision

Sélectionner une branche de comparaison

Le sélecteur de branches affiche :

  • Branche actuelle : Ta branche active.
  • Branche par défaut : La branche par défaut de ton dépôt (marquée d'un badge).
  • Branches distantes : Les branches de ton dépôt distant (marquées d'un badge).
  • Branches locales : Les autres branches locales (marquées d'un badge).

Tu peux comparer main distant contre main local, ta branche actuelle contre n'importe quelle autre branche, ou toute combinaison de refs.

Afficher les modifications non commitées

Active la case Inclure les modifications non commitées pour inclure les modifications locales non commitées dans ta révision. Cette option est automatiquement activée lors de la révision de ta branche actuelle.

Configurer les exclusions de révision

Tu peux exclure des fichiers ou des motifs spécifiques des code reviews :

Ouvre les paramètres Bob.

Navigue vers l'onglet Bob Findings.

Sous Exclusions de révision, ajoute des motifs glob pour les fichiers à exclure (ex. .vscode/**, *.test.ts).

Les fichiers exclus n'apparaîtront pas dans la liste des fichiers du panel de révision et ne seront pas analysés lors des révisions.

Utiliser Bob Findings

Une fois que Bob a terminé une révision, les résultats apparaissent dans le panel Bob Findings. Tu peux interagir avec ces résultats de plusieurs façons :

Voir les résultats

  • Clique sur n'importe quel résultat dans le panel Bob Findings pour voir les détails complets.
  • Utilise @issues dans le menu déroulant de contexte de l'interface de chat pour référencer les résultats dans la conversation.
  • Navigue vers le fichier en cliquant sur le résultat pour voir le code en contexte avec des annotations en ligne.

Pour plus d'informations sur les mentions de contexte, consulte mentions de contexte.

Agir sur les résultats

Chaque résultat fournit l'action suivante :

  • Corriger avec Bob : Demande à Bob de corriger automatiquement le problème. Bob créera une tâche pour traiter le résultat.
  • Ignorer : Supprime le résultat du panel s'il n'est pas pertinent.

Conseils et meilleures pratiques

  • Combiner avec des révisions manuelles : Utilise les révisions automatisées de Bob comme premier passage avant les code reviews humaines.
  • Valider la couverture des issues : Inclus une issue GitHub pour t'assurer que tes modifications répondent entièrement aux exigences avant de créer un pull request.
  • Configurer les exclusions : Exclus les fichiers de test, le code généré ou les fichiers de configuration qui n'ont pas besoin de révision.
  • Comparer avec des branches distantes : Utilise le sélecteur de branches pour réviser ton travail par rapport aux dernières modifications distantes.
Comment trouvez-vous ce sujet ?