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ń.
- Autor
- krishp147 ↗
- Repozytorium
- skills ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 20.10.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 2
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 20.10.2026, bez odwołań do wycofanych modeli i API.
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
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. Sync
- 2. Survey
- 3. Rank
- 4. Report
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.