Auditer une base de code avec improve et ne produire que des plans

Pour qui

Si vous voulez qu'un modèle plus fort voie clairement la base de code, juge ce qui vaut la peine, rédige une spécification, puis passe l'exécution à un modèle moins cher, improve convient. Le texte officiel dit : auditer n'importe quelle base de code et écrire des plans d'implémentation pour d'autres agents. La compétence n'implémente rien ; le plan est le livrable.

Le premier passage doit s'arrêter au plan. Elle ne change pas le code source. La seule écriture autorisée est plans/. Si vous voulez que la même compétence change directement le code métier, ce n'est pas le bon choix. L'exécutant ne doit modifier qu'un worktree jetable ; la fusion reste toujours la vôtre. Cette page ne donne aucune commande worktree ; n'en inventez pas.

Les textes publics disent qu'elle fonctionne dans tout agent qui prend en charge le format Agent Skills. Les plans sont du markdown ordinaire, qu'un agent ou une personne peut poursuivre. Aucun client précis n'est nommé. N'ajoutez pas une liste de produits et n'écrivez pas un support exclusif.

Premier essai en 3 minutes

N'utilisez que cette commande d'installation officielle :

npx skills add shadcn/improve

Prérequis : une vraie base de code à auditer, et npx exécutable dans ce projet. Après installation, préparez /improve. N'inventez pas une deuxième méthode d'installation.

L'installation écrit des fichiers de compétence. Avant d'exécuter, confirmez que le répertoire courant est le dépôt à auditer. Après la commande, faites d'abord une vérification sans écrire de plan : l'agent connaît /improve et peut reformuler « n'écrire que plans/, ne pas changer le code source ». C'est le signal de succès observable de l'installation.

Un vrai /improve fait un audit complet, classe les priorités et écrit des plans dans plans/. Confirmez que vous acceptez de nouveaux fichiers de plan markdown, puis :

/improve

Signal de succès : le code source n'a pas été modifié par elle, et plans/ contient des constatations priorisées et des plans d'implémentation. Le matériel public n'indique aucune autre commande slash et ne garantit pas la règle de nommage des fichiers de plan.

Cas d'usage

Cas 1 : audit complet du dépôt courant, puis un plan. Une fois installé, lancez /improve et laissez-le finir audit → constatations priorisées → plan. Lisez d'abord le markdown dans plans/, puis décidez de le passer à quelqu'un d'autre. C'est le flux principal. Les textes publics ne donnent pas une grille de dimensions d'audit ; ne faites pas semblant de déjà savoir quels fichiers seront inspectés.

Cas 2 : passer le plan à un autre agent ou à une personne. Officiellement le plan est du markdown ordinaire que n'importe qui peut reprendre ; cette compétence n'implémente toujours rien. L'exécutant ne doit modifier qu'un worktree jetable ; vous terminez la fusion. Confirmez d'abord le périmètre du plan, puis passez-le. Cette page ne donne ni commande d'exécution ni commande de fusion. Ce cas couvre seulement « transmettre le plan et garder la fusion ».

Limites d'usage

La compétence elle-même ne change jamais le code source. Les écritures vont seulement dans plans/. Ne la traitez pas comme un outil d'auto-refactor ou d'auto-réparation. Ne la laissez pas exécuter le plan dans l'espace de travail principal.

L'installation est seulement npx skills add shadcn/improve. La page ne nomme aucun client, seulement le format Agent Skills. N'ajoutez pas marketplace et ne copiez pas un répertoire skills non fourni.

/improve écrit des fichiers de plan ; confirmez avant d'exécuter. Le matériel public n'a pas d'étapes de désinstallation et ne transforme pas « modèle plus fort / modèle moins cher » en identifiants de modèle obligatoires.

Adresse du dépôt :

https://github.com/shadcn/improve