-native bp-blog-detail">İçeriğe geç
14 Temmuz 2026 · El Kitabı

İyi inşa eden istemler yazmak

Bu makale, yayınlandığı tarihteki ürünü açıklamaktadır. Güncel özellikler için AI Oluşturucu ve Ajan Ekipleri sayfalarına bakın.

İyi inşa eden istemler yazmak

Bir derleme isteminde gerçekten ne olması gerekir?

Dört şey, ve bunu bu isteklerden aşağı yukarı iki yüzünün tamamlanmış sitelere dönüştüğünü izledikten sonra söylüyorum: ne olduğu, kimin için olduğu, olmazsa olmazlar ve isteğe bağlı olarak bir ruh hali. Geri kalan her şey, derleyicinin zaten varsayılanlarla dolduracağı gürültüdür, dolayısıyla asıl beceri daha fazla yazmak değil, bu dört şeyden gerçekten fikriniz olanı fark edip sadece onu söylemektir.

Ne olduğuyla başlayın ve bunu bir şartname değil, bir kategori olarak tutun. "Bir yoga stüdyosu için randevu sitesi", "insanların saatleri görüp bir düğmeye tıklayarak yer ayırttığı ve onay aldığı bir site"den daha iyidir, ikincisi daha fazla bilgi içerse bile. Kategori, derleyicinin zaten sahip olduğu varsayılanları devreye sokar — takvimler takvim gibi görünür, randevu akışları randevu akışı gibi görünür — oysa açıklama, kategoriyi sıfırdan yeniden inşa etmesini gerektirir.

Kimin için olduğunu söylemem gerekir mi?

Söylemek zorunda değilsiniz, ama bu insanların atladığı ve atlamaması gereken satırdır. "Stüdyonun mevcut öğrencileri için" ile "stüdyoyu ilk kez keşfeden insanlar için" önemli olan hemen her noktada farklı siteler üretir — metin tonu, büyük bir pazarlama kahramanı mı yoksa doğrudan randevu düzenine geçen bir yerleşim mi olacağı, fiyatlandırmanın önde mi (yeni ziyaretçilerin buna ihtiyacı var) yoksa arkada mı kalacağı (düzenli kullanıcılar zaten biliyor). Buradaki tek bir ifade, bir sayfalık özellik isteğinin asla çözemeyeceği yüz küçük belirsizliği çözebilir. Hedef kitle gerçekten genelse, dışarıda bırakın — sadece boşluğu doldurmak için bir tane uydurmayın.

Kaç tane olmazsa olmaz listelemeliyim?

İki ya da üç. Kullandığım test şu: bu eksik diye ilk derlemeyi reddeder miydiniz? "Ders programı, çevrimiçi ödemeler, öğretmen biyografileri" bir yoga stüdyosu için bu testi geçer — program olmadan bu sitenin küçük bir versiyonu değil, tamamen farklı bir site olur. "Altbilgide bülten aboneliği" neredeyse hiçbir zaman bu testi geçmez; bu güzel-olsa-iyi-olur bir şeydir ve güzel-olsa-iyi-olurlar, bir planı gördükten sonraki takip sohbetine aittir, önemli şeylerle yarışacağı açılış istemine değil.

Bu, dürüst olmak gerekirse, insanların her iki yönde de en çok berbat ettiği bileşen. Sıfır olmazsa olmazla derleyici tahmin yürütür, bazen yanlış. Sekiz olmazsa olmazla derleyici sekizini de eşit derecede taşıyıcı kabul eder ve geri gelen şey, bir web sitesi kılığına girmiş bir özellik listesi gibi okunur — hiyerarşi yok, nefes alacak alan yok. Bir bileşeni atlamama konusunda karşı çıkmam gerekseydi, bu olurdu. "Bunu sizinki yapan iki şey" şeklinde tek bir ifade bile, neredeyse her seferinde bir gidiş-dönüşü kurtarır, çünkü bu, derleyicinin kategoriden tek başına çıkaramayacağı tek bilgidir.

Bir ruh hali belirtmeli miyim?

Sadece bir tanesi varsa. Birçok iyi prompt bunu tamamen atlar, ve bu sorun değil — tasarım direktörü siz bir sanat yönü belirtseniz de belirtmeseniz de bir yöne bağlanır. İki kelimelik bir ruh hali ("sıcak ve el çizimi", "klinik ve hızlı", "90'ların oyun salonu gibi") bu bağlılığı bir yere yönlendirir, aksi halde kategorinin varsayılanlarına kalır. Güçlü bir tepkiniz varsa — krem rengi arka planlar ve sıcak serif yazı tipi istediğinizi biliyorsanız, ya da yuvarlak köşelerden nefret ettiğinizi biliyorsanız — o cümleyi harcayın. Bu arada, "temiz ve modern" sayılmaz. Bu bir ruh hali değil, ruh halinin yokluğudur, ve bir slot harcarken hiçbir yöne yönlendirmez.

Neden aklımdaki her şeyi anlatmayayım?

Çünkü builder söyleneni yapar. Gerçek arıza noktası burası, ve insanların beklediği gibi değil — fazla bilgi builder'ı karıştırmaz, yazdığınız her cümle bir talimat olarak okunur; ikinci kez baktığınızda memnuniyetle vazgeçeceğiniz yarım kalmış fikirler dahil. Birinin "belki bir referanslar bölümü, emin değilim" yazdığını ve karşılığında üç yer tutucu alıntıyla dolu bir referanslar bölümü aldığını gördüm, çünkü "belki, emin değilim" bir insan okuyucu için çekince olsa da, sizi kelimesi kelimesine alan bir sistem için özellik talebidir.

