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

walkthrough

/walkthrough

Przechodzi przez zmiany w pull requeście z perspektywy użytkownika: co widzi w interfejsie, co uruchamia i jak serwer to obsługuje.

Repozytorium
dotfiles ↗
Licencja
MIT
Ostatnia zmiana repozytorium
19.10.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
2
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

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

Przechodzi przez zmiany w pull requeście z perspektywy użytkownika: co widzi w interfejsie, co uruchamia i jak serwer to obsługuje.

Argumenty

/walkthrough [base-branch]
Oryginalny opis (EN)

Walk through PR changes from the user's perspective. Traces each UI change through its full vertical slice — what the user sees, what it triggers, and how the server handles it. Use when asked to walk through what changed, review a PR, or summarize branch changes.

Jak działa

  1. Step 1: Get the diff
  2. Step 2: Identify user-facing entry points
  3. Step 3: Write the walkthrough
Sekcje z nagłówków SKILL.md, w oryginale · 64 linii, 488 słów
Podgląd SKILL.md
---
name: walkthrough
description: Walk through PR changes from the user's perspective. Traces each UI change through its full vertical slice — what the user sees, what it triggers, and how the server handles it. Use when asked to walk through what changed, review a PR, or summarize branch changes.
disable-model-invocation: true
user-invocable-only: true
allowed-tools: Bash, Read, Glob, Grep, Agent
argument-hint: [base-branch]
---

# Walkthrough

Generate a walkthrough of the current branch's changes, organized from the user's perspective.

## Step 1: Get the diff

Determine the base branch in this order:
1. Use `$ARGUMENTS` if the user specifies a branch
2. Use the tracked parent from `git config branch.$(git branch --show-current).parent`, if set and it still resolves to a commit
3. Use `bin/base-branch` if the script exists and is executable
4. Fall back to `develop`

```bash
git diff origin/<base-branch>...HEAD --stat
git diff origin/<base-branch>...HEAD -- <non-test files>
```

Exclude test files, spec files, and doc files from the diff. Focus only on implementation.

## Step 2: Identify user-facing entry points

Entry points are the highest-level changes to the existing system — the places where the diff first touches code that was already there. Trace from these points downward.

Look for:
- New or changed UI components, buttons, forms, modals, pages
- New routes or changed routes
- Changes to Liquid templates, translations
- New action handlers or event registrations

A component that hasn't changed in the diff is never an entry point, even if it renders the result of changed code. The entry point is the changed code that feeds it.

## Step 3: Write the walkthrough

Organize the output as **user flows**, not by file or layer. Each flow starts with what the user sees and traces downward through the code.

### Structure for each flow

1. **Start with the UI change** — what does the user see? A new button, a changed form, a new page? Describe the visible change and reference the file + line.

2. **Trace what happens on interaction** — when the user clicks/submits, what code runs? Follow the chain: event handler → action/service → API call → controller → model. Show each hop as a step.

3. **At each step, only highlight**:
   - New behavior or changed behavior (not just moved code)
   - Complex logic (conditionals, amount calculations, state management)
   - Side effects (jobs enqueued, orders finalized, state mutations)
   - Where data flows between systems (POS → server, server → gateway → redirect back)

4. **Skip entirely**:
   - Import reordering
   - Pure code extraction/refactoring that preserves identical behavior (but DO mention if an extracted function adds new conditions)
   - Boilerplate registration (unless it's the entry point itself)
   - Test files
   - Styling-only changes (unless they change UX behavior)

### Formatting

- Separate flows with a thick unicode rule on its own line: `━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━` (place one before each flow's heading, including the first)
- Use `##` headers for each flow, named from the user's perspective (e.g., "Flow 1: POS Operator generates a pay-by-link")
- Use bold (`**Step N: …**`) for each step within a flow — not `###` headers
- Reference files as `` `filename.ext:line` `` or `` `filename.ext` ``
- Include short code snippets only when they clarify logic that's hard to describe in prose
- Keep descriptions concise — one or two sentences per point
Pliki w paczce (2)
  • SKILL.md 4 KB
  • .claude-plugin/plugin.json 1 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · ryanb/dotfiles100MIT
lablup/backend.ai-webui100LGPL
oborchers/proqi100MIT
frolic/repo-defaults100MIT
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 422f4a13141e (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

  • 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ć.
  • 100v1-pr-walkthrough
    Tłumaczy pull request lub gałąź w formie wizualnego przeglądu, krok po kroku, dla innych osób w zespole.
  • 90walk-the-diff
    Prowadzi interaktywnie przez lokalne zmiany w kodzie przed lub zamiast przeglądu PR, pokazując każdą zmianę po kolei.
  • 100pr-walkthrough
    Generuje jeden plik HTML z przewodnikiem po PR-ze: cel, wpływ na użytkowników, zmiany w interfejsie i ryzyka kompatybilności.
  • 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.

Uwagi i zgłoszenia

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