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.
- Autor
- rossoctl ↗
- Repozytorium
- repoman ↗
- Licencja
- Apache-2.0
- Ostatnia zmiana repozytorium
- 12.11.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 1
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 12.11.2026, bez odwołań do wycofanych modeli i API.
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
- Prerequisites
- Before Running
- Running the Scanner
- Optional per-repo config
- Precheck (DAM schedules)
- Related
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.