Az belirtmek pahalı olsaydı bu önemli olurdu, tıpkı insan geliştirici ekiplerinde olduğu gibi; belirsizlik, yanlış şeyin yapıldığı fark edilmeden önce size iki hafta kaybettirir. Burada pahalı değil. Builder inşa etmeden önce planlar — kod işlenmeden önce somut bir öneri görürsünüz — bu yüzden az belirtmek size sohbette beş dakikalık bir düzeltmeye mal olur, oysa fazla belirtmek en zayıf yarı olgunlaşmış fikirlerinizi, hangilerinin değerli olduğunu bilmek için en az bilgiye sahip olduğunuz tam anda öne çıkarır. On kelimelik gerçek gereksinimler, iki yüz kelimelik bilinç akışından daha iyidir; bunun nedeni fazla bilginin soyut olarak kötü olması değil, bu arayüzde özellikle her fazla kelimenin bir bağlılık olmasıdır.

Daha sessiz bir bedel de var: hiyerarşiyi düzleştirir. On iki özelliği eşit vurguyla listeleyin, builder'ın gerçekten önemsediğiniz üç şey hakkında hiçbir sinyali olmaz, bu yüzden ya on ikisine de eşit görsel ağırlık verir (dağınık) ya da önceliği tahmin eder (bazen yanlış, ve şimdi bir tercihi belirtmek yerine bir tahmini hata ayıklıyorsunuz). Açıkça belirtilmiş üç olmazsa olmaz bu hiyerarşiyi korur. Bir paragrafa sıkıştırılmış on iki tanesi onu yok eder.

İyi bir prompt gerçekte nasıl görünür?

İstemNeden işe yarıyor
"Tırmanıcılar için bir antrenman günlüğü — seanslar, dereceler, ilerleme grafikleri."Ne artı üç olmazsa olmaz, toplam on kelimelik gereksinim. Kitle notu yok, çünkü "kendi antrenmanlarını kaydeden tırmanıcılar" kategoriden zaten açık — burada işe yaramayan tek unsuru doğru şekilde atlıyor.
"Şehir tarımı hakkındaki podcast'im için bir açılış sayfası, sıcak ve editoryal, bölüm listesi ve abone olma formuyla."Ne, "podcast'im" ile ima edilen kitle, ruh hali, iki özellik. Bölümlerin hangi oynatıcıyla gömüleceğini ya da sayfa başına kaç tane gösterileceğini söylemiyor — bunlar açılış prompt'u soruları değil, ikinci tur soruları.
"İki oyunculu bir hava hokeyi oyunu, gerçek fizik, tek klavye."Oyunlar bu kalıbı açıkça gösterir: tür artı gerçekte nasıl oynandığını belirleyen tek kısıtlama. "Gerçek fizik" ve "tek klavye" özellikten çok, kafanızdaki oyun gibi hissettirip hissettirmeyeceğini belirleyen iki karardır. Masa rengi, hokey diski izleri, skor arayüzü — builder önerir, siz tepki verirsiniz.

Üç örneği birbirine bağlayan şey kısalık uğruna kısalık değil, her kelimenin bir işi yapmasıdır. Podcast prompt'undan "sıcak ve editoryal"i çıkarın, sıradan bir podcast sayfası elde edersiniz; "şehir tarımı"nı çıkarın, ruh hali kelimesinin hedefleyecek bir şeyi kalmaz. Bir prompt'un iyi kurgulanıp kurgulanmadığının gerçek testi budur — kelime sayısı değil. Her cümlesi yerini hak eden 40 kelimelik bir prompt'u, kısalık uğruna kısa olup sessizce bir olmazsa olmazı atlayan 15 kelimelik bir prompt'a tercih ederim.

Zaten marka renklerim ya da gerçek fotoğraflarım varsa ne olacak?

Ekleyin. Anlatmayın. Birinin, gerçek marka kılavuzu tüm süre boyunca masaüstündeki bir PDF'de dururken, bir marka paletini onaltılık koda yakın bir dille — "koyu bir orman yeşili, biraz mat" — titizlikle bir paragrafa sıkıştırdığını gördüm. Anlatılan bir renk, builder'ın yeniden inşa etmesi gereken bir tahmindir; eklenen bir renk ise zaten doğrudur. Gerçek menüler, gerçek fotoğraflar, marka varlıkları — bilgi ve referans özellikleri bunları doğrudan inşaya besler, ve gerçekler her seferinde gerçeklerin tasvirlerini yener.

Bunların hiçbiri sırayla doldurulacak bir kontrol listesi değil. Birçok güçlü prompt ruh halini atlar. Bazıları kategori zaten açıkladığı için kitleyi atlar. Dört bileşen, dahil etmeye değer olanın bir tavanıdır, doldurmanız gereken bir form değil — gerçekten fikriniz olan iki üç şeyi söyleyin ve gerisini builder'ın varsayılanlarına bırakın.
El Kitabı
PaylaşXLinkedInFacebookRedditQuoraWhatsAppTelegramE-posta
← Tüm gönderiler