Przejdź do treści
Biblioteka skilli
Programowanie · Pisanie

walkthrough

/walkthrough

Pisze dla recenzenta omówienie pull requesta uporządkowane według wagi zmian.

Repozytorium
repo-defaults ↗
Licencja
MIT
Ostatnia zmiana repozytorium
09.11.2026

Ocena i bezpieczeństwo

100/ 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ść35 / 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
1
Przestarzałość

Brak sygnałów. Repozytorium zmienione 09.11.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

Pisze dla recenzenta omówienie pull requesta uporządkowane według wagi zmian.

Oryginalny opis (EN)

Write a reviewer's walkthrough of a pull request, ordered by what matters instead of by file. Use when a PR is ready for review, or when someone asks to walk through a change.

Jak działa

  1. Get the diff
  2. Order the changes
  3. Make hard parts easy to check
  4. Write it
  5. Where it goes
Sekcje z nagłówków SKILL.md, w oryginale · 43 linii, 515 słów
Podgląd SKILL.md
---
name: walkthrough
description: Write a reviewer's walkthrough of a pull request, ordered by what matters instead of by file. Use when a PR is ready for review, or when someone asks to walk through a change.
---

# Walkthrough

Write a walkthrough that gets a reviewer to understand one pull request as fast as possible. Order it by what matters, not by file path.

Adapted from `pr-review-canvas` in [cursor/plugins](https://github.com/cursor/plugins/tree/main/pr-review-canvas) (MIT, Cursor). That version renders a Cursor Canvas. This one writes Markdown.

## Get the diff

Work from one pull request: a number or a URL. If none was given, ask for it. Don't guess from the current branch.

Read the PR with the GitHub MCP tools (`pull_request_read` for the files and the diff) or `git diff origin/main...<head>` on a checkout. Read the PR body and the commit messages too, because they hold the reasons.

## Order the changes

1. **Core logic.** New behaviour, changed rules, state changes, and changes to a public interface or a stored format. Show the hunks that matter, with enough context to read them.
2. **Wiring.** Routes, layers, config, and call sites that connect the core change. Condense these to what a reviewer needs to confirm they're right.
3. **Mechanical.** Renames, moved files, formatting, re-exports, and generated code. List the files with their line counts. Show no diff unless one matters.

Put the core logic first, while the reviewer's attention is fresh. A change to a stored format or a normative doc is always core logic, because it changes a format or a rule.

## Make hard parts easy to check

- **Pseudocode.** When a core hunk is dense (nested conditions, a state machine, a retry loop), add a few lines of pseudocode that show the control flow without the syntax and error handling. Skip it when the diff is easy to read.
- **A traced example.** When a change alters behaviour in a way that's hard to predict, pick one small realistic input and walk it through the old and the new code. Name the step where they differ and the result someone would see.
- **Callouts.** Mark something surprising or easy to miss with a short tag (**Subtle**, **Breaking**, **Race**, **Format**, **Perf**) and one sentence. Use them rarely, or they stop meaning anything.
- **A picture.** When a flow has three or more moving parts, a small mermaid diagram often beats prose. Use one only when it helps.

## Write it

Follow `writing.md`. Write for the reviewer, not as a changelog:

- Use plain words. Name a function or a file only where the reviewer needs it to find the code.
- Say why each part changed, not only what changed.
- Say how the files connect: "The new check in `validateOrder.ts` runs on the route added in `orderRoutes.ts`."
- Say what the diff alone doesn't show: a test that proves a claim, a caller outside the diff, a trade-off that was considered.

Keep each note to one or two sentences.

## Where it goes

Post the walkthrough as one comment on the pull request, ending with the attribution footer. If the PR already has a walkthrough comment, update it instead of adding a second one. A walkthrough longer than about 150 lines is a sign the PR should be split. Say so at the top.

Wersje

RepozytoriumWynikLicencja
Ta strona · frolic/repo-defaults100MIT
lablup/backend.ai-webui100LGPL
oborchers/proqi100MIT
ryanb/dotfiles100MIT
glebis/humane-agentic-design100MIT
rustyrazorblade/skills100Apache-2.0
udecode/kitcn100Apache-2.0
smallnest/goal-workflow100MIT
adamos486/skills100MIT

Migawka bazy z 13.11.2026 · wersja paczki 6bd1dc25e683 (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

  • 100v1-pr-walkthrough
    Tłumaczy pull request lub gałąź w formie wizualnego przeglądu, krok po kroku, dla innych osób w zespole.
  • 100aw-create-walkthrough
    Tworzy jednostronicowy przegląd zakończonej pracy w pliku walkthrough.md: co się zmieniło, jakie przyjęto założenia i jakie są dowody, przed szkicem pull requesta.
  • 90bmad-walkthrough
    Prowadzi użytkownika przez przegląd zmiany: po co jest, na co patrzeć uważnie i jak ją przetestować.
  • 90bmad-walkthrough
    Prowadzi użytkownika przez przegląd zmiany: po co jest, na co patrzeć uważnie i jak ją przetestować.
  • 90pr-review-canvas
    Przedstawia przegląd diffu jako interaktywny przewodnik, grupując zmiany według wagi dla recenzenta i oddzielając szablony od kluczowej logiki.
  • 100record-pr-demo
    Przygotowuje zwięzłe wizualne omówienie pull requestu w projekcie Payload, które pomaga recenzentom zrozumieć wprowadzaną zmianę.

Uwagi i zgłoszenia

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