Przejdź do treści
Biblioteka skilli
Programowanie · Przegląd i audyt

gap-scan

/gap-scan

Skanuje jedno lub więcej repozytoriów (kod, commity, dokumentacja, testy, zgłoszenia) i zwraca uszeregowaną listę luk, błędów i pomysłów rozszerzeń z cytowanymi dowodami, gotową do zgłoszeń.

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

Skanuje jedno lub więcej repozytoriów (kod, commity, dokumentacja, testy, zgłoszenia) i zwraca uszeregowaną listę luk, błędów i pomysłów rozszerzeń z cytowanymi dowodami, gotową do zgłoszeń.

Wyzwalacze z opisu

whatfind gapswhat should I work on in this repo

Argumenty

/gap-scan [repo path | owner/repo, ...] [--commits N]
Oryginalny opis (EN)

Survey one or more repos (code, commits, docs, tests, issues) and return a ranked, evidence-cited list of gaps, bugs, and extension ideas as issue-ready items. Read-only apart from its report. Use for "what's missing", "find gaps", "what should I work on in this repo".

Jak działa

  1. 1. Sync
  2. 2. Survey
  3. 3. Rank
  4. 4. Report
Sekcje z nagłówków SKILL.md, w oryginale · 51 linii, 550 słów
Podgląd SKILL.md
---
name: gap-scan
description: Survey one or more repos (code, commits, docs, tests, issues) and return a ranked, evidence-cited list of gaps, bugs, and extension ideas as issue-ready items. Read-only apart from its report. Use for "what's missing", "find gaps", "what should I work on in this repo".
argument-hint: "[repo path | owner/repo, ...] [--commits N]"
---

Read-only. The one write is the report under `skilleddocs/gaps/`. Issues, comments, labels, and board changes each need an explicit yes for that action. Every `gh` call targets the repo resolved per the `next` skill's `BOARD.md`, Target repo section (`-R <o>/<r>`); on a fork, the yes for a write also names the repo it goes to.

No argument: current repo. Several: §1–3 per repo, one combined report. `--commits N` (default 20).

## 1. Sync

- Dirty = tracked changes, or untracked files outside `skilleddocs/` (`git status --porcelain -- . ':!skilleddocs'`), so this skill's own report never makes the next run dirty. Dirty → skip the pull and say so; survey as-is.
- No upstream (`git rev-parse --abbrev-ref @{u}` fails) or no remote (`git remote` prints nothing) → skip the pull, say so (`no upstream, pull skipped`); never set one yourself.
- Clean with an upstream → `git pull --ff-only`; diverged → report it like dirty.
- Fork → `git fetch upstream`; report ahead/behind; also list the parent's open `good first issue`s (`gh issue list -R <parent> --label "good first issue"`; reading the parent is fine).

## 2. Survey

- **Docs vs code**: every README/docs/roadmap claim the code contradicts (or code the docs miss), cited `doc:line` beside `code:line`.
- **Commits**: reverts, repeated fixes to one area (fragile spot), messages admitting shortcuts.
- **`TODO|FIXME|XXX`** in code, by `file:line`.
- **Tests**: find the command. Cheap (no network, GPU, paid calls, credentials) → run it, report failures. Otherwise "tests not run: <why>".
- **Open issues**: `gh issue list -R <o>/<r> --state open --json number,title,labels`. A gap matching one is **already tracked: #n**, listed but not re-proposed. `gh` can't reach issues (non-GitHub remote, not authed, no remote) → `Issues: not checked (<why>)`, and every item's status is `new (issues unchecked)`.
- **UI apps only** (frontend, served site, dashboard), with the `run` skill or a screenshot tool: screenshot the main views and note layout, spacing, style, and dead-link problems, citing screenshot + component. Otherwise "visual pass: skipped (<not a UI app | no tool>)".

## 3. Rank

Value for effort, highest first; the trade-off in one clause. Size `S` (one session, one area) or `L` (multi-area or needs a design call → `divide` candidate). **Evidence or drop it**: every item cites `file:line`, a SHA, or `#n`. A secret is cited by `file:line` or SHA only, never its value, in the report and the reply.

## 4. Report

`skilleddocs/gaps/<local-date>.md`, uncommitted unless asked. Untracked → exclude `skilleddocs/` per [TRACKING.md](../handoff-auto/TRACKING.md) so the next run's tree is clean and `pip install .` isn't broken by it. Per item:

```markdown
### <title>
- Why: <what's missing/broken and why it matters>
- Evidence: <file:line | SHA | #n>
- Size: S | L
- Suggested labels: <bug, enhancement, ...>
- Status: new | new (issues unchecked) | already tracked: #<n>
```

Chat reply:

```
Scanned <repo> (synced clean | dirty, pull skipped | no upstream, pull skipped). 12 candidates → 5 after filters.
Report: skilleddocs/gaps/<date>.md
1. [S] <title> — <why> (path/file.py:42)
2. [L] <title> — <why> (a1b2c3d)
Issues: <N open, M matched | not checked (why)>
Tests: <N passed/failed | not run: why>   Visual: <findings | skipped: why>
```

Then offer, don't run: `kanban-setup` (user-only: tell them to type `/kanban-setup`; board from this list), `divide` (split an `L`), `grill-docs` (stress-test a big call).
Pliki w paczce (2)
  • README.md 8 KB
  • SKILL.md 4 KB

Wersje

W bazie nie ma innych skilli o nazwie gap-scan.

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

  • 100code-gap-sweeping
    Przeszukuje lokalne repozytoria pod kątem luk w implementacji i tworzy deterministyczne, poparte dowodami ścieżki naprawy: brakujące testy, dryf dokumentacji, ryzykowne TODO i FIXME oraz braki higieny wydań.
  • 100docs-gap
    Analizuje zmiany gałęzi wydania pod kątem brakującej dokumentacji dla użytkownika i tworzy raport luk z priorytetami w pliku .md, bez pisania samej dokumentacji.
  • 90find-test-gaps
    Uruchamia agenta test-gap-analyzer na plikach zmienionych w gałęzi lub w katalogu i zwraca brakujące przypadki testowe jako JSON, np. w CI i uruchomieniach bez interfejsu.
  • 90feature
    Implementuje funkcję na podstawie specyfikacji lub zgłoszenia: pisze kod i testy, uruchamia sprawdzenia i zostawia drzewo do przeglądu.
  • 100architecture-scan
    Skanuje duży kod źródłowy i tworzy szczegółowy dokument architektury z dowodami i diagramami, który opisuje strukturę projektu.
  • 100awesome-test-gap-audit
    Wykonuje audyt braków w testach tylko do odczytu: testy brakujące, słabe, nieaktualne lub źle zakresowane, z rankingiem P0-P3 według ryzyka, werdyktem i listą zadań dla awesome-test-writing.

Uwagi i zgłoszenia

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