Hızlı mühendislik en iyi uygulamaları
İstemlere kod gibi davranın: onlara yapı verin, sürümlerini verin, değerlendirin. Aşağıda, Starsg üzerindeki düzinelerce üretim yolundan sağ kurtulan altı uygulama yer almaktadır; bunlar önemli oldukları sıraya göre sürekli olarak iğneyi hareket ettirmişlerdir.
1. Rolü ve hedefi belirleyin
İlk bir veya iki satır modelin bakış açısına dayanak oluşturmalıdır: Kimdir, kimin için yazıyor, başarının neye benzediği. Terim yoğunluğu, üslup ve neyin dahil edileceğine dair seçim, bunların hepsi bu dayanak noktasının dışına çıkıyor; modeli daha sonra "çok ayrıntılı değil" veya "çok akademik değil" diyerek geri çekmekten çok daha ucuz. Sağlam bir açılış üç şeye cevap verir: kimlik, hedef kitle ve amaç.
Rol belirleme şablonu
Siz bir geliştirici-ilişkiler mühendisisiniz. Hedef kitle: Arka uç mühendisleri HTTP API'leri konusunda rahattır ancak Yüksek Lisans ve token tabanlı fiyatlandırma konusunda yenidirler. Hedef: Üç dakika içinde okuyucunun Starsg'nin entegre edilmeye değer olup olmadığına karar vermesine yardımcı olun ve onlara bir sonraki adımı söyleyin. Sade ama profesyonel bir ton kullanın. Pazarlama saçmalığından kaçının.
2. Görevi açıkça yazın
"Bir ürün tanıtımı yazın" her kararı modele verir; her çalıştırma bir tahmindir. Yeniden kullanılabilir bir talimatın en az beş öğesi vardır: eylem (yazma/özetleme/çevirme), nesne (ne), hedef kitle (kim için), ton/stil ve uzunluk veya şekil. Bunları açıkladığınızda çıktı kararlılığınız anında bir seviye atlar.
❌ Çok belirsiz
Bana bir ürün tanıtımı yazın.
✅ Beş elementin tümü
~200 sözcükleriyle, arka uç mühendisleri için, Starsg'nin üç farklı özelliğini (birleşik ağ geçidi, anahtar başına faturalandırma, çoklu model geri dönüş) tanıtın. Ton: profesyonel ve ölçülü. "Güçlendirmek" veya "yeni nesil" gibi kelimelerden kaçının. Somut bir harekete geçirici mesajla bitirin.
3. Bağlam ve örnekler sağlayın (Birkaç çekim)
Gereksinim ne kadar soyutsa, örnekler de o kadar geçimini sağlar. Bir ila üç "girdi → beklenen çıktı" çifti, on satırlık açıklama değerindedir. Format sabit olduğunda (sınıflandırma, çıkarma, JSON), stilin kelimelerle tanımlanması zor olduğunda veya alanın kendi kuralları olduğunda (hukuk, tıbbi, dahili sistemler) az çekim özellikle belirleyicidir. Örneklerin yalnızca kolay durumları değil, gerçek dağılımı da kapsamasını sağlayın.
Birkaç atışta çıkarma örneği
Aşağıdaki destek bildirimi metninden üç alanı çıkarın: «type / scope / severity». Yalnızca JSON çıkışı.
Örnek 1:
Giriş: Kullanıcılar Guangzhou bölgesindeki oturum açma hatalarını bildiriyor; telefon desteği aşırı yüklendi.
Çıktı: {"type":"login","scope":"Guangzhou region","severity":"P1"}
Örnek 2:
Girdi: Bir test hesabı yanlış bakiyeyi gösteriyor; yalnızca dahili KG etkilenir.
Çıktı: {"type":"account","scope":"internal QA","severity":"P3"}
Şimdi işlem yapın:
Giriş: Pekin API ağ geçidi 502'yi döndürür; tüm ücretli kullanıcılar etkilenir.4. Çıkış formatını sınırlayın
Aşağı yöndeki bir sistemin tükettiği her şeyin ayrıştırılabilir olması gerekir. JSON? Bir şema ve alan notları sağlayın. Liste? Sayımı ve öğe başına şekli sabitleyin. Uzunluk sınırı? Öyle söyle. "Alan eksikse, onu boş olarak ayarlayın - icat etmeyin" gibi bir cümle ekleyin ve halüsinasyonları ölçülebilir şekilde azaltacaksınız.
JSON çıkış kısıtlaması
Aşağıdaki özgeçmişi, bu şemayla tam olarak eşleşen JSON'ye dönüştürün:
{
"name": string,
"yearsOfExperience": number,
"skills": string[], // at most 5, lowercase
"summary": string // <= 60 words
}
Kaynak bir alandan bahsetmiyorsa onu null olarak ayarlayın; icat etmeyin. Çevresinde metin olmadan yalnızca JSON çıktısını alın.5. Karmaşık görevleri ayrıştırın (düşünce zinciriyle)
Bir modelden tek seferde "analiz et + planla + üret" yapmasını istemek genellikle ayrıntıları kaybeder veya akıl yürütmeyi nihai cevap olarak görür. İki seçenek: Dahili olarak adım adım düşünmesine izin verin veya işi kendiniz birden fazla dönüşe bölün. Denetlenebilir iş akışları için ikincisini tercih ediyoruz; her ara adımı saklayın, böylece hangi adımın başarısız olduğunu daha sonra tespit edebilirsiniz.
Adım adım şablon
Size bir ürün özelliği vereceğim. Üç adımda işleyin ve her birini ## başlığıyla ayırın: ## 1. Önemli bilgiler Madde işareti listesi: hedef kullanıcı, temel senaryo, sahip olunması gereken özellikler, açıkça kapsam dışı olan şeyler. ## 2. Riskler ve belirsiz noktalar Spesifikasyondaki belirsiz veya çelişkili her şeyi, her biri birer cümle olacak şekilde listeleyin. ## 3. Sonraki adımlar Başbakana öncelik sırasına göre sıralanmış üç somut, yürütülebilir sonraki eylem verin. Özellikler: <<< >>>
6. Yineleyin ve değerlendirin
İyi yönlendirmeler yazılmaz, tekrarlanır. Sabit bir değerlendirme seti oluşturun (normal + kenar + rakipleri kapsayan 20–50 vakaları). Her hızlı değişiklikte bunu çalıştırın ve isabet oranını, ortalama uzunluğu ve jeton maliyetini kaydedin. İstemlerinizi kod gibi sürümlendirin - her değişikliğin bir nedeni ve bir gerileme temeli vardır, "bu sefer daha iyi hissettiriyor" diye bir şey yoktur.
- Normal, uç ve rakip durumları kapsayan sabit veri kümesi.
- Yineleme başına bir değişkeni değiştirin (talimat, örnek sayısı, format kısıtlaması) - aksi takdirde ilişkilendirme çamurlu olur.
- Sürüm başına isabet oranını / ortalama belirteçleri / hata modlarını tek bir sayfada izleyin.
- Modeller arasında test yapın — aynı istem Claude / GPT / Gemini üzerinde genellikle çok farklı davranır.