Skill ast-grep : chercher du code par structure syntaxique, pas seulement par texte

À qui cela s'adresse

Utilisez ce skill quand vous voulez qu'un assistant de programmation cherche selon la structure du code (arbre de syntaxe abstrait), et pas seulement par correspondance de texte. Officiellement, il se trouve dans la place de plugins de Claude Code et fournit la recherche structurelle ast-grep.

Prérequis : ast-grep est déjà installé sur cette machine, et l'assistant peut installer des skills. Le guide n'explique pas comment installer ast-grep lui-même ; n'inventez pas d'installateur. Le guide nomme Claude Code ; ne présentez pas d'autres clients comme exclusifs officiels. La possibilité d'utiliser autre chose que cet ensemble nommé n'est pas indiquée.

Il n'y a qu'un chemin d'installation : une seule commande npx. Après l'installation, vous devez demander explicitement d'utiliser le skill dans la question, par exemple "Use ast-grep to find...". Le guide indique qu'en novembre 2025, Claude Code ne peut toujours pas décider automatiquement d'utiliser ast-grep dans toutes les situations adaptées. Le guide ne nomme aucun répertoire de destination ; après l'installation, confirmez seulement dans l'assistant actuel que le skill peut être invoqué par son nom.

Premier essai en 3 minutes

Page officielle :

https://github.com/ast-grep/agent-skill

Vérifiez d'abord que ast-grep local fonctionne, puis lancez l'installation recommandée (elle écrit des fichiers de skill sur cette machine ; vérifiez d'abord le nom du dépôt) :

npx skills add ast-grep/agent-skill

Si la commande échoue, arrêtez-vous. Après succès, ne modifiez pas d'abord le code applicatif. Ouvrez un dépôt existant et dites clairement en langage naturel : Use ast-grep to find..., plus une cible structurelle à faible risque, par exemple trouver une certaine forme d'appel de fonction. Demandez à l'assistant d'abord d'analyser si ast-grep convient, d'écrire des exemples et des règles de correspondance, et de tester d'abord sur les exemples.

Signal de succès : l'assistant a explicitement utilisé ast-grep, la règle a été vérifiée sur les exemples, et les résultats sur tout le dépôt incluent chemins de fichiers et numéros de ligne. S'il veut écrire un fichier de règles ou modifier le code applicatif, arrêtez-le d'abord et confirmez les effets de bord avant de continuer.

Cas d'usage

Cas 1 : recherche structurelle en lecture seule. La question doit nommer ast-grep explicitement. Faites trouver les correspondances par structure et renvoyer chemins de fichiers et numéros de ligne. Au premier passage, regardez seulement les résultats ; ne le laissez pas refactoriser au passage. Le guide ne donne ni périmètre de langages ni dépôt d'exemple ; n'inférez pas à partir d'une liste de langages imaginée.

Cas 2 : écrire d'abord la règle, la vérifier, puis chercher dans tout le dépôt. Les étapes du guide sont : analyser si la requête convient à ast-grep, créer du code d'exemple pour la correspondance, écrire la règle, la tester sur l'exemple, chercher dans tout le dépôt seulement après réussite, puis indiquer chemins et numéros de ligne. La recherche globale n'est permise qu'après réussite du test d'exemple. Le guide n'écrit ni chemin de fichier de règles ni drapeaux CLI ; n'inventez pas ce qui manque.

Limites

Le chemin principal ne documente que :

npx skills add ast-grep/agent-skill

Cette machine doit déjà avoir ast-grep installé. Le déclenchement doit le nommer explicitement, par exemple "Use ast-grep to find..." ; n'attendez pas une sélection automatique dans toutes les situations.

La capacité n'est étayée que pour la recherche structurelle et la chaîne « exemple → règle → test → dépôt entier → chemin et numéro de ligne ». Il est décrit comme un skill de la place de plugins Claude Code, mais au premier essai ne passez pas par des clics de place de plugins qui n'apparaissent jamais.

Le guide ne documente ni commandes d'installation d'ast-grep, ni facturation, ni périmètre de langages, ni répertoire de destination. Le premier passage est une recherche en lecture seule ; n'en faites pas une porte d'entrée vers le refactoring. Ce qui n'a pas de source reste inconnu ; n'inventez pas d'opérations.