pull-requests
Wytyczne do tworzenia i zarządzania Pull Requestami z automatyczną atrybutacją AI
Instalacja
Wybierz klienta i sklonuj repozytorium do odpowiedniego katalogu skilli.
Instalacja
O skillu
Skill definiuje standardy dla Pull Requestów w repozytorium, w tym obowiązkową atrybutację generowanej zawartości AI, reguły cyklu życia PR-ów oraz procedury walidacji CI. Zapewnia spójność pracy zespołowej poprzez jasne wytyczne dotyczące nazewnictwa gałęzi, rebasowania, aktualizacji PR-ów i sprawdzania statusu przed mergowaniem. Integruje się z narzędziami lokalnymi i skryptami pomocniczymi do weryfikacji zmian.
Jak używać
Przed utworzeniem Pull Requesta upewnij się, że nazwa gałęzi odzwierciedla zakres pracy i że wybrana gałąź bazowa jest prawidłowa — PR-y są zawsze mergowane do gałęzi main za pomocą squash merge.
Jeśli twoja praca opiera się na innym PR-ze, najpierw zrebasuj swoją gałąź na main, aby uniknąć konfliktów i zapewnić czystą historię zmian.
Dodaj do tytułu PR-a emoji 🤖 i umieść w treści PR-a stopkę atrybutacji zawierającą model AI, poziom thinking i koszt. Przed wysłaniem sprawdź zmienne środowiskowe MUX_MODEL_STRING, MUX_THINKING_LEVEL i MUX_COSTS_USD za pomocą bash i wstaw ich wartości do stopki.
Przed wysłaniem PR-a uruchom lokalną walidację, taką jak make static-check lub docelowy podzbiór testów, zamiast czekać na CI, które może trwać ponad 10 minut.
Po lokalnej walidacji użyj skryptu ./scripts/wait_pr_ready.sh z numerem PR-a, aby sprawdzić status wszystkich bramek CI i Codex — skrypt automatycznie zatrzyma się w przypadku błędu terminalnego.
Nigdy nie włączaj auto-merge i nie merguj PR-a samodzielnie do main — zawsze czekaj na jawne zatwierdzenie od użytkownika przed mergowaniem zmian.