Przejdź do głównej zawartości

Przegląd kodu z AI

Speedwave wspomaga inżynierów w przeglądzie kodu w pull requestach i merge requestach, gwarantując, że ostateczna decyzja i odpowiedzialność za scalenie zmian pozostają po stronie człowieka. Sesję przeglądu można uruchomić standardowym poleceniem Claude Code /code-review lub skorzystać z zaawansowanego zestawu recenzentów AI w Speedwave: /speedwave-code-review (opisanego w sekcji Wbudowane skille i wtyczki).

Proces recenzji jest realizowany przez odrębne workery integracji z GitHubem oraz GitLabem, z których każdy korzysta z odizolowanych poświadczeń:

  • GitHub: Speedwave odczytuje diffy i pliki pull requesta, pobiera listę commitów oraz dotychczasowych recenzji i publikuje uwagi (ogólne komentarze w wątku przez createPrComment lub komentarze do konkretnych linii w diffie przez createPrReviewComment).
  • GitLab: Odpowiednie narzędzia analizują merge requesty (getMrChanges, getMrFull) oraz publikują wątki dyskusyjne (createMrNote, createMrDiscussion).

Obie integracje dostarczają pełen kontekst zmian, w tym historię commitów, porównania gałęzi oraz statusy potoków CI (pipelines) za pośrednictwem narzędzi listPrCommits i listMrPipelines. W przypadku GitLaba narzędzie getBlame umożliwia dodatkowo analizę historii zmian linia po linii przed opublikowaniem komentarza.

Speedwave działa jako asystent analityczny: zgłasza konstruktywne uwagi i rekomendacje techniczne, lecz nigdy nie scala kodu bez wyraźnego polecenia programisty. Narzędzia scalania (mergePullRequest, mergeMergeRequest) wymagają każdorazowo jednoznacznej dyspozycji człowieka. Poświadczenia używane do przeglądu są ściśle odizolowane: worker GitHuba operuje wyłącznie na swoich tokenach, worker GitLaba na własnym tokenie i adresie instancji, a żaden z nich nie ma dostępu do sekretów innych usług.

Aby włączyć automatyczny przegląd kodu, skonfiguruj integrację odpowiadającą twojemu serwerowi Git:

  • Integracja z GitHubem: Uwierzytelnienie przez procedurę OAuth device flow lub osobisty token dostępu (PAT).
  • Integracja z GitLabem: Obsługa GitLab.com oraz instancji self-hosted; wymaga podania adresu URL instancji oraz tokena Personal Access Token z uprawnieniami api, read_repository i write_repository.

Po skonfigurowaniu integracji Speedwave może weryfikować, analizować i komentować zmiany w aktywnym projekcie.