Explain
Explique un fichier Rails ou un flux utilisateur complet, en partant de l'historique git
Fonctionne avec configuration
Ce que fait
Explicateur de code à deux modes pour les bases de code Rails : pointez-le vers un fichier, une classe ou une méthode pour une lecture approfondie, ou nommez un flux utilisateur comme la réinitialisation de mot de passe ou le paiement pour un organigramme avec points d'entrée, logique de branchement et effets secondaires. Il s'ouvre avec le git log du fichier afin que les messages de commit fournissent le 'pourquoi' que le code ne peut pas. Invoqué manuellement comme /explain - il définit disable-model-invocation, donc il ne se déclenche jamais à partir d'une conversation simple.
Rapport de test
L'a pointé vers le véritable passwords_controller.rb de Clearance, 115 lignes avec huit ans d'historique. L'expliquer à froid couvre correctement la mécanique mais ne dit rien sur la raison pour laquelle le mail de réinitialisation utilise deliver_now ou pourquoi les actions renvoient 202 et 303 au lieu de 200 ; l'étape d'ouverture obligatoire de la compétence, git log plus le dernier diff, a fait surface les trois réponses - la PR 882 a intégré la livraison afin que les intégrateurs n'aient pas besoin de worker en arrière-plan et que les échecs d'envoi atteignent l'utilisateur, et la PR 965 a modifié les codes de statut car Turbo ne re-rendra pas un 200. C'est la différence entre une description et un modèle mental fonctionnel. Le hic est que le frontmatter définit disable-model-invocation: true, donc aucune des trois formulations naturelles que j'ai testées ne le chargerait - vous devez taper /explain vous-même, et le README ne documente que les chemins d'installation du plugin et npx, pas la simple copie du répertoire des compétences qui fonctionne également.
Testé le: 2026-07-30 · Claude Code 2.x (agent harness)
Installation
git clone https://github.com/thoughtbot/rails-consultant.git mkdir -p ~/.claude/skills cd rails-consultant && cp -r skills/explain ~/.claude/skills/explain
Commandes et exemples de prompts
/explainExplique un fichier Rails ou un flux utilisateur complet, en partant de l'historique git
Les skills se déclenchent sur des demandes en langage courant — aucune commande à retenir. Après installation, des prompts comme ceux-ci l'activent (en anglais) :
/explain app/controllers/clearance/passwords_controller.rb, why deliver_now?/explain the checkout flow, draw the entry points and side effects/explain how password reset works in this app, starting from git history