Integracja GitHub
Połącz swoje repozytoria GitHub z SprintFlint, aby automatycznie łączyć pull requesty z problemami, tworzyć rozgałęzienia i śledzić zmiany w kodzie.
Podłączanie GitHub
Aby połączyć swoją organizację z GitHub:
- Kliknij swój awatar na pasku bocznym
- Przejdź do „Ustawień organizacji”
- Kliknij „Połącz GitHub”
- Autoryzuj SprintFlint, aby uzyskać dostęp do twoich repozytoriów
Uprawnienia - SprintFlint żąda dostępu do odczytu twoich repozytoriów. Używamy tego do wykrywania pull requestów i łączenia ich z problemami. Nigdy nie modyfikujemy Twojego kodu.
Łączenie repozytorium z projektem
Po podłączeniu GitHub na poziomie organizacji połącz konkretne repozytoria z projektami:
- Przejdź do ustawień projektu
- Wybierz repozytorium z listy rozwijanej
- Zapisz projekt
Automatyczne wykrywanie PR
SprintFlint automatycznie wykrywa pull requesty i łączy je z problemami, skanując numer problemu (np. PROJ-123) w:
- Nazwa gałęzi - e.g.,
feature/PROJ-123-user-auth,proj-123-auth,proj123 - Tytuł PR - np. „PROJ-123: Dodaj uwierzytelnienie użytkownika”
- Opis PR - np. „Ten PR implementuje PROJ-123”
Typowe słowa kluczowe, takie jak fixes, closeslub resolves są obsługiwane, ale opcjonalne – wystarczy sam numer wydania.
Tworzenie gałęzi
SprintFlint może tworzyć gałęzie dla problemów bezpośrednio z interfejsu użytkownika:
- Otwórz problem
- Na pasku bocznym kliknij „Utwórz gałąź”
- SprintFlint tworzy gałąź i otwiera pulpit GitHub
Nazewnictwo gałęzi
Podczas tworzenia gałęzi za pomocą SprintFlint lub korzystania z funkcji Autoplay, gałąź otrzymuje nazwę automatycznie przy użyciu prefiksu projektu, po którym następuje numer wydania i tytuł wygenerowany przez AI. Programiści muszą po prostu podać numer wydania lub uwzględnić go w nazwie gałęzi. Np.:
{prefix}{issue-number}-{kebab-case-title}Na przykład:
- Z przedrostkiem
sf-:sf-123-add-user-authentication - Z przedrostkiem
PROJ-:proj-123-add-user-authentication
Stan pull requestu
Gdy PR zostanie powiązany z problemem, zobaczysz:
- Tytuł PR - Tytuł pull requestu
- Stan - Otwarte, Połączone lub Zamknięte
- Link - Bezpośredni link do PR na temat GitHub
Haki internetowe
SprintFlint wykorzystuje webhooki GitHub do otrzymywania aktualizacji w czasie rzeczywistym na temat pull requestów. Gdy podłączysz repozytorium, automatycznie utworzymy webhook.
Uprawnienia webhooka - Aby tworzyć webhooki, potrzebujesz dostępu administratora do repozytorium. Jeśli nie masz uprawnień administratora, poproś administratora repozytorium o podłączenie integracji.
Odłączanie GitHub
Aby odłączyć GitHub:
- Przejdź do „Ustawień organizacji”
- Kliknij „Odłącz GitHub”
- Potwierdź rozłączenie
Odłączenie spowoduje:
- Usuń zapisany token dostępu
- Usuń webhooki z połączonych repozytoriów
- Zachowaj istniejące linki PR (jako dane historyczne)
Rozwiązywanie problemów
Nie wykryto PR
Jeśli pull requesty nie są łączone automatycznie:
- Upewnij się, że repozytorium jest połączone z właściwym projektem
- Sprawdź, czy format numeru wydania jest zgodny z przedrostkiem projektu
- Sprawdź, czy webhook jest aktywny w GitHub (Ustawienia repozytorium → Webhooks)
Błędy uprawnień
Jeśli widzisz błędy uprawnień:
- Autoryzuj ponownie połączenie GitHub
- Upewnij się, że masz dostęp do repozytorium
- Sprawdź, czy nazwa repozytorium nie została zmieniona lub usunięta
Następne kroki
- Autoplay - Pozwól AI automatycznie tworzyć PR
- Odniesienie API - Integracja z własnymi narzędziami