Kademeli Açılım
Bilginin tamamını baştan yüklemek yerine, yalnızca gerektiğinde katman katman açılacak biçimde tasarlanmasıdır.
İyi bir kullanım kılavuzu düşün: kapakta ne işe yaradığı, ilk sayfada nasıl başlanacağı, arkada ise sorun giderme tabloları var. Kimse arıza tablosunu ezberleyerek başlamaz.
Skill tasarımı da böyle: ana dosya süreci anlatır, ayrıntılar ayrı dosyalarda bekler. Claude o ayrıntıya ihtiyaç duyduğunda dosyayı açar.
Üç katman vardır:
- Meta katman (her zaman yüklü):
name+description. Yalnızca birkaç yüz token. Skill'in tetiklenip tetiklenmeyeceği burada belirlenir. - Talimat katmanı (tetiklenince yüklenir):
SKILL.mdgövdesi. Süreç, eşikler, karar kuralları, yasaklar. Hedef: odaklı ve okunabilir kalmak. - Referans katmanı (gerektiğinde açılır):
references/*.md,scripts/*. Uzun kontrol listeleri, tablolar, örnek şablonlar, kod.
Tasarım kuralı: Bir bilgi her oturumda gerekmiyorsa ana dosyada olmamalıdır. Ana dosyada o bilgiye giden bir işaret (hangi dosya, ne zaman okunacak) bırakılır.
Bu, skill kalitesini belirleyen en pratik mimari karardır. Kademeli açılım olmayan skill'ler ya çok yüzeysel (her şey sığsın diye) ya çok pahalıdır (her şey yüklü). İkisi de kaliteyi düşürür.
Bu sitedeki master-blog skill'inde: 40 maddelik yayın öncesi kontrol listesi ana dosyada değil references/yayin-oncesi-kontrol.md içindedir. Ana dosya yalnızca "Aşama 10'da bu dosyayı aç ve madde madde çalıştır" der. Konu seçimi aşamasında bu 1.000 token hiç harcanmaz.
"Referans dosyaları okunmuyorsa gereksizdir." Tam tersi: okunmadığı oturumlarda tasarruf sağladıkları için değerlidirler.