rpi-explain
/rpi-explain
Przechodzi przez ostatnią zmianę w diffie i wyjaśnia, co się zmieniło i dlaczego, z naciskiem na nieoczywiste decyzje.
Ocena i bezpieczeństwo
- Pliki w paczce
- 1
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 19.07.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
Co robi i kiedy
Przechodzi przez ostatnią zmianę w diffie i wyjaśnia, co się zmieniło i dlaczego, z naciskiem na nieoczywiste decyzje.
Wyzwalacze z opisu
Oryginalny opis (EN)
Walk through a recent diff and explain what changed and why, focusing on non-obvious decisions. Use when user says 'explain the changes', 'walk me through the diff', 'what did we just do?', or 'explain how <feature> was implemented'.
Jak działa
- Goal
- Invariants
- Principles
Podgląd SKILL.md
---
name: rpi-explain
description: Walk through a recent diff and explain what changed and why, focusing on non-obvious decisions. Use when user says 'explain the changes', 'walk me through the diff', 'what did we just do?', or 'explain how <feature> was implemented'.
---
# Explain Implementation
## Goal
Generate a diff-scoped walkthrough of an implemented solution, explaining what changed and why — with focus on non-obvious decisions.
Auto-detect the mode from input:
- **Artifact path** (path to plan, design, or spec) → resolve the artifact chain for context, then walk through the diff
- **No arguments** → auto-detect changed files from git and explain without artifact context
After the initial walkthrough, enter conversation mode — the user can ask follow-up questions to dig deeper into any part of the changes. When done, offer to save the explanation as an artifact if the user wants it.
## Invariants
- If an artifact path is provided, resolve its full chain (plan → design → research) and use as context for attributing rationale (EX-1)
- If no arguments, identify changed files from git and proceed without artifact context (EX-2)
- In no-args mode, search for related designs, plans, or diagnoses matching the diff's topic; cite high-relevance hits as "per the design..." (EX-10)
- If a provided path doesn't exist or has no linked artifacts, proceed with diff-only explanation and note the missing context (EX-3)
- Read all changed files fully before generating explanations — never use limit/offset
- Walk through changes file-by-file, providing a factual summary of what changed in each (EX-4)
- For non-obvious changes, provide explicit callouts explaining the reasoning — inferred from artifacts when available, from code context otherwise (EX-5)
- Clearly distinguish between rationale sourced from artifacts ("per the design...") vs inferred from code context ("based on the surrounding code...") (EX-6)
- Summarize straightforward changes briefly (1-2 sentences) rather than explaining the obvious (EX-7)
- After the walkthrough, invite questions — answer follow-ups by reading additional context as needed
- Do not save an artifact by default — only when the user explicitly requests it (EX-8)
- When saving, scaffold to `.rpi/reviews/` with a descriptive topic (EX-9)
- Include file:line references in all explanations
## Principles
- Explain, don't judge — no pass/fail ratings or severity classifications (that's `/rpi-verify`)
- Be interactive — the initial walkthrough is a starting point, not the final word; follow-up questions are expected
- Attribute your sources — when rationale comes from an artifact, cite it; when inferred, say so; when uncertain, flag it
- Scale to the diff — large diffs get grouped by theme; small diffs get file-by-file detail
- Prioritize the non-obvious — mechanical changes (renames, imports, formatting) get a brief mention; design decisions and behavioral changes get thorough explanation
**Recommended model:** cheap tier, low effort — narrating an existing diff is mechanical. Advisory; see `docs/model-routing.md`.
Wersje
| Repozytorium | Wynik | Licencja |
|---|---|---|
| Ta strona · a-ngj/rpi | 90 | MIT |
| a-ngj/rpi | 90 | MIT |
Migawka bazy z 13.11.2026 · wersja paczki 1894fa668a8c (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 100explain-the-diff
Wyjaśnia kod, który agent właśnie napisał lub zmienił: dlaczego taki projekt, co odrzucono, co może zawieść na produkcji, i zadaje jedno pytanie predykcyjne. - 90explain-code
Tłumaczy początkującemu kod: przechodzi po modułach albo wyjaśnia ostatni commit, czyli co się zmieniło i co by pękło. - 100explain-changes
Wyjaśnia różnice w kodzie i zmiany z wnioskami edukacyjnymi: co się zmieniło, dlaczego i co to znaczy, dla zmian odłożonych, niezacommitowanych lub między gałęziami. - 100explain
Wyjaśnia kod, pojęcie, zmianę lub działanie agenta warstwami, zaczynając od jednego prostego zdania i małego diagramu. - 100summarize-diff
Streszcza różnice w gałęzi Git prostym językiem: co się zmieniło, w którym miejscu i dlaczego ma to znaczenie. - 90rpi-implement
Wykonuje zatwierdzony plan z katalogu .rpi/plans fazami, w podejściu TDD i z weryfikacją po każdej fazie.