Document Release

Dziewięcioetapowy audyt dokumentacji po wydaniu: wykrywa nieaktualne README, CHANGELOG i TODOs

Autor: DollarDill · DollarDill/beads-superpowers

Działa po konfiguracji ★ 8.8/10

Document Release — Dziewięcioetapowy audyt dokumentacji po wydaniu: wykrywa nieaktualne README, CHANGELOG i TODOs

Co robi ten skill

Audytuje każdy plik .md w repozytorium w porównaniu z różnicą ukończonej gałęzi funkcji, tak aby tabele README, notatki ARCHITECTURE, CLAUDE.md, CHANGELOG i TODOS odpowiadały temu, co faktycznie zostało wydane. Samodzielnie stosuje poprawki faktyczne, ocenia wpisy CHANGELOG według rubryki co-się-zmieniło/dlaczego-to-ważne/jak-używać i odmawia podniesienia VERSION bez pytania. Uruchamia się na 'update docs', 'documentation audit', 'sync documentation' lub na gałęzi, która ma zostać połączona lub zgłoszona do PR.

Raport z testu

Przeprowadzono oba przejścia na prawdziwej gałęzi, która dostarczyła flagę --json i zmienną środowiskową TEXTKIT_TIMEOUT do repozytorium z celowo nieaktualną dokumentacją. Test sprzedażowy CHANGELOG umiejętności przepisał wpis w stylu commit, który nigdy nie wspominał o dostarczonej fladze, na linie 'You can now' skierowane do użytkownika i usunął wewnętrzny tag bd-0412 z prozy skierowanej do czytelnika; przejście bez pomocy pozostawiło ten wpis nietknięty i pominęło również nowy plik źródłowy w drzewie projektu CLAUDE.md. Zatrzymuje się i pyta przed podniesieniem VERSION, decyzja, której podstawowy test nigdy nie ujawnił. Haczyk tkwi w integracji Beads, wplecionej w cztery z jego kroków: `bd create` zwróciło 'no beads database found' w świeżym repozytorium, więc najpierw należy zaplanować `brew install beads` plus `bd init` dla każdego repozytorium. Jego zasada diagramu oznacza również, że diagram architektury ASCII nazywający zmienioną nazwę klasy jest oznaczany, a nie naprawiany.

Testowano: 2026-08-05 · Claude Code 2.x (agent harness)

Instalacja

git clone https://github.com/DollarDill/beads-superpowers.git
mkdir -p ~/.claude/skills
cd beads-superpowers && cp -r skills/document-release ~/.claude/skills/document-release

Komendy i przykładowe prompty

  • /document-releaseDziewięcioetapowy audyt dokumentacji po wydaniu: wykrywa nieaktualne README, CHANGELOG i TODOs

Skille uruchamiają się na zwykłe polecenia — bez komend do zapamiętania. Po instalacji aktywują go prompty takie jak te (po angielsku):

  • This branch is done, update the docs before I open the PR
  • Run a documentation audit against this feature branch
  • Sync the README and CHANGELOG with what we actually shipped