Przejdź do treści
Biblioteka skilli
Programowanie · Analiza

code-gap-sweeping

/code-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ń.

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

Brak sygnałów. Repozytorium zmienione 28.08.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co sprawdzić przed instalacją
  • 2 skrypty w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.

Skrypty: scripts/code_gap_sweep.py, scripts/repo_family_pipeline.py

Co robi i kiedy

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ń.

Oryginalny opis (EN)

Sweep one or more local repositories for implementation gaps and produce deterministic, evidence-backed remediation lanes. Use when you need cross-repo detection of missing tests, docs lockstep drift, risky TODO/FIXME additions, and release-hygiene misses.

Jak działa

  1. Workflow
  2. Canonical Run
  3. Scope Boundary
  4. Gap Contracts
  5. Triage Mapping
  6. Output
  7. References
  8. Loopback
Sekcje z nagłówków SKILL.md, w oryginale · 111 linii, 385 słów
Podgląd SKILL.md
---
name: code-gap-sweeping
description: Sweep one or more local repositories for implementation gaps and produce deterministic, evidence-backed remediation lanes. Use when you need cross-repo detection of missing tests, docs lockstep drift, risky TODO/FIXME additions, and release-hygiene misses.
---

# Code Gap Sweeping

Use this skill to run a repeatable cross-repo gap scan and convert findings into concrete follow-up actions.

## Workflow

1. Run the gap sweep script across one or more local repos.
2. Review severity-ranked findings (`critical`, `high`, `medium`).
3. Route each finding into the smallest existing skill lane that can fix it.
4. Emit machine-readable evidence for admission, planning, and release notes.
5. For repeated multi-repo operations, generate a deterministic repo-family command matrix.

## Canonical Run

```bash
python3 "$CODEX_HOME/skills/code-gap-sweeping/scripts/code_gap_sweep.py" \
  --repo "<PRIVATE_REPO_A>=/path/to/<PRIVATE_REPO_A>" \
  --repo "<PRIVATE_REPO_B>=/path/to/<PRIVATE_REPO_B>" \
  --since-days 14 \
  --json-out /tmp/code-gap-sweep.json
```

One-command sweep for all repos under a workspace root:

```bash
python3 "$CODEX_HOME/skills/code-gap-sweeping/scripts/code_gap_sweep.py" \
  --repos-root "$env:USERPROFILE\\Documents\\GitHub" \
  --exclude-repo "docs" \
  --since-days 14 \
  --json-out /tmp/code-gap-sweep-all.json
```

Working-tree focused sweep during active local edits:

```bash
python3 "$CODEX_HOME/skills/code-gap-sweeping/scripts/code_gap_sweep.py" \
  --repo "skill-arbiter=." \
  --diff-mode working-tree \
  --json-out /tmp/code-gap-sweep-working-tree.json
```

Full pipeline matrix for repo families (`repo_a`/`repo_b`/`repo_c`/`repo_d`):

```bash
python3 "$CODEX_HOME/skills/code-gap-sweeping/scripts/repo_family_pipeline.py" \
  --repo "<PRIVATE_REPO_A>=/path/to/<PRIVATE_REPO_A>" \
  --repo "<PRIVATE_REPO_B>=/path/to/<PRIVATE_REPO_B>" \
  --repo "<PRIVATE_REPO_C>=/path/to/<PRIVATE_REPO_C>" \
  --repo "<PRIVATE_REPO_D>=/path/to/<PRIVATE_REPO_D>" \
  --family "<PRIVATE_REPO_A>=repo_a" \
  --family "<PRIVATE_REPO_B>=repo_b" \
  --family "<PRIVATE_REPO_C>=repo_c" \
  --family "<PRIVATE_REPO_D>=repo_d" \
  --since-days 14 \
  --json-out /tmp/repo-family-pipeline.json \
  --bash-out /tmp/repo-family-pipeline.sh
```

## Scope Boundary

Use this skill when the primary task is detecting and prioritizing implementation gaps across repositories.

Do not use this skill for:

1. Skill install/quarantine decisions (use `skill-arbiter-lockdown-admission`).
2. Skill discovery portfolio curation (use `skills-discovery-curation`).
3. Repo-specific deep debugging where a dedicated repo skill exists.

## Gap Contracts

The script detects deterministic gap categories:

1. `tests_missing`: code changed without corresponding test changes.
2. `docs_lockstep_missing`: behavior-impacting files changed without docs updates.
3. `todo_fixme_added`: newly introduced `TODO`/`FIXME` markers in the patch window.
4. `release_hygiene_missing`: release-impacting changes without `pyproject.toml` + `CHANGELOG.md` updates.

## Triage Mapping

Route findings consistently:

1. `tests_missing` -> repo-specific execution/test lane.
2. `docs_lockstep_missing` -> `docs-alignment-lock`.
3. `todo_fixme_added` -> repo-specific cleanup lane, then re-sweep.
4. `release_hygiene_missing` -> `skill-arbiter-release-ops`.

## Output

JSON report includes:

- scan metadata (`generated_at`, `since_days`, repo list)
- per-repo findings with severity and evidence
- aggregate counters by category and severity
- suggested skill lanes for remediation

## References

- `references/gap-rubric.md`
- `scripts/code_gap_sweep.py`
- `references/repo-family-pipeline.md`
- `scripts/repo_family_pipeline.py`

## Loopback

If this lane is unresolved, blocked, or ambiguous:

1. Capture the JSON report path and unresolved findings.
2. Route back through `$skill-hub` for chain recalculation.
3. Resume only after the updated chain returns a deterministic next step.
Pliki w paczce (6)
  • SKILL.md 4 KB
  • agents/openai.yaml 1 KB
  • references/gap-rubric.md 1 KB
  • references/repo-family-pipeline.md 2 KB
  • scripts/code_gap_sweep.py 16 KB
  • scripts/repo_family_pipeline.py 19 KB

Wersje

W bazie nie ma innych skilli o nazwie code-gap-sweeping.

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

  • 84scan-todos
    Przeszukuje komentarze w kodzie źródłowym pod kątem znaczników TODO, FIXME, HACK i XXX i dla każdego rozwiązuje problem lub zakłada zgłoszenie.
  • 100import-todos
    Wyszukuje komentarze TODO i FIXME w kodzie i zamienia wybrane z nich w pliki zadań.
  • 100import-todos
    Znajduje w bazie kodu komentarze TODO i FIXME i przekształca wskazane w śledzone zadania w plikach.
  • 100todo-sweep
    Przegląda komentarze TODO i FIXME w kodzie w lokalnym panelu i zapisuje raport bez zmiany plików źródłowych.
  • 100fill-the-gaps
    Uzupełnia pracę w toku, którą użytkownik zostawił niedokończoną celowo: gołe sygnatury, puste moduły, pseudokod, usunięty kod i znaczniki AI TODO, AI FIXME oraz AI NOTE.
  • 100accelint-ts-documentation
    Audytuje i poprawia dokumentację JavaScript i TypeScript: komentarze JSDoc, znaczniki TODO i FIXME oraz jakość komentarzy w kodzie.

Uwagi i zgłoszenia

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