Claude Code Yetenekleri: AI Kod Asistanınız İçin Özel İş Akışları Oluşturun

Claude Code, genel amaçlı bir AI asistanıyla birlikte gelir. Yetenekler, onu özelleştirmenizi sağlar. Bir yetenek, Claude Code'a belirli bir görev türünü nasıl yapacağını öğreten bir markdown dosyasıdır: Kubernetes'e dağıtım yapmak, veritabanı migrasyonları yazmak, pull requestleri incelemek veya ekibinizin kodlama kurallarını takip etmek gibi.

"Bana bir React bileşeni yaz" ile "tasarım sistemimizi takip eden, özel hooklarımızı kullanan, uygun hata sınırları ve erişilebilirlik özellikleri içeren bir React bileşeni yaz" arasındaki fark bir yetenektir.

Yetenekler Aslında Nedir

Bir yetenek, .claude/commands/ (proje düzeyi) veya ~/.claude/commands/ (küresel) klasöründe bulunan bir markdown dosyasıdır. Claude Code'da /skill-name yazdığınızda, dosyanın içeriği talimatlar olarak sohbete enjekte edilir.

.claude/
  commands/
    deploy.md          # /deploy
    review-pr.md       # /review-pr
    write-test.md      # /write-test

Hepsi bu. Özel bir sözdizimi yok, derleme yok, SDK yok. Sadece bir şeyi nasıl yapacağınızı anlatan markdown dosyası.

İlk Yetenek Dosyanızı Yazmak

İşte pratik bir örnek: ekibinizin commit mesajı kurallarını zorlayan bir yetenek.

.claude/commands/commit.md dosyasını oluşturun:

# Commit İş Akışı

## Adımlar
1. Commit edilecek değişiklikleri görmek için `git diff --staged` çalıştırın
2. Değişiklikleri analiz edin ve kategorize edin: feat, fix, refactor, docs, test, chore
3. Kurallarımıza uygun bir commit mesajı yazın:
   - Format: `type(scope): description`
   - Scope, paket veya modül adı
   - Açıklama emir kipinde, küçük harflerle, noktasız
   - Gövde, NE değil NEDEN açıklar
4. Değişiklikler birden fazla scope'u etkiliyorsa, ayrı commitler oluşturun
5. Oluşturulan mesajla `git commit -m "message"` komutunu çalıştırın

## Kurallar
- Hookları atlamak için asla `--no-verify` kullanmayın
- Yayınlanmış commitleri asla değiştirmeyin (amend etmeyin)
- Pre-commit testleri başarısız olursa önce sorunu düzeltin

## Örnekler
- `feat(billing): add stripe webhook handler`
- `fix(auth): handle expired refresh tokens`
- `refactor(api): extract rate limiter to shared package`

Artık /commit, Claude Code’a belirsiz bir "değişikliklerimi commit et" talimatı yerine yapılandırılmış bir iş akışı sağlar.

Yetenek Tasarım Kalıpları

Kontrol Listesi Kalıbı

Birden fazla doğrulama adımı olan görevler için en uygunudur.

# Dağıtımdan Önce Kontrol Listesi

Dağıtımdan önce her maddeyi doğrulayın:

- [ ] `pnpm typecheck` başarılı
- [ ] `pnpm test` başarılı
- [ ] Üretim kodunda console.log ifadeleri yok
- [ ] Ortam değişkenleri .env.example dosyasında belgelenmiş
- [ ] Veritabanı migrasyonları geri alınabilir
- [ ] API değişiklikleri geriye dönük uyumlu

Herhangi bir kontrol başarısız olursa, durun ve sorunu rapor edin. Dağıtıma devam etmeyin.

Karar Ağacı Kalıbı

Yaklaşımın bağlama bağlı olduğu görevler için en uygunudur.

# Hata Düzeltme İş Akışı

1. Hatayı yeniden oluşturun (başarısız bir test bulun veya yazın)
2. Temel nedeni belirleyin:
   - Eğer tip hatasıysa → tip tanımını kaynağında düzeltin
   - Eğer yarış durumuysa → uygun kilitleme/sıralama ekleyin
   - Eğer doğrulama eksikse → sınırda şema doğrulaması ekleyin
   - Eğer mantık hatasıysa → düzeltin ve regresyon testi ekleyin
3. Düzeltmenin mevcut testleri bozmadığını doğrulayın
4. Bu hatayı yakalayacak bir test yazın

