Travailler avec de grandes bases de code
Stratégies pour naviguer et travailler avec de grandes bases de code
Travailler avec de grandes bases de code nécessite des stratégies spécifiques pour gérer les limitations de contexte et maintenir la productivité. Ce guide propose des flux de travail pratiques pour naviguer, comprendre et modifier efficacement de grands projets à l'aide de Verdent for VS Code.
Utiliser l'agent Explorer pour la découverte de la base de code
Supposons que vous découvriez une grande base de code et deviez trouver où une fonctionnalité spécifique est implémentée.
Poser des questions de découverte larges
Where is user authentication handled in this codebase?Verdent délègue automatiquement à l'agent Explorer, un spécialiste économe en tokens pour les recherches dans la base de code.
Explorer effectue une recherche efficace
L'agent Explorer :
- Recherche dans les noms de fichiers et les chemins
- Effectue des recherches par mots-clés dans le contenu du code
- Analyse les schémas architecturaux
- Renvoie les résultats avec les chemins de fichiers et des extraits de code
Affiner votre recherche
Show me all files that import the authentication moduleExplorer peut effectuer des recherches complémentaires pour affiner les résultats.
Paralléliser les recherches complexes
Pour une découverte exhaustive, Verdent peut exécuter plusieurs agents Explorer en parallèle :
- Explorer 1 : trouver la logique d'authentification
- Explorer 2 : trouver la logique d'autorisation
- Explorer 3 : trouver la gestion des sessions
Les résultats arrivent plus rapidement grâce à la recherche parallèle.
Astuces :
- L'agent Explorer fonctionne efficacement dans les grandes bases de code sans saturer le contexte principal
- Plusieurs agents Explorer peuvent effectuer des recherches simultanées sur différents aspects
- Utilisez Explorer pour la recherche de motifs et la découverte architecturale
- Les résultats incluent les chemins de fichiers et des extraits de code pertinents pour le contexte
Découper les tâches en portions gérables
Supposons que vous travailliez sur une grande base de code et deviez ajouter une fonctionnalité touchant de nombreux fichiers.
Identifier les frontières naturelles de la tâche
Plutôt que de tout demander en une seule fois :
Phase 1: Add the data models for the notification systemConcentrez-vous d'abord sur un composant autonome.
Terminer entièrement la phase
Menez la phase 1 à terme, tests inclus, avant de passer à la phase 2. Cela crée un point de contrôle propre.
Valider votre progression
git add .
git commit -m "feat: add notification data models"Un commit crée un point de retour en arrière sûr.
Réinitialiser le contexte pour la phase suivante
Pour les tâches complexes, réinitialisez le contexte avant de passer à la phase suivante. Cela garantit que Verdent dispose d'une capacité de contexte suffisante pour maintenir des performances optimales.
Phase 2: Build the notification API endpoints using the data modelsDémarrez une nouvelle session avec un contexte neuf, centré uniquement sur la phase 2.
Astuces :
- Des points de rupture naturels évitent l'épuisement du contexte
- Chaque phase doit pouvoir être testée de manière indépendante
- Valider entre les phases permet d'expérimenter en toute sécurité
- Des sessions neuves gardent le contexte propre et ciblé
Exploiter Plan Mode pour des changements à grande échelle
Supposons que vous devez refactoriser une fonctionnalité répartie sur des dizaines de fichiers dans une grande base de code.
Commencer en Plan Mode
Switch to Plan Mode: Refactor the payment processing logic to use a new payment provider across all filesPlan Mode permet une analyse en lecture seule sans consommer de contexte lié aux modifications de fichiers.
Utiliser Explorer pour trouver tous les fichiers concernés
Use the Explorer agent to find all files that reference payment processingGarantit que vous identifiez chaque emplacement nécessitant une mise à jour.
Examiner le plan complet
Verdent présente un plan indiquant :
- Tous les fichiers nécessitant des modifications (25 fichiers identifiés)
- L'ensemble minimal de fichiers à inclure dans le contexte principal
- L'ordre des opérations
- Les dépendances entre les changements
Examinez-le avant de vous engager dans l'approche.
Approuver l'exécution
Une fois satisfait du plan, approuvez l'exécution. Verdent traite les changements de façon méthodique.
Astuces :
- Plan Mode aide à identifier l'ensemble minimal de fichiers avant l'exécution
- Explorer garantit qu'aucun fichier n'est oublié lors d'une refactorisation à grande échelle
- Les plans montrent clairement la portée avant toute consommation de contexte
- Enregistrez les plans dans des fichiers pour la documentation et la revue d'équipe
Effectuer des changements coordonnés sur de nombreux fichiers
Supposons que vous devez renommer une fonction utilisée dans plus de 50 fichiers d'une grande base de code.
Utiliser Explorer pour trouver toutes les occurrences
Use the Explorer agent to find all files that use the calculateTotal functionIdentifie chaque fichier nécessitant une mise à jour.
Examiner la portée en Plan Mode
In Plan Mode: Rename calculateTotal to computeFinalTotal across all filesVisualisez la portée complète avant d'effectuer les changements.
Vérifier qu'aucun fichier n'est oublié
Verdent affiche les 52 fichiers nécessitant une mise à jour. Passez la liste en revue pour vous assurer de son exhaustivité.
Exécuter les changements coordonnés
Approuvez le plan. Verdent met à jour tous les fichiers de manière systématique, garantissant un renommage cohérent partout.
Exécuter les tests pour vérifier
Run the full test suite to verify all references were updated correctlyLes tests permettent de détecter toute référence oubliée.
Astuces :
- Explorer garantit qu'aucun fichier n'est oublié lors de changements à grande échelle
- Plan Mode affiche la portée complète avant l'exécution
- Des mises à jour systématiques maintiennent la cohérence sur l'ensemble des fichiers
- Testez de manière exhaustive après une refactorisation à grande échelle
Les changements coordonnés sur de nombreux fichiers sont plus sûrs par phases : mettez à jour une couche, vérifiez, puis passez aux couches dépendantes.
Questions fréquentes
Comment savoir si j'approche des limites de contexte ?
Les signes incluent des temps de réponse plus lents, des sessions qui durent plusieurs heures, ou de nombreux fichiers volumineux chargés. Surveillez la durée de votre session et le nombre de fichiers. Dès que vous constatez une baisse de performance, terminez votre tâche en cours, validez votre progression, et démarrez une nouvelle session avec un contexte propre.
Est-il sûr de laisser Verdent modifier des dizaines de fichiers à la fois ?
Oui, si l'usage est adapté. Utilisez toujours Plan Mode pour examiner d'abord la portée complète, assurez-vous d'avoir une couverture de tests exhaustive, et validez fréquemment entre les phases. Cela vous permet de vérifier les changements de façon incrémentale et de revenir en arrière facilement si nécessaire.
Quand utiliser l'agent Explorer plutôt que charger les fichiers directement ?
Utilisez l'agent Explorer pour les tâches de découverte et de recherche sans consommer le contexte principal. Chargez les fichiers directement via des mentions @ uniquement lorsque vous devez les modifier. Explorer est idéal pour les questions du type « trouver tous les fichiers qui... », tandis que les mentions @ conviennent aux tâches du type « mettre à jour ce fichier spécifique ».
Quel préréglage de modèle convient le mieux au travail sur de grandes bases de code ?
Utilisez le préréglage Performance pour les opérations multi-fichiers complexes et les refactorisations. Utilisez le préréglage Efficiency pour les recherches simples et les tâches de découverte. Performance offre une capacité de raisonnement accrue pour les changements coordonnés, tandis qu'Efficiency est plus rapide et plus économique pour l'exploration.