AI Kodlama Asistanlarına Skill Dosyaları Yazdırmak: Prompt Şablonu
05 Nisan 2026 · 5 Dakika Okuma
Yapay zeka destekli kodlama asistanları (Claude Code, Cursor, Gemini CLI gibi) artık sadece "kod yaz" demekle çalışmıyor. Onlara kurumsal hafıza kazandırmak — yani projelerinizdeki mimari kararları, veritabanı standartlarınızı ve kod kalitesi kurallarınızı kalıcı olarak öğretmek — çok daha güçlü sonuçlar veriyor. İşte bunu yapmanın yolu: Skill Dosyaları.
📐 Skill Dosyası Nedir?
Skill dosyaları, AI kodlama asistanınıza "her seferinde hatırlatmak zorunda kalmadan" uyması gereken kuralları öğreten
.md uzantılı Markdown dosyalarıdır.
İki türü vardır:
- Global Skill'ler: Her projede geçerli olan evrensel kurallar (OOP, SOLID, DRY...)
- Local Skill'ler: Sadece o projeye özel kurallar (naming convention, feature ekleme adımları...)
🌍 Global Skill Dosyaları
Her projede geçerli olan 3 temel dosya:
1. architecture.md
- OOP prensipleri — her mantıksal birim bir sınıf
- SOLID prensipleri — özellikle Single Responsibility ve Dependency Inversion
- DRY kuralları — aynı mantığı 2'den fazla yerde tekrarlama
- Async-first yaklaşım — IO işlemleri varsayılan olarak asenkron
- Config'den okuma zorunlu, hardcode kesinlikle yasak
2. database.md
- Her tabloda UUID primary key kullan
- Foreign key'lerde CASCADE stratejisi uygula
- Yeni alan eklenince mutlaka migration dosyası oluştur
- Index stratejisi: Aktif sorgulara göre akıllı index ekle
- Partition stratejisi: Büyük tablolarda partition öner
- N+1 query kesinlikle yasak — her zaman eager loading veya join kullan
3. code-quality.md
- Typed error handling — her hata tipi ayrı sınıf
- Common fonksiyonları
utilsmodülüne çıkar - Singleton pattern kullanımı — doğru yerde, doğru şekilde
- Docstring ve comment kuralları — fonksiyon amacı, parametre tipleri, dönüş değeri
🏠 Local Skill Dosyaları (Projeye Özel)
Her projenin kendine has kuralları olur. AI asistanınıza bu kuralları da öğretmelisiniz:
- feature_ekleme.md: Yeni feature eklerken takip edilecek adımlar (branch → kod → test → review → merge)
- code_review.md: Code review sırasında kontrol edilecek maddeler listesi
- naming_conventions.md: Projeye özel değişken, dosya ve fonksiyon isimlendirme kuralları
🧠 Kopyala-Yapıştır Prompt Şablonu
Aşağıdaki promptu AI asistanınıza (Claude, Gemini, ChatGPT) vererek kendi skill dosyalarınızı oluşturabilirsiniz:
"Bana iki tür skill dosyası oluştur:
GLOBAL SKİLLER (her projede geçerli):
1. architecture.md → OOP, SOLID, DRY, Async-first, Config'den okuma
2. database.md → UUID PK, CASCADE FK, Migration zorunlu, Akıllı Index, Partition, N+1 yasak
3. code-quality.md → Typed errors, Utils modülü, Singleton, Docstring kuralları
LOCAL SKİLLER (bu projeye özel):
Şu anki projemi analiz et ve projeye özel skill dosyaları öner:
• Yeni feature eklerken takip edilecek adımlar
• Code review checklist'i
• Proje özelinde naming convention
Kullandığım tech stack: [BURAYA STACK'İNİ YAZ]
Her skill için ayrı .md dosyası oluştur ve içeriğini yaz."
💡 Neden Önemli?
Skill dosyaları olmadan AI asistanınız her seferinde sıfırdan başlar. Her "yaz bana şunu" dediğinizde aynı hataları tekrarlar, aynı standartları unutur. Skill dosyaları ile ona kurumsal bir hafıza verirsiniz — tıpkı yeni bir çalışana şirket el kitabı vermek gibi.
Kendi projelerinizde bu sistemi kurarsanız, AI ile çalışma verimliliğiniz en az 3 kat artar. Deneyin ve farkı görün.