Que fait Recherche de code local ?
Installation et pièges
Lisez configuration et dépannage lorsque des outils manquent, lors de l'installation de cette compétence sur une autre machine, lors de la vérification de l'accélération ou de la mise à jour. N'installez pas et ne reconfigurez pas les outils uniquement parce qu'une tâche de code ordinaire invoque cette compétence. L'assistant portable facultatif cgrep fournit des indicateurs de recherche ; les paramètres spécifiques à la plateforme et leurs limites sont documentés dans la configuration.
Commencez par l'orientation
Au début d'une session de codage, et avant d'étudier une refonte ou une question de code complexe, lisez les instructions du référentiel et les conseils pertinents du projet, puis utilisez un plan ciblé comme premier passage de navigation dans le code avant des lectures larges des sources ou la planification de l'implémentation. Lisez le sous-guide de planification.
Choisissez le plus petit package, répertoire ou fichier pertinent ; ne planifiez pas tout un monorepo par défaut. Si la zone est inconnue, utilisez les noms de fichiers ou une requête ColGREP ciblée pour trouver des candidats, puis planifiez-les. Réutilisez un plan déjà actuel dans cette session ; actualisez les fichiers concernés après des modifications structurelles. Les recherches exactes simples, les petits changements dans du code déjà compris et les discussions hors code peuvent se faire directement. Il s'agit d'une habitude de travail, pas d'un processus en arrière-plan ou d'une analyse à chaque tour.
Choisissez l'outil suivant
Choisissez à partir de ce qui est connu sur la cible, et lisez uniquement le sous-guide pertinent. Ces guides appartiennent à cette compétence, pas à des enregistrements de compétences séparés.
| Besoin | Outil | Sous-guide |
|---|---|---|
| Orientation de session, surface de refonte ou investigation de code complexe | ast-grep outline | Planifiez d'abord |
| Chaîne exacte, message d'erreur, nom de fichier ou occurrence d'identifiant simple | rg | Recherche exacte |
| Trouver une implémentation à partir d'une description du comportement | ColGREP / cgrep | Découverte sémantique |
| Syntaxe, relations dans la structure du code, modifications syntaxiques reproductibles | ast-grep | Recherche structurelle |
Commencez par une portée de fichier ou de répertoire étroite lorsque la zone pertinente est connue. Il est normal de découvrir des candidats avec ColGREP, d'inspecter un symbole connu avec rg, et d'affiner un motif syntaxique avec ast-grep. N'exécutez pas les trois automatiquement. Utilisez les outils natifs de l'agent pour la lecture/l'édition de fichiers, les tests et les opérations git.
Les résultats de recherche localisent les candidats ; inspectez la source pertinente avant d'émettre une affirmation comportementale. Ne traitez pas les correspondances syntaxiques comme des références résolues par type.
Une installation canonique sert Codex et Claude Code. Maintenez les conseils sur les outils ici ; ne réinstallez pas de compétences d'outils autonomes et n'activez pas de hooks de recherche en double.