İçeriğe atla

Ajana Aynı Şeyi Tekrar Anlatma: Skill Ne Zaman Yazılır?

· 3 dk okuma · Yapay Zekâ

Bu sayfada

Bir yazının İngilizce sürümünü hazırlarken her seferinde ajana aynı şeyleri anlatıyordum: teknik terimler İngilizce kalsın, örnekler okura göre değişsin, çeviri bağlantısı yayından sonra kurulsun. Her seferinde bir şeyi unutma ya da bir dahaki sefere tam anlatamama ihtimalim vardı. Claude Code dokümantasyonu da skill'i tam olarak bu tür tekrar eden işler için öneriyor.1 Bu tekrarı bir skill'e dönüştürdüm; artık çeviri derdim kalmadı.

Skill'in ne olduğunu ve genel kurallarını ViraStack Academy'de anlattım. Bu yazıda ölçütü ve kendi blogumda kullandığım iki skill'i anlatıyorum.

Her çeviride tekrar anlatılan üç talimat, tek bir SKILL.md dosyasında toplanıyor

Ölçüt: Aynı Şeyi Tekrar Anlatıyorsan

Claude Code dokümantasyonu ölçütü net koyuyor: aynı talimatı, kontrol listesini ya da çok adımlı bir süreci sohbete tekrar tekrar yapıştırıyorsan ya da CLAUDE.md'deki bir bölüm bilgi olmaktan çıkıp bir sürece dönüştüyse skill yaz.1 CLAUDE.md'den farkı, skill'in içeriğinin yalnızca kullanıldığında yüklenmesi.1

Kısacası bilgi CLAUDE.md'ye, süreç skill'e. "Bu projede pnpm kullanılır" bir bilgi. "Bir yazıyı İngilizceye şu adımlarla hazırla" bir süreç.

localize-post: Çeviri Değil Yerelleştirme

Bu sitede oluşturduğum ilk skill localize-post, Türkçe bir yazının İngilizce sürümünü hazırlıyor. Çıkış noktası yerelleştirme yazımdaki fikir: çeviri değil, uyarlama. Skill cümle cümle çevirmiyor, fikri İngilizce okura en iyi şekilde aktarıyor. Birkaç örnek:

  • Teknik terimler (state, cache, hook) iki dilde de İngilizce kalır.
  • Yer adları okura göre değişir: İstanbul, İngilizcede Paris olur.
  • Türkiye'ye özgü örnekler değişir. ViraStack Mask yazısında Türkçede TCKN örneği var; İngilizce okur için anlamsız olacağı için İngilizcede IBAN örneğine dönüyor.

Skill'i bir süre kullandıktan sonra yeni bir tekrar fark ettim: her yazıdan sonra "bu yazı sitede öne çıkanlara girecek kalitede mi?" diye soruyordum. Bu da tekrar eden bir soru olduğu için onu da skill'e ekledim. Sürekli sorduğum bir soru daha vardı: kaynaklar doğru mu? O da ikinci skill'e dönüştü.

verify-sources: Yazanı Değil, Görmeyeni Dinle

Yapay zekâ halüsinasyon görebiliyor ve yanlış kaynaklar önerebiliyor. Bunu birkaç kez gördüm ve yazılarıma bir kontrol ekledim: verify-sources.

İki aşamada çalışıyor. Yazarken sayı, tarih ya da "X'e göre" içeren her cümle anında dipnot alıyor; kaynak açılıp okunmadan dipnot yazılmıyor. Taslak bitince de yazıyı hiç görmemiş temiz bir subagent, her iddiayı kaynağından birebir alıntıyla doğruluyor.

Skill'in çekirdeği tek cümle: "Taslağı yazan oturum kendi cümlelerini doğru sanar." Bu yüzden kontrolü yazıyı yazan yapay zekâ değil, yazıyı ilk kez gören ayrı bir yapay zekâ ajanı yapıyor. Özet de yetmiyor; kanıt, kaynağın içindeki cümle. Bu yazının dipnotları da aynı yoldan geçti.

İki Skill Birbirine Bağlanınca

verify-sources gelince localize-post'u da güncelledim. Türkçe yazı zaten doğrulandığı için İngilizce sürümde tam tarama yapılmıyor, yalnızca fark kontrol ediliyor: dipnotlar iki dilde aynı iddiaya mı bağlı, değişen bir örnek yeni bir iddia mı getirdi?

Böylece iki skill tek bir yayın akışına dönüştü: Türkçe yazılır ve doğrulanır, İngilizcesi yerelleştirilir ve yalnızca farkı kontrol edilir.

Skill Bir Kere Yazılıp Bitmiyor

Anthropic'in skill rehberi, Claude'un zaten çok akıllı olduğunu varsaymayı ve yalnızca bilmediğini yazmayı öneriyor.2 Önerdiği yöntem de şu: işi önce skill olmadan yap, neyi tekrar tekrar anlattığına dikkat et, sonra bunu skill'e çevir ve gerçek işlerde denedikçe düzelt.2

Benim yöntemim de bu: skill'i kullandıkça iyileştiriyorum. Ajana aynı şeyi ikinci kez anlatmak üzereysen, bir skill yazmanın zamanı gelmiş olabilir.

İki skill'in tamamını sitenin GitHub reposunda inceleyebilirsin: localize-post ve verify-sources.

Kaynaklar

  1. Claude Code: Extend Claude with skills

  2. Anthropic: Skill authoring best practices