← Notes

Utiliser le skill Ponytail — corrections ciblées et tests de régression avec Codex

Sur cette page

Ponytail aide un agent de programmation IA à réutiliser le code existant pour obtenir le comportement demandé. Si l’affichage indique 1 items alors qu’il n’y a qu’un article en stock, commencez par chercher dans le projet une fonction qui gère le singulier et le pluriel. Réutilisez-la pour corriger le libellé, puis vérifiez que les quantités 0 et 2 s’affichent toujours comme avant.

Prendre en main Ponytail dans Codex et Claude Code

Si le skill autonome Ponytail est déjà installé dans Codex, saisissez $ponytail-help dans la conversation pour voir les noms et les modes disponibles. Après $ponytail full, indiquez le comportement à modifier, les conditions à préserver et la commande de vérification. L’exercice ci-dessous utilise le skill autonome installé dans ~/.agents/skills/ponytail/SKILL.md. Dans cette configuration, le mode définit une préférence de travail pour la conversation en cours. Utilisez $ponytail off pour le désactiver. Documentation Codex sur les skills

Le projet Ponytail distribue également un plugin. Pour Codex CLI, exécutez les deux commandes ci-dessous dans votre terminal. Ouvrez ensuite Codex et examinez dans /hooks ce que les deux hooks exécutent. Pour utiliser ces hooks, approuvez-les après examen et démarrez une nouvelle conversation. Leur environnement d’exécution a besoin de node dans son PATH. Guide d’installation de Ponytail

codex plugin marketplace add DietrichGebert/ponytail
codex plugin add ponytail@ponytail

Dans Claude Code, saisissez les deux commandes ci-dessous une par une, puis choisissez le mode avec /ponytail full. Le plugin fournit aussi la commande de revue /ponytail-review. Dans le plugin Codex, le nom du skill de revue comporte le préfixe du plugin, comme dans $ponytail:ponytail-review. Les indications sur l’installation et le fonctionnement des hooks des deux plugins proviennent de la documentation publique. Installation dans Claude Code · Commandes de Ponytail

/plugin marketplace add DietrichGebert/ponytail
/plugin install ponytail@ponytail

Quand utiliser Lite, Full ou Ultra ?

Avec le skill autonome pour Codex, la commande $ponytail seule sélectionne Full, le mode par défaut.

Appel Fonctionnement Exemple
$ponytail lite Traite la demande et signale brièvement une solution plus simple lorsqu’elle présente un avantage concret. Mettre à jour un texte d’interface déjà validé.
$ponytail full Examine le code appelant et les tests existants, puis apporte le plus petit changement qui couvre tout le comportement demandé. Indique les résultats vérifiés et les risques restants. Corriger le libellé au singulier et vérifier aussi les entrées existantes.
$ponytail ultra Traite la demande tout en signalant les élargissements de périmètre superflus. Corriger une erreur sur un écran et examiner séparément si une refonte de l’interface commune se justifie.

Pour limiter le changement, précisez quoi modifier, quoi préserver et comment le vérifier. Parmi les conditions à préserver, pensez aux comportements dont dépend le code appelant, comme les contrôles d’autorisation, la validation des entrées et la protection des données. Le skill guide la façon de travailler de l’agent. Ses paramètres d’autorisation déterminent où il peut écrire et quelles commandes il peut exécuter.

Exercice — afficher 1 item pour un seul article en stock

L’exercice a été exécuté dans un dépôt d’essai vide avec Node.js 22.17.0 et Codex CLI 0.169.0. Pour recréer l’état de départ, utilisez la ligne de retour ci-dessous dans stockLabel. Le premier test de stock.test.mjs était déjà présent au départ. Le second a été ajouté pour ce changement.

return `${count} items`;

Exemple de prompt $ponytail full Corrige le fait que stockLabel(1) renvoie 1 items. Garde items pour 0 et 2. Réutilise la fonction formatCount existante, ajoute un test de régression pour stockLabel et exécute node --test. Ne modifie rien en dehors de ce dépôt d’essai et ne crée pas de commit.

Après la demande de correction, examiner stockLabel et formatCount. Réutiliser formatCount, tester les libellés pour 0, 1 et 2 articles, puis noter les résultats.

Seule l’expression de retour de stockLabel a changé dans stock.mjs. Elle appelle formatCount, qui gère déjà le singulier et le pluriel.

export function formatCount(count, noun) {
  return `${count} ${count === 1 ? noun : noun + 's'}`;
}

export function stockLabel(count) {
  return formatCount(count, 'item');
}

Dans stock.test.mjs, vérifiez les libellés pour les quantités 0, 1 et 2. Placez les deux fichiers dans le même répertoire et exécutez node --test.

import assert from 'node:assert/strict';
import test from 'node:test';
import { formatCount, stockLabel } from './stock.mjs';

test('formatCount handles singular and plural', () => {
  assert.equal(formatCount(1, 'item'), '1 item');
  assert.equal(formatCount(2, 'item'), '2 items');
});

test('stockLabel handles zero, one, and two items', () => {
  assert.equal(stockLabel(0), '0 items');
  assert.equal(stockLabel(1), '1 item');
  assert.equal(stockLabel(2), '2 items');
});

Avec le code d’origine, le test ajouté a échoué pour la quantité 1. Le résultat attendu était 1 item, et le résultat obtenu était 1 items. Après correction, l’exécution a produit la sortie suivante.

ok 1 - formatCount handles singular and plural
ok 2 - stockLabel handles zero, one, and two items
# tests 2
# pass 2
# fail 0

L’exercice couvre deux tests et des modifications dans deux fichiers. Lorsque l’agent a terminé, comparez le git diff réel et les résultats des tests pour vérifier qu’il a réutilisé la fonction existante et respecté le périmètre demandé.

Définir le périmètre de la revue après la correction

Si les skills autonomes complémentaires sont installés, utilisez les appels ci-dessous. Indiquez la partie du code à examiner pour faciliter la vérification des constats. Commandes de Ponytail

Appel Quand l’utiliser
$ponytail-review Examine le diff actuel et le code associé. À utiliser avant d’ouvrir une PR pour contrôler les appels et repérer les tests de régression manquants.
$ponytail-audit Examine le dépôt entier en lecture seule et classe les problèmes détectés par priorité.
$ponytail-debt Recense les commentaires shortcut: et les anciens commentaires ponytail: pour examen.
$ponytail-gain Affiche le rapport de benchmark publié par le projet. Pour mesurer les gains de temps ou de coût dans votre dépôt, effectuez une comparaison distincte.
$ponytail-help Affiche les modes et les appels des skills installés.

Discussion

Voir sur GitHub ↗