Şablon Kalıbı

Tutarlı çıktı üretmek için en uygunudur.

# Yeni API Uç Noktası

Kurallarımıza uygun yeni bir API uç noktası oluşturun:

## Dosya Yapısı
- Rota işleyici: `apps/api/src/routes/{resource}/{action}.ts`
- Şema: `apps/api/src/schemas/{resource}.ts`
- Test: `apps/api/src/routes/{resource}/__tests__/{action}.test.ts`

## Gerekli Öğeler
- İstek doğrulaması için Zod şeması
- Kimlik doğrulama ara yazılımı
- Oran sınırlaması
- errorResponse() kullanarak yapılandırılmış hata yanıtları
- successResponse() kullanarak başarı yanıtları
- OpenAPI dokümantasyon yorumları

Topluluk Yeteneklerini Kurmak

Claude Code ekosistemi, büyüyen bir topluluk yetenekleri kütüphanesine sahiptir. Bunları şu komutla kurabilirsiniz:

npx add-skill username/repo-name -y

Popüler yetenek koleksiyonları:

coreyhaines31/marketingskills (29 pazarlama/SEO yeteneği)
hedging8563/lemondata-api-skill (LemonData API entegrasyonu)

Kurulan yetenekler ~/.claude/commands/ içinde görünür ve tüm projelerde çalışır.

Proje ve Küresel Yetenekler

Konum	Kapsam	Kullanım Durumu
`.claude/commands/`	Sadece bu proje	Proje kuralları, dağıtım iş akışları
`~/.claude/commands/`	Tüm projeler	Kişisel tercihler, genel araçlar

Proje yetenekleri repoya commit edilmeli ki tüm ekip faydalansın. Küresel yetenekler kişisel iş akışı tercihlerine yöneliktir.

İleri Seviye: Hook’lu Yetenekler

Yetenekler, otomatik uygulama için belirli olaylarda çalışan shell komutları olan hook’lara referans verebilir:

# Pre-Commit Kontrolü

Her commit öncesinde aşağıdaki hook’lar otomatik çalışır:
- `pre-commit`: typecheck + lint çalıştırır
- `post-commit`: changelog’u günceller

Bir hook başarısız olursa, hata çıktısını inceleyin ve sorunu düzeltin.
Hook’ları atlamak için --no-verify kullanmayın.

Hook’lar kendileri .claude/settings.json içinde yapılandırılır:

{
  "hooks": {
    "pre-commit": "pnpm typecheck && pnpm lint-staged"
  }
}

Etkin Yetenekler İçin İpuçları

Dosya yolları ve isimlendirme kuralları konusunda net olun. "Bir bileşen oluştur" belirsizdir. "src/components/ui/ içinde PascalCase isimlendirmesiyle bir bileşen oluştur" uygulanabilir bir talimattır.
Doğru çıktıya örnekler ekleyin. Claude Code soyut kurallardan çok örneklerden daha iyi öğrenir.
Ne yapmamanız gerektiğini belirtin. "Asla any tipi kullanmayın" "doğru tipleri kullanın"dan daha uygulanabilir bir kuraldır.
Yetenekleri odaklı tutun. Her iş akışı için bir yetenek. Her şeyi kapsayan 200 satırlık bir yetenek, her biri bir görevi iyi yapan beş 40 satırlık yetenekten daha az faydalıdır.
Yeteneklerinizi versiyonlayın. Kurallarınız geliştikçe yetenekleri güncelleyin. Güncel olmayan yetenekler, eski kalıpları zorladığı için hiç yetenek olmamasından daha kötüdür.

Gerçek Dünya Etkisi

Yetenekleri benimseyen ekipler tutarlı gelişmeler bildiriyor:

Kod inceleme döngüleri azalır çünkü kurallar incelemeden önce uygulanır
Yeni geliştiricilerin oryantasyon süresi kısalır çünkü yeni gelenler deneyimlilerle aynı rehberliği alır
AI tarafından üretilen kod kalitesi artar çünkü AI proje standartları hakkında açık bağlama sahiptir

Yatırım küçüktür (ilk birkaç yeteneği yazmak 30 dakika sürer) ve her etkileşimle getirisi katlanarak artar.

AI ile geliştirin, kendi kurallarınızla yönlendirin. lemondata.cc, AI destekli geliştirme araçları için API altyapısı sağlar.

Claude Kod Becerileri: AI Kodlama Asistanınız için Özel İş Akışları Oluşturun