Przejdź do treści
Biblioteka skilli
Programowanie · Analiza

explain-pr

/explain-pr

Wyjaśnia użytkownikowi, co zmieniono na jego gałęzi, i wskazuje zmiany, których nie da się uzasadnić, zanim kod zostanie wysłany.

Repozytorium
tgc-skills ↗
Licencja
MIT
Ostatnia zmiana repozytorium
28.10.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 28.10.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

Wyjaśnia użytkownikowi, co zmieniono na jego gałęzi, i wskazuje zmiany, których nie da się uzasadnić, zanim kod zostanie wysłany.

Wyzwalacze z opisu

explain what we didwalk me through this branchwhat am I about to shipwhy did we change that
Oryginalny opis (EN)

Use before shipping, when the user wants to understand their own branch — "explain what we did", "walk me through this branch", "what am I about to ship", "why did we change that", or any ask to account for the current diff before running tgc-skills:ship. Explains the change back to the user and flags anything it cannot justify. Read-only; not a PR description writer, not a code review.

Jak działa

  1. Steps
  2. Boundaries
Sekcje z nagłówków SKILL.md, w oryginale · 49 linii, 458 słów
Podgląd SKILL.md
---
name: explain-pr
description: Use before shipping, when the user wants to understand their own branch — "explain what we did", "walk me through this branch", "what am I about to ship", "why did we change that", or any ask to account for the current diff before running tgc-skills:ship. Explains the change back to the user and flags anything it cannot justify. Read-only; not a PR description writer, not a code review.
---

# Explain PR — account for the diff before you ship

Walk the user through their own branch: what changed, why, and what neither of you can
justify. Agent-written code ships without ever being understood; this is the checkpoint
that catches it.

**Done:** every change in the diff is either explained with evidence or listed as
unjustified, and the user has decided what to do about the unjustified ones.

**Never:** invent a plausible "why". An unexplained change is the finding. Say `???`.

## Steps

1. **Resolve the diff.** The base is the PR's `baseRefName` when a PR exists, else the
   GitHub default branch. Diff from `git merge-base --fork-point origin/<base> HEAD`
   (falling back to `git merge-base origin/<base> HEAD`), plus uncommitted and
   untracked work. Not on a feature branch, or the diff is empty — say so and stop. Say
   what range you used.
2. **Gather the why, before forming a view.** Commit messages, the branch name, any plan
   or requirements doc the branch touches, the linked issue/PR (`gh`), and this
   conversation. Read the code itself last — it tells you *what*, rarely *why*.
3. **Group into changes, not files.** One entry per intent, however many files it spans.
   A 400-line diff is usually 3-5 real changes.
4. **Explain each one:** what it does, why it exists, and the `file:line` evidence for
   both. Mark the "why" source: commit / plan doc / issue / conversation /
   inferred-from-code. `inferred-from-code` is a weak source — say so.
5. **Flag what has no why.** A change with no evidence trail gets `Why: ???`. Name the
   likely cause: leftover debugging, a speculative abstraction, an agent's
   belt-and-suspenders guard, an unrelated drive-by, or a rename that touched more than
   it meant to. Also flag changes that contradict a plan doc in the repo, and anything
   in the diff the user did not ask for.
6. **Report in the chat.** Never write the explanation to a file, and never offer to.
   Open with `X explained, Y unjustified`, then a numbered list with two or three lines
   per change: what it does, `Why: <reason> (<source>)` or `Why: ???`, and `file:line`.
   Under 400 words for a normal branch. Only an unjustified change earns extra lines:
   name the concrete next move (keep it and say why here, cut it, or split it to its own
   branch). Suggest nothing else — no refactors, no improvements, no review notes.
7. **Hand off.** When `tgc-skills:ship` invoked this skill, return the report to it.
   Otherwise, when the user is satisfied, offer `/tgc-skills:ship`; never run it
   yourself, and never present the branch as ready while unjustified changes are
   unresolved.

## Boundaries

Read-only: never edits code, commits, pushes, or comments on GitHub. Bugs and style
belong to `tgc-skills:polish` and `tgc-skills:review`; the PR body belongs to
`tgc-skills:ship`.

Wersje

RepozytoriumWynikLicencja
Ta strona · eternalllight/tgc-skills90MIT
540/agentic-toolbox100MIT
mryll/skills100MIT

Migawka bazy z 13.11.2026 · wersja paczki c6c9cd2d1b84 (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-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.
  • 96explain-diff-html
    Tworzy bogate wyjaśnienie zmiany w kodzie, diffa, gałęzi lub PR w formie strony HTML.
  • 91explain-diff-html
    Tworzy bogate w HTML wyjaśnienie zmiany w kodzie, gałęzi lub pull requeście, na prośbę użytkownika.
  • 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.
  • 90rpi-explain
    Przechodzi przez ostatnią zmianę w diffie i wyjaśnia, co się zmieniło i dlaczego, z naciskiem na nieoczywiste decyzje.
  • 90rpi-explain
    Przechodzi przez ostatnią zmianę w diffie i wyjaśnia, co się zmieniło i dlaczego, z naciskiem na nieoczywiste decyzje.

Uwagi i zgłoszenia

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