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).
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
@issuesdans 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.
Actions de code
Accède aux actions de code assistées par IA de Bob qui fournissent des corrections rapides, des refactorisations et des explications de code directement dans Bob IDE via les icônes d'ampoule et les menus contextuels.
Messages de commit
Génère automatiquement des messages de commit pertinents avec Bob. Gagne du temps, maintiens la cohérence et respecte les standards de conventional commits grâce à l'assistance de l'IA.