docs-changelog
Automatyzuj tworzenie plików changelog na podstawie informacji z wydań GitHub
Instalacja
Wybierz klienta i sklonuj repozytorium do odpowiedniego katalogu skilli.
Instalacja
O skillu
Skill docs-changelog standaryzuje proces aktualizacji plików changelog (latest.md, preview.md, index.md) dla nowych wersji. Na podstawie numeru wersji, znacznika czasu i surowych notatek wydania z GitHub, narzędzie generuje sformatowane wpisy changelog z wyróżnionymi zmianami. Obsługuje zarówno wydania stabilne, jak i wersje preview, automatycznie pomijając wydania nightly. Wyodrębnia kluczowe funkcje i poprawki, formatuje linki do pull requestów oraz dostosowuje zawartość do wytycznych stylu dokumentacji.
Jak używać
Przygotuj dane wejściowe: zbierz numer wersji (np. v0.28.0 lub v0.29.0-preview.2), znacznik czasu wydania w formacie ISO (np. 2026-02-12T20:33:15Z) oraz surową zawartość notatek wydania z GitHub, zawierającą sekcję "What's Changed" i link do pełnego changelog.
Zainicjuj analizę wersji: skill automatycznie określi ścieżkę przetwarzania na podstawie numeru wersji. Jeśli wersja zawiera "nightly", proces zostanie zatrzymany. Dla wersji kończących się na ".0" (np. v0.28.0) stosowana jest procedura dla nowej wersji minor. Dla pozostałych wersji (patch releases) używana jest procedura dla wydań poprawek.
Przetwarzaj znacznik czasu: skill skonwertuje dostarczony czas na dwa formaty: yyyy-mm-dd oraz "Month dd, yyyy", które będą użyte w wygenerowanych plikach changelog.
Przetwarzaj zawartość wydania: surowe dane z notatek wydania zostaną przeanalizowane, a linki do pull requestów zostaną sformatowane jako linki markdown z numerem PR jako tekst (np. #12345).
Generuj wpisy changelog: skill utworzy 3-5 kluczowych punktów wyróżniających dla plików latest.md i preview.md. Każdy punkt będzie rozpoczynać się pogrubioną nazwą zmiany (np. New Feature: opis). Narzędzie automatycznie będzie priorytetyzować nowe funkcje nad poprawkami błędów i będzie unikać wymieniania funkcji eksperymentalnych w wydaniach stabilnych.
Aktualizuj pliki changelog: wygenerowane wpisy zostaną wstawione do odpowiednich plików (latest.md dla wydań stabilnych, preview.md dla wersji preview, index.md dla archiwum), zachowując spójność formatowania i struktury dokumentacji.