git-commit-specification

Umożliwia Ci pisanie commitów zgodnie ze standardem branżowym. Definiuje formaty wiadomości (feat, fix, refactor, perf, test, docs, chore, del), konwencje nazewnictwa gałęzi (feature/, bugfix/, hotfix/) i procedury przygotowania pull requestów. Zawiera szybki przewodnik typów zmian, przykłady commitów z numerami issue oraz checklist przed wysłaniem kodu. Idealne dla zespołów pracujących nad CI/CD i pipelinami budowania.

1. Zainstaluj umiejętność w swoim środowisku MCP lub agencje AI – sprawdź dokumentację repozytorium TencentBlueKing, aby pobrać najnowszą wersję z gałęzi master.

2. Przed każdym commitem zapoznaj się z typami zmian: użyj feat dla nowych funkcji, fix dla poprawek błędów, refactor dla zmian strukturalnych, perf dla optymalizacji wydajności, test dla testów, docs dla dokumentacji, chore dla zmian w narzędziach budowania, del dla usunięć wymagających specjalnej zgody.

3. Formatuj wiadomość commita zgodnie ze standardem: zacznij od typu zmany, dwukropka i spacji, następnie krótki opis, na końcu dodaj numer issue (np. feat: dodaj obsługę szablonów pipeline'u #1234). Opcjonalnie dodaj zakres w nawiasach: feat(process): opis.

4. Podczas tworzenia nowej gałęzi stosuj konwencję nazewnictwa: feature/nazwa-funkcji dla nowych funkcji, bugfix/nazwa-problemu dla poprawek, hotfix/nazwa-krytycznego-problemu dla pilnych zmian.

5. Przed przesłaniem pull requesta wykonaj rebase, aby wyczyścić historię commitów: uruchom git rebase -i HEAD~5 (dostosuj liczbę commitów do potrzeb), a następnie zsynchronizuj z kodem upstream za pomocą git fetch upstream i git rebase upstream/develop.

6. Przed finalnym push'em sprawdź checklist: commit message jest zgodny z formatem, issue jest powiązany, commity zostały wyczyszczone rebase'em, brak danych wrażliwych w kodzie, kod przeszedł testy lokalne.