Add Turkish (tr) docs and update README (#744)

* Add Turkish (tr) docs and update README

Add a full set of Turkish documentation under docs/tr (agents, changelog, CLAUDE guide, contributing, code of conduct, and many agents/commands/skills/rules files). Update README to include a link to the Turkish docs and increment the supported language count from 5 to 6. This commit adds localized guidance and references to help Turkish-speaking contributors and users.

* Update docs/tr/TROUBLESHOOTING.md

Co-authored-by: cubic-dev-ai[bot] <191113872+cubic-dev-ai[bot]@users.noreply.github.com>

* Update docs/tr/README.md

Co-authored-by: cubic-dev-ai[bot] <191113872+cubic-dev-ai[bot]@users.noreply.github.com>

* docs(tr): fix license link and update readmes

Update Turkish docs: change license badge link to point to repository root (../../LICENSE), increment displayed language count from 5 to 6, and remove two outdated related links from docs/tr/examples/README.md to keep references accurate.

* Update docs/tr/commands/instinct-import.md

Co-authored-by: cubic-dev-ai[bot] <191113872+cubic-dev-ai[bot]@users.noreply.github.com>

* Update docs/tr/commands/checkpoint.md

Co-authored-by: cubic-dev-ai[bot] <191113872+cubic-dev-ai[bot]@users.noreply.github.com>

---------

Co-authored-by: cubic-dev-ai[bot] <191113872+cubic-dev-ai[bot]@users.noreply.github.com>
This commit is contained in:
Berkcan Gümüşışık
2026-03-23 01:37:04 +03:00
committed by GitHub
parent bb1efad7c7
commit fd2a8edb53
139 changed files with 26670 additions and 2 deletions

View File

@@ -0,0 +1,148 @@
---
description: İdiomatic desenler, eşzamanlılık güvenliği, hata yönetimi ve güvenlik için kapsamlı Go kod incelemesi. go-reviewer agent'ını çağırır.
---
# Go Code Review
Bu komut, Go'ya özel kapsamlı kod incelemesi için **go-reviewer** agent'ını çağırır.
## Bu Komut Ne Yapar
1. **Go Değişikliklerini Tanımla**: `git diff` ile değiştirilmiş `.go` dosyalarını bul
2. **Static Analiz Çalıştır**: `go vet`, `staticcheck` ve `golangci-lint` yürüt
3. **Güvenlik Taraması**: SQL injection, command injection, race condition'ları kontrol et
4. **Eşzamanlılık İncelemesi**: Goroutine güvenliğini, channel kullanımını, mutex desenlerini analiz et
5. **İdiomatic Go Kontrolü**: Kodun Go kurallarına ve en iyi uygulamalara uyduğunu doğrula
6. **Rapor Oluştur**: Sorunları önem derecesine göre kategorize et
## Ne Zaman Kullanılır
`/go-review` komutunu şu durumlarda kullanın:
- Go kodu yazdıktan veya değiştirdikten sonra
- Go değişikliklerini commit etmeden önce
- Go kodu içeren pull request'leri incelerken
- Yeni bir Go kod tabanına adapte olurken
- İdiomatic Go desenlerini öğrenirken
## İnceleme Kategorileri
### KRİTİK (Düzeltilmeli)
- SQL/Command injection açıklıkları
- Senkronizasyon olmadan race condition'lar
- Goroutine sızıntıları
- Hardcode edilmiş kimlik bilgileri
- Güvenli olmayan pointer kullanımı
- Kritik yollarda göz ardı edilen hatalar
### YÜKSEK (Düzeltilmeli)
- Bağlamlı hata sarmalama eksikliği
- Hata dönüşleri yerine panic
- Context yayılmıyor
- Deadlock'a neden olan buffersız channel'lar
- Interface yerine getirilmeme hataları
- Eksik mutex koruması
### ORTA (Düşünün)
- İdiomatic olmayan kod desenleri
- Export edilen elementlerde eksik godoc yorumları
- Verimsiz string birleştirme
- Preallocate edilmemiş slice
- Table-driven testler kullanılmamış
## Çalıştırılan Otomatik Kontroller
```bash
# Static analiz
go vet ./...
# Gelişmiş kontroller (kuruluysa)
staticcheck ./...
golangci-lint run
# Race tespiti
go build -race ./...
# Güvenlik açıklıkları
govulncheck ./...
```
## Örnek Kullanım
```text
Kullanıcı: /go-review
Agent:
# Go Kod İnceleme Raporu
## İncelenen Dosyalar
- internal/handler/user.go (değiştirildi)
- internal/service/auth.go (değiştirildi)
## Static Analiz Sonuçları
✓ go vet: Sorun yok
✓ staticcheck: Sorun yok
## Bulunan Sorunlar
[KRİTİK] Race Condition
Dosya: internal/service/auth.go:45
Sorun: Paylaşılan map senkronizasyon olmadan erişiliyor
```go
var cache = map[string]*Session{} // Eşzamanlı erişim!
func GetSession(id string) *Session {
return cache[id] // Race condition
}
```
Düzeltme: sync.RWMutex veya sync.Map kullan
```go
var (
cache = map[string]*Session{}
cacheMu sync.RWMutex
)
func GetSession(id string) *Session {
cacheMu.RLock()
defer cacheMu.RUnlock()
return cache[id]
}
```
[YÜKSEK] Eksik Hata Bağlamı
Dosya: internal/handler/user.go:28
Sorun: Hata bağlam olmadan döndürülüyor
```go
return err // Bağlam yok
```
Düzeltme: Bağlamla sarmala
```go
return fmt.Errorf("get user %s: %w", userID, err)
```
## Özet
- KRİTİK: 1
- YÜKSEK: 1
- ORTA: 0
Öneri: ❌ KRİTİK sorun düzeltilene kadar merge'i engelle
```
## Onay Kriterleri
| Durum | Koşul |
|--------|-----------|
| ✅ Onayla | KRİTİK veya YÜKSEK sorun yok |
| ⚠️ Uyarı | Sadece ORTA sorunlar (dikkatle merge et) |
| ❌ Engelle | KRİTİK veya YÜKSEK sorun bulundu |
## Diğer Komutlarla Entegrasyon
- Testlerin geçtiğinden emin olmak için önce `/go-test` kullanın
- Build hataları oluşursa `/go-build` kullanın
- Commit etmeden önce `/go-review` kullanın
- Go'ya özel olmayan endişeler için `/code-review` kullanın
## İlgili
- Agent: `agents/go-reviewer.md`
- Skills: `skills/golang-patterns/`, `skills/golang-testing/`