Explain

Wyjaśnia plik Rails lub cały przepływ użytkownika, zaczynając od historii git

Autor: thoughtbot · thoughtbot/rails-consultant

Działa po konfiguracji ★ 7.6/10

Explain — Wyjaśnia plik Rails lub cały przepływ użytkownika, zaczynając od historii git

Co robi ten skill

Dwutrybowy wyjaśniacz kodu dla baz kodu Rails: skieruj go na plik, klasę lub metodę w celu dokładnego odczytu, lub nazwij przepływ użytkownika, taki jak password reset lub checkout, aby uzyskać schemat blokowy z punktami wejścia, logiką rozgałęzień i efektami ubocznymi. Rozpoczyna się od logu git pliku, więc komunikaty commitów dostarczają „dlaczego” kod nie może. Wywoływany ręcznie jako /explain - ustawia disable-model-invocation, więc nigdy nie uruchamia się z zwykłej rozmowy.

Raport z testu

Skierowano go na prawdziwy passwords_controller.rb Clearance, 115 linii z ośmioletnią historią. Wyjaśnienie na zimno poprawnie obejmuje mechanikę, ale nic nie mówi o tym, dlaczego e-mail resetujący używa deliver_now lub dlaczego akcje zwracają 202 i 303 zamiast 200; obowiązkowy krok otwierający umiejętności, git log plus ostatni diff, ujawnił wszystkie trzy odpowiedzi - PR 882 włączył dostarczanie, aby integratorzy nie potrzebowali procesu w tle, a błędy wysyłki docierały do użytkownika, a PR 965 zmienił kody statusu, ponieważ Turbo nie będzie ponownie renderować 200. To jest różnica między opisem a działającym modelem mentalnym. Haczyk polega na tym, że frontmatter ustawia disable-model-invocation: true, więc żadne z trzech naturalnych sformułowań, które testowałem, nie załadowałoby go - musisz sam wpisać /explain, a README dokumentuje tylko ścieżki instalacji wtyczki i npx, a nie zwykłe kopiowanie katalogu umiejętności, które również działa.

Testowano: 2026-07-30 · Claude Code 2.x (agent harness)

Instalacja

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

Komendy i przykładowe prompty

/explainWyjaśnia plik Rails lub cały przepływ użytkownika, zaczynając od historii git

Skille uruchamiają się na zwykłe polecenia — bez komend do zapamiętania. Po instalacji aktywują go prompty takie jak te (po angielsku):

/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

Pełny raport →