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

doc-drift-scanner

/doc-drift-scanner

Skanuje repozytoria pod kątem rozjazdu dokumentacji względem kodu, tworzy zgłoszenie zbiorcze i raporty JSON, np. do notatek z wydania.

Repozytorium
repoman ↗
Licencja
Apache-2.0
Ostatnia zmiana repozytorium
12.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
0
Przestarzałość

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

Licencja

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

Co robi i kiedy

Skanuje repozytoria pod kątem rozjazdu dokumentacji względem kodu, tworzy zgłoszenie zbiorcze i raporty JSON, np. do notatek z wydania.

Oryginalny opis (EN)

Scan enrolled repos for documentation drift against a pinned git boundary: missing paths, flag/subcommand parity, configured enumerations, retired names, version strings, absence claims, and changelog-vs-GitHub-release dates. Creates one rollup issue per repo and writes structured JSON reports. Use when docs may no longer match the code, or when drafting release notes from merged PRs.

Jak działa

  1. Prerequisites
  2. Before Running
  3. Running the Scanner
  4. Optional per-repo config
  5. Precheck (DAM schedules)
  6. Related
Sekcje z nagłówków SKILL.md, w oryginale · 90 linii, 345 słów
Podgląd SKILL.md
---
name: doc-drift-scanner
description: >-
  Scan enrolled repos for documentation drift against a pinned git boundary:
  missing paths, flag/subcommand parity, configured enumerations, retired names,
  version strings, absence claims, and changelog-vs-GitHub-release dates. Creates
  one rollup issue per repo and writes structured JSON reports. Use when docs
  may no longer match the code, or when drafting release notes from merged PRs.
license: Complete terms in LICENSE.txt
---

# Doc Drift Scanner

Scan enrolled repositories for documentation that disagrees with the code at a
pinned git ref. Creates or updates one rollup `[doc-drift]` issue per repo and
writes `latest.json` / `history.json`.

**Run scripts with `--help` first** to see full usage and options. The engine
lives in the RepoMan plugin scripts dir — do not copy it into this skill.

## Prerequisites

- `bash` 3.2+ (works with the macOS system default; no bash-4 features used)
- `python3` 3.8+ (stdlib only; no PyYAML)
- `gh` (GitHub CLI, authenticated with repo access)
- `jq` (JSON processor)
- RepoMan config at `~/.repoman/config.json` with enrolled clones under `repos_dir`

### Requirements (machine-readable)

- pat_scopes: [repo]
- labels_required: []
- labels_applied: [doc-drift]
- programs: [scanner]

## Before Running

### 1. Verify authentication

```bash
gh auth status
```

### 2. Ensure clones are current

Prefer `repoman run repo-sync` (or enable `repo-sync`) so scanners read fresh
trees. The run orchestrator refreshes clones for this program automatically.

### 3. Confirm report location

Reports default to `$HOME/reports/doc-drift`. Override with `REPORTS_DIR`.

## Running the Scanner

Always dry-run first:

```bash
bash "${CLAUDE_PLUGIN_ROOT}/skills/repoman/scripts/doc-drift-scanner.sh" --dry-run
```

Live run (creates/updates/closes rollup issues):

```bash
bash "${CLAUDE_PLUGIN_ROOT}/skills/repoman/scripts/doc-drift-scanner.sh" --issue-limit 5
```

Or via the orchestrator:

```bash
bash "${CLAUDE_PLUGIN_ROOT}/skills/repoman/scripts/repoman-run.sh" doc-drift --dry-run
```

## Optional per-repo config

Repos may commit `.repoman/doc-drift.yaml` at the boundary ref to opt into
enumeration parity, retired-name denylists, and a custom changelog path. Without
it, only generic checks run (paths, flags, versions, absence claims, release
date/draft when GitHub metadata is supplied).

## Precheck (DAM schedules)

`--worklist` is required. Pass a persistent path. The script's default path
sits in a temp directory that is removed on exit, so a bare run prints a
`worklist:` path that is already gone.

```bash
mkdir -p "${REPORTS_DIR:-$HOME/reports/doc-drift}"
bash "${CLAUDE_PLUGIN_ROOT}/skills/repoman/scripts/doc-drift-precheck.sh" \
  --worklist "${REPORTS_DIR:-$HOME/reports/doc-drift}/worklist.json"
```

Exit `1` when the worklist is empty (skip the model turn). Exit `0` and print
`worklist: <path>` when there is work. Any other exit is fail-open. Read the
file at the `--worklist` path you passed; do not use the script's default.

## Related

- Fixer skill: `doc-drift-fixer`
- Friendly name: **Doc-Drift-Manager** (`doc-drift`)

Wersje

W bazie nie ma innych skilli o nazwie doc-drift-scanner.

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

  • 100link-health-scanner
    Skanuje repozytoria organizacji GitHub pod kątem zepsutych linków, porównuje wyniki i zakłada zgłoszenia dla nowych błędów i zamyka naprawione.
  • 100v1-changelog
    Pisze notatki wydania ze scalonych pull requestów, gdy użytkownik prosi o changelog albo podsumowanie wydania.
  • 90release-notes
    Pisze informacje o wydaniu i wpis do CHANGELOG na podstawie commitów i scalonych PR od ostatniego wydania.
  • 90release-notes
    Pisze szkic notatek wydania z scalonych PR-ów i zamkniętych zgłoszeń między dwoma wydaniami, np. dla v2.3.
  • 90release-notes
    Pisze notatki wydania z historii gita, scalonych pull requestów i odwołań do zgłoszeń, także jako changelog.
  • 95release-notes
    Pisze notatki do wydania na podstawie scalonych pull requestów, gdy ktoś prosi o changelog lub listę 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.