Przejdź do treści
Biblioteka skilli
Programowanie · Nauka i wyjaśnianie

rpi-explain

/rpi-explain

Przechodzi przez ostatnią zmianę w diffie i wyjaśnia, co się zmieniło i dlaczego, z naciskiem na nieoczywiste decyzje.

Repozytorium
rpi ↗
Licencja
MIT
Ostatnia zmiana repozytorium
19.07.2026

Ocena i bezpieczeństwo

90/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść25 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 19.07.2026, bez odwołań do wycofanych modeli i API.

Licencja

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

explain the changeswalk me through the diffwhat did we just do?explain how <feature> was implemented
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

  1. Goal
  2. Invariants
  3. Principles
Sekcje z nagłówków SKILL.md, w oryginale · 39 linii, 432 słów
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

RepozytoriumWynikLicencja
Ta strona · a-ngj/rpi90MIT
a-ngj/rpi90MIT

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.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.