mirror of
https://github.com/affaan-m/everything-claude-code.git
synced 2026-04-13 05:03:28 +08:00
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:
committed by
GitHub
parent
bb1efad7c7
commit
fd2a8edb53
183
docs/tr/commands/go-build.md
Normal file
183
docs/tr/commands/go-build.md
Normal file
@@ -0,0 +1,183 @@
|
||||
---
|
||||
description: Go build hatalarını, go vet uyarılarını ve linter sorunlarını aşamalı olarak düzelt. Minimal, cerrahi düzeltmeler için go-build-resolver agent'ını çağırır.
|
||||
---
|
||||
|
||||
# Go Build and Fix
|
||||
|
||||
Bu komut, minimal değişikliklerle Go build hatalarını aşamalı olarak düzeltmek için **go-build-resolver** agent'ını çağırır.
|
||||
|
||||
## Bu Komut Ne Yapar
|
||||
|
||||
1. **Diagnostics Çalıştır**: `go build`, `go vet`, `staticcheck` yürüt
|
||||
2. **Hataları Parse Et**: Dosyaya göre grupla ve önem derecesine göre sırala
|
||||
3. **Aşamalı Düzelt**: Bir seferde bir hata
|
||||
4. **Her Düzeltmeyi Doğrula**: Her değişiklikten sonra build'i yeniden çalıştır
|
||||
5. **Özet Raporla**: Neyin düzeltildiğini ve neyin kaldığını göster
|
||||
|
||||
## Ne Zaman Kullanılır
|
||||
|
||||
`/go-build` komutunu şu durumlarda kullanın:
|
||||
- `go build ./...` hatalarla başarısız olduğunda
|
||||
- `go vet ./...` sorunlar raporladığında
|
||||
- `golangci-lint run` uyarılar gösterdiğinde
|
||||
- Modül bağımlılıkları bozulduğunda
|
||||
- Build'i bozan değişiklikleri pull ettikten sonra
|
||||
|
||||
## Çalıştırılan Diagnostic Komutları
|
||||
|
||||
```bash
|
||||
# Birincil build kontrolü
|
||||
go build ./...
|
||||
|
||||
# Static analiz
|
||||
go vet ./...
|
||||
|
||||
# Genişletilmiş linting (mevcutsa)
|
||||
staticcheck ./...
|
||||
golangci-lint run
|
||||
|
||||
# Modül sorunları
|
||||
go mod verify
|
||||
go mod tidy -v
|
||||
```
|
||||
|
||||
## Örnek Oturum
|
||||
|
||||
```text
|
||||
Kullanıcı: /go-build
|
||||
|
||||
Agent:
|
||||
# Go Build Çözümü
|
||||
|
||||
## İlk Diagnostics
|
||||
|
||||
```bash
|
||||
$ go build ./...
|
||||
internal/service/user.go:25:15: undefined: UserRepository
|
||||
internal/handler/api.go:42:9: cannot use x (type string) as type int
|
||||
internal/handler/api.go:58:2: missing return at end of function
|
||||
```
|
||||
|
||||
Bulunan hatalar: 3
|
||||
|
||||
## Düzeltme 1: Tanımsız Tanımlayıcı
|
||||
|
||||
Dosya: internal/service/user.go:25
|
||||
Hata: undefined: UserRepository
|
||||
Neden: Eksik import
|
||||
|
||||
```go
|
||||
// Import eklendi
|
||||
import "project/internal/repository"
|
||||
|
||||
// Değiştirildi
|
||||
var repo UserRepository
|
||||
// Şuna
|
||||
var repo repository.UserRepository
|
||||
```
|
||||
|
||||
```bash
|
||||
$ go build ./...
|
||||
# 2 hata kaldı
|
||||
```
|
||||
|
||||
## Düzeltme 2: Tip Uyuşmazlığı
|
||||
|
||||
Dosya: internal/handler/api.go:42
|
||||
Hata: cannot use x (type string) as type int
|
||||
|
||||
```go
|
||||
// Değiştirildi
|
||||
count := params.Get("count")
|
||||
// Şuna
|
||||
countStr := params.Get("count")
|
||||
count, _ := strconv.Atoi(countStr)
|
||||
```
|
||||
|
||||
```bash
|
||||
$ go build ./...
|
||||
# 1 hata kaldı
|
||||
```
|
||||
|
||||
## Düzeltme 3: Eksik Return
|
||||
|
||||
Dosya: internal/handler/api.go:58
|
||||
Hata: missing return at end of function
|
||||
|
||||
```go
|
||||
func GetUser(id string) (*User, error) {
|
||||
if id == "" {
|
||||
return nil, ErrInvalidID
|
||||
}
|
||||
user := findUser(id)
|
||||
// Eksik return eklendi
|
||||
return user, nil
|
||||
}
|
||||
```
|
||||
|
||||
```bash
|
||||
$ go build ./...
|
||||
# Build başarılı!
|
||||
```
|
||||
|
||||
## Son Doğrulama
|
||||
|
||||
```bash
|
||||
$ go vet ./...
|
||||
# Sorun yok
|
||||
|
||||
$ go test ./...
|
||||
ok project/internal/service 0.015s
|
||||
ok project/internal/handler 0.023s
|
||||
```
|
||||
|
||||
## Özet
|
||||
|
||||
| Metrik | Sayı |
|
||||
|--------|-------|
|
||||
| Düzeltilen build hataları | 3 |
|
||||
| Düzeltilen vet uyarıları | 0 |
|
||||
| Değiştirilen dosyalar | 2 |
|
||||
| Kalan sorunlar | 0 |
|
||||
|
||||
Build Durumu: ✅ BAŞARILI
|
||||
```
|
||||
|
||||
## Düzeltilen Yaygın Hatalar
|
||||
|
||||
| Hata | Tipik Düzeltme |
|
||||
|-------|-------------|
|
||||
| `undefined: X` | Import ekle veya yazım hatasını düzelt |
|
||||
| `cannot use X as Y` | Tip dönüşümü veya atamayı düzelt |
|
||||
| `missing return` | Return ifadesi ekle |
|
||||
| `X does not implement Y` | Eksik metod ekle |
|
||||
| `import cycle` | Paketleri yeniden yapılandır |
|
||||
| `declared but not used` | Değişkeni kaldır veya kullan |
|
||||
| `cannot find package` | `go get` veya `go mod tidy` |
|
||||
|
||||
## Düzeltme Stratejisi
|
||||
|
||||
1. **Önce build hataları** - Kodun compile edilmesi gerekli
|
||||
2. **İkinci olarak vet uyarıları** - Şüpheli yapıları düzelt
|
||||
3. **Üçüncü olarak lint uyarıları** - Stil ve en iyi uygulamalar
|
||||
4. **Bir seferde bir düzeltme** - Her değişikliği doğrula
|
||||
5. **Minimal değişiklikler** - Refactor etme, sadece düzelt
|
||||
|
||||
## Durdurma Koşulları
|
||||
|
||||
Agent şu durumlarda durur ve raporlar:
|
||||
- Aynı hata 3 denemeden sonra devam ederse
|
||||
- Düzeltme daha fazla hata oluşturursa
|
||||
- Mimari değişiklikler gerektirirse
|
||||
- Harici bağımlılıklar eksikse
|
||||
|
||||
## İlgili Komutlar
|
||||
|
||||
- `/go-test` - Build başarılı olduktan sonra testleri çalıştır
|
||||
- `/go-review` - Kod kalitesini incele
|
||||
- `/verify` - Tam doğrulama döngüsü
|
||||
|
||||
## İlgili
|
||||
|
||||
- Agent: `agents/go-build-resolver.md`
|
||||
- Skill: `skills/golang-patterns/`
|
||||
Reference in New Issue
Block a user