git-workflow-enforcer

Ensures commits follow conventional commits, branch naming conventions, and PR templates. Use when creating commits, branches, or PRs, or when user mentions git workflow.

1. Skill aktywuje się automatycznie, gdy zaczniesz tworzyć commit, branch lub pull request, lub gdy wspomniisz o git workflow. Nie wymaga ręcznej instalacji — jest dostępny w Claude.

2. Przed pierwszym użyciem narzędzie skanuje Twój projekt w poszukiwaniu istniejących konwencji: sprawdza katalog .github/ lub .gitlab/ pod kątem szablonów, czyta plik CONTRIBUTING.md, analizuje historię commitów i nazwy branchy. Na tej podstawie dostosowuje się do Twoich standardów.

3. Gdy tworzysz commit, narzędzie waliduje wiadomość zgodnie z conventional commits: typ (feat, fix, docs, style, refactor, perf, test, chore) z opcjonalnym scope w nawiasach, opis w trybie rozkazującym, maksymalnie 50 znaków w tytule. Jeśli body jest dłuższe, powinno być zawinięte na 72 znaki z pustą linią między tytułem a treścią.

4. Dla branchy narzędzie wymusza: małe litery i myślniki zamiast spacji, prefiks typu (feature/, bugfix/, hotfix/, release/, chore/), opisową nazwę, opcjonalnie numer issue'u (np. feature/123-dark-mode). Waliduje każdy branch przed jego utworzeniem.

5. Przy tworzeniu pull requesta narzędzie sprawdza szablon z repozytorium i upewnia się, że PR zawiera wymagane sekcje: opis zmian, typ zmian (feature/fix/docs), powiązane issue'i, instrukcje testowania. Jeśli szablon nie istnieje, sugeruje standardową strukturę.

6. W razie błędu walidacji narzędzie wyświetla konkretne wskazówki: na przykład, jeśli commit ma za długi tytuł, powie dokładnie ile znaków trzeba usunąć, lub jeśli branch nie ma prefiksu, zaproponuje poprawny format. Możesz wtedy poprawić wiadomość lub nazwę i spróbować ponownie.