Bir skill uzun bir prompt değildir

Prompt tek bir isteği açıklar. Skill ise bir istek sınıfının tanımlı koşullarda tekrarlanabilir, doğrulanabilir ve güvenli biçimde nasıl işlendiğini açıklar.

Dil modeli bir görevi iyi çözdüğünde başarılı promptu saklamak doğal görünür. Her istisna yeni metin getirir: format kuralı, kaynak, örnek, tool ipucu, hata yönetimi ve özel durum. Sonunda her şeyi bilmesi beklenen dev bir evrensel prompt oluşur.

Bu ayrıntılı görünür; fakat mimari olarak zayıftır. Uzun talimatlar kullanıcı verisiyle bağlam için yarışır. Önemli kurallar ayrıntılar içinde kaybolur. Eski bilgi görünmeden kalır. Global proje metni, hedeflemediği görevleri de sınırlar. Yararlı rehber gizli teknik borca dönüşür.

Skill bu sorunu daha çok metinle değil, doğru ayrımla çözer.

Prompt, proje kuralı, resource, tool ve skill farklıdır

Prompt mevcut amacı söyler. Proje kuralı klasör yapısı, kalite seviyesi veya yasak eylem gibi ortak konvansiyonları tanımlar. Resource bilgi veya veri sağlar. Tool işlev yürütür. Skill bunları yeniden kullanılabilir prosedürde birleştirir.

Fiyat listesi çekirdek talimatta değil, güncellenebilir veri kaynağında durmalıdır. Parser, prompt içindeki pseudo-code değil test edilmiş script olmalıdır. Marka renkleri asset veya stil referansına aittir. Bileşenler yalnız ihtiyaç halinde yüklendiği için kullanıcı isteği küçük kalır.

Açık Agent Skills spesifikasyonu bunu somutlaştırır: skill, SKILL.md içeren klasördür; isteğe bağlı scripts/, references/ ve assets/ bulunur. Dosya biçimi yalnız kaptır. Kalite, parçaların birlikte kurduğu sözleşmeden doğar.

Açıklama bir router'dır

Agent skill'i kullanmadan önce uygunluğunu anlamalıdır. Ad ve açıklama reklam metni değil, routing arayüzüdür. İyi açıklama skill'in hangi sorunu çözdüğünü, ne zaman etkinleşeceğini ve ne zaman etkinleşmemesi gerektiğini söyler.

Çok geniş açıklama yanlış aktivasyon yaratır. „Belgelere yardım eder“ tüm belge skill'leriyle yarışır. Çok dar açıklama varyantları kaçırır. Gözlenebilir sınır daha iyidir: „Çok dilli DOCX çalışma kâğıtları oluşturur, her sayfayı render eder, layout ve erişilebilirliği denetler; spreadsheet veya sunum için kullanılmaz.“

Routing test edilir. Pozitif istek, zor sınır ve açık negatif örnek gerekir. İki skill aynı isteği sahiplenirse öncelik, kompozisyon veya soru mekanizması kullanılmalıdır. Sessiz rastgele seçim sağlam değildir.

Progressive disclosure bağlamı korur

Agent her başlangıçta bütün skill talimatlarını, referanslarını ve script'lerini yüklemek zorunda değildir. Agent Skills spesifikasyonu üç düzey önerir: keşif için metadata, aktivasyonda çekirdek talimat, gerektiğinde destek dosyası.

Progressive disclosure yalnız token tasarrufu değildir; etkileşimi azaltır. Hukuki inceleme akışı görüntü işini gereksiz yere etkilemez. Nadir API referansı mevcut kullanıcı girdisini dışarı itmez. Ayrıntı görev istediğinde erişilebilir kalır.

Çekirdek talimat bütün el kitabını kopyalamak yerine yönlendirmelidir. Sıra, seçim kuralı, kalite gate'i ve referans yollarını tanımlar. Uzun tablo, alan bilgisi, şablon ve örnek korpus ayrı tutulur. Her referans odaklı ve doğrudan erişilebilir olmalıdır.

Skill bir iş sözleşmesi ister

Üretim skill'i en az dokuz soruyu yanıtlar:

1 · Trigger: Hangi amaç ve girdi etkinleştirir?

2 · Önkoşul: Hangi dosya, yetki, program veya veri gerekir?

3 · Prosedür: Adımlar hangi sırayla çalışır?

4 · Karar: Model nerede yargılar, deterministik kural nerede geçerlidir?

5 · Tool: Hangi işlev hangi kapsamda kullanılabilir?

6 · Output: Hangi dosya, alan, format ve kalite beklenir?

7 · Doğrulama: Bitirmeden hangi testler geçmelidir?

8 · Hata: Ne zaman retry, rollback, eskalasyon veya stop yapılır?

9 · Sınır: Skill açıkça ne yapmamalıdır?

Bu sözleşme örtük deneyimi sınanabilir yapar. „İyi belge oluştur“ yerine dosya türü, dil, uzunluk, kaynak kuralı, render kontrolü, izinli tool ve kabul kriteri yazılır. Birden çok çözümün yararlı olduğu yerde esneklik; güvenlik sınırı ve output şemasında istikrar korunur.

Prosedürel bilgi değişken olgudan ayrılır

Skill esas olarak prosedürel bilgiyi, yani işin nasıl yapıldığını taşır. Model listesi, fiyat, mevzuat, benchmark ve ürün özelliği sürekli değişir. Çekirdek talimata gömülürse skill görünmeden yaşlanır.

Değişken olgular tarihli referans, database veya doğrulanabilir retrieval içinde tutulur. Her kayıt kaynak, tarih, kapsam ve güncelleme sahibi taşır. Skill verinin nasıl seçileceğini ve kontrol edileceğini açıklar; saklanan bilginin sonsuza dek güncel olduğunu varsaymaz.

Bu durum model routing için kritiktir. „Analiz için X, extraction için Y kullan“ hızla eskir. Context kapasitesi, tool desteği, gecikme, gizlilik, maliyet ve ölçülmüş kalite içeren yetenek matrisi daha sağlamdır. Router güncel değerlendirmeyi kullanır ve kanıt yetersizse güvenli fallback'e döner.

Determinizmi script taşır

Her adım doğal dilde kalmamalıdır. Dosya adı ve şema doğrulama, hash hesaplama, tablo genişliği ayarlama ve test çalıştırma deterministik işlemlerdir. Script bunları tekrar üretilebilir biçimde yapar ve açık hata döndürür.

Model adımın ne zaman gerektiğini ve sonucu nasıl yorumlayacağını belirler. Script mekanik işlemi garanti eder. Bu ayrım uydurmayı azaltır ve çalıştırmaları karşılaştırılabilir yapar.

Script de mühendislik ister: belgelenmiş bağımlılık, sınırlı girdi, anlaşılır hata, idempotence, test ve güvenli varsayılan. Skill rastgele kod çalıştırma izni değildir. Yürütülebilir dosya saldırı yüzeyini büyütür ve yazılım gibi incelenmelidir.