go-dev-guidelines

Skill do Claude'a, który prowadzi Cię przez idiomatyczne wzorce Go, testowanie oparte na TDD, strukturę projektów i best practices. Aktywuj go podczas pisania nowych funkcji, serwisów, pakietów lub testów w Go. Otrzymasz konkretne wytyczne do definiowania interfejsów, generowania mocków za pomocą mockery, obsługi błędów i dokumentacji kodu.

1. Zainstaluj skill w swoim środowisku Claude'a, dodając go do katalogu skills projektu Jumppad. Skill będzie dostępny jako część konfiguracji agenta.

2. Aktywuj skill przed rozpoczęciem pracy nad kodem Go — powiedz Claude'owi, że pracujesz nad nową funkcją, serwisem lub pakietem w Go. Skill automatycznie zaproponuje odpowiedni checklist (dla nowej funkcji, nowego serwisu lub refaktoryzacji).

3. Postępuj zgodnie z checklist dla nowej funkcji: najpierw zdefiniuj interfejs, następnie napisz testy w pliku *_test.go używając testify/require, wygeneruj mocki za pomocą mockery do folderu mocks/, a dopiero wtedy implementuj logikę.

4. Dla nowych serwisów lub pakietów zastosuj standardową strukturę Go (/cmd, /internal, /pkg), zainicjuj moduł poleceniem go mod init, zdefiniuj interfejsy i od razu pisz testy przed implementacją.

5. Skill przypomni Ci o uruchomieniu go vet i gofmt, dodaniu dokumentacji w formie komentarzy godoc oraz implementacji graceful shutdown dla serwisów. Zawsze obsługuj błędy jawnie.

6. Konsultuj się ze skillem przy refaktoryzacji istniejącego kodu — poproś o wskazówki, jak zastosować TDD i dependency injection, aby kod był bardziej testowalny i zgodny z idiomatycznym stylem Go.