git-changes-reporter

Skill do automatycznego tworzenia czytelnych raportów zmian w kodzie. Analizuje zakresy commitów i generuje dokumenty zawierające intencję zmian, kluczowe fragmenty kodu oraz zakres wpływu. Przydatny do przeglądu kodu, notatek wydania, synchronizacji zespołu i pipelinów CI/CD. Obsługuje projekty monorepo poprzez automatyczne wykrywanie granic projektów. Oferuje trzy poziomy szczegółowości analizy — od statystyk podstawowych po pełną ocenę ryzyka i wpływ na system.

1. Przygotuj repozytorium git z dostępnymi commitami, które chcesz analizować. Skill wymaga dostępu do historii gita i będzie skanować pliki w poszukiwaniu markerów projektów (takich jak package.json, Cargo.toml, go.mod).

2. Uruchom skrypt generujący raport JSON, podając stary i nowy commit jako punkty odniesienia. Przykład: generate-json.js HEAD~10 HEAD analizuje ostatnie 10 commitów. Skrypt automatycznie wykryje strukturę projektu i zbierze dane o zmianach w plikach, commitach i autorach.

3. Jeśli pracujesz w monorepo, możesz opcjonalnie określić niestandardowe pliki markerów za pomocą flagi --markers=FILE1,FILE2. Domyślnie skrypt szuka popularnych plików konfiguracyjnych, ale możesz dostosować go do swoich projektów.

4. Przejrzyj wygenerowany JSON zawierający analizę katalogów, listę commitów z konwencjonalnymi typami (feat, fix, refactor), fragmenty kodu i wskaźniki ryzyka. Dane są strukturyzowane w trzech poziomach szczegółowości — wybierz odpowiedni dla swojego przypadku użycia.

5. Przekaż JSON agentowi Claude lub użyj go bezpośrednio do wygenerowania raportu Markdown. Agent przeanalizuje dane, oceni ważność zmian i utworzy czytelny dokument do code review, release notes lub synchronizacji zespołu.

6. Zintegruj skrypt z pipelinenem CI/CD, aby automatycznie generować raporty zmian dla każdej wersji lub pull requestu. Raporty mogą być przechowywane jako artefakty lub wysyłane do kanałów komunikacyjnych zespołu.