Explain

Forklarer en Rails-fil eller en hel brukerflyt, med utgangspunkt i git-historikken

av thoughtbot · thoughtbot/rails-consultant

Krever oppsett ★ 7.6/10

Explain — Forklarer en Rails-fil eller en hel brukerflyt, med utgangspunkt i git-historikken

Hva den gjør

To-modus kodeforklarer for Rails-kodebaser: pek den mot en fil, klasse eller metode for en grundig lesing, eller navngi en brukerflyt som passordtilbakestilling eller utsjekk for et flytskjema med bokser pluss inngangspunkter, forgreninglogikk og bivirkninger. Den åpner med filens git-logg slik at commit-meldinger gir 'hvorfor' koden ikke kan. Påkalles manuelt som `/explain` – den setter `disable-model-invocation`, så den utløses aldri fra vanlig samtale.

Testrapport

Pekte den mot Clearances ekte `passwords_controller.rb`, 115 linjer med åtte års historie. Å forklare den uten forberedelse dekker mekanikken korrekt, men sier ingenting om hvorfor tilbakestillings-e-posten bruker `deliver_now` eller hvorfor handlingene returnerer 202 og 303 i stedet for 200; ferdighetens obligatoriske åpningstrinn, git logg pluss den siste diffen, avdekket alle tre svarene – PR 882 inlinet levering slik at integratorer ikke trenger en bakgrunnsarbeider og slik at sendefeil når brukeren, og PR 965 endret statuskodene fordi Turbo ikke vil gjengi en 200. Det er forskjellen mellom en beskrivelse og en fungerende mental modell. Haken er at frontmatter setter `disable-model-invocation: true`, så ingen av de tre naturlige formuleringene jeg testet ville laste den – du må skrive `/explain` selv, og README dokumenterer bare plugin- og `npx`-installasjonsstiene, ikke den vanlige kopien av ferdighetskatalogen som også fungerer.

Testet på: 2026-07-30 · Claude Code 2.x (agent harness)

Installer

git clone https://github.com/thoughtbot/rails-consultant.git
mkdir -p ~/.claude/skills
cd rails-consultant && cp -r skills/explain ~/.claude/skills/explain

Kommandoer og eksempelprompter

/explainForklarer en Rails-fil eller en hel brukerflyt, med utgangspunkt i git-historikken

Skills utløses av vanlige forespørsler — ingen kommandoer å huske. Etter installasjonen aktiverer prompter som disse skillen (på engelsk):

/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

Full rapport →