İstem Rehberi

Proje sohbetinde başlayın. Değiştirmek istediğiniz projenin sohbetini açın, ardından rolü yapılacak işle eşleşen agent'ı seçin veya ona hitap edin. Hangi agent'ın uygun olduğundan emin değilseniz, oluşturmaya başlamadan önce ekibin netleştirmesini isteyin.

Bu rehber, agent ekibinizden tutarlı şekilde daha iyi sonuçlar almanızı sağlayan teknikleri bir araya getirir. Bunların hiçbiri özel bir yetenek gerektirmez. Mesele nasıl biçimlendirdiğiniz değil, ne söylediğinizdir. İster ilk isteğinizi yazıyor olun ister olgun bir projeyi iyileştiriyor olun, aynı ilkeler geçerlidir: net düşünce içeri girer, net sonuç çıkar.

Ekip oluşturmadan önce soru sorsun

Daha iyi bir sonuç almanın en etkili yollarından biri şudur: bir istek büyük veya belirsiz olduğunda, ekibin doğru tahmin etmesini ummak yerine sorular sormasını teşvik edin. Ne istediğinizi belirtin, ardından sona şu satırı ekleyin:

Başlamadan önce ne istediğimi tam olarak anlamak için ihtiyaç duyduğunuz her şeyi bana sorun.

Çoğu zaman, sınır durumları, hedef kitleler veya ödünleşimler hakkında olsun, kendi başınıza yanıtlamayı düşünmeyeceğiniz sorular alırsınız. Bunları en başta netleştirmek bir dakikaya mal olur; bir oluşturma işleminden sonra fark etmek ise yeniden çalışma gerektirir. Sonuç, ilk denemede niyetinize çok daha yakın olur.

1. Adım: Yazmadan önce karar verin

Ne oluşturduğunuzu bilin

Başta birkaç dakika düşünmek, daha sonra çok fazla yeniden istem yazmayı önleyebilir. Başlamadan önce şu dört basit soruya yanıt verebildiğinizden emin olun: ne oluşturuyorsunuz, kimin için oluşturuyorsunuz, neden bunu kullanırlar ve yapmalarını en çok istediğiniz ana eylem nedir.

Bu ana eylem genellikle CTA olarak adlandırılır; call to action ifadesinin kısaltmasıdır. Bu, kullanıcıların seçmesini en çok istediğiniz düğme, bağlantı veya sonraki adımdır; örneğin Sign Up, Book a Demo, Start Free veya Buy Now.

Tam bir teknik şartname yazmanız gerekmez. Amaç yalnızca projeye net bir yön vermektir. Başlangıç noktanız ne kadar belirgin olursa, aklınızdakine uyan bir sonuç üretmek o kadar kolay olur.

Serbest çalışanlara yönelik bir bütçeleme uygulaması için tek sayfalık bir site oluşturun. Ana CTA “Start Saving Smarter” olsun. Büyük yazı tipleri ve çarpıcı renklerle cesur, etkileyici bir görünüm kullanın.

Yalnızca ekranları değil, yolculuğu taslaklayın

İyi tasarım, ekranların üzerinde olduğu kadar aralarında da yaşar. Kullanıcınızın izlediği yolu düşünün: önce ne görüyor, güveni ne oluşturuyor, harekete geçmesi için ona ne güven veriyor ve bu eylem nereye götürüyor? Üç aşamalı basit bir taslak bile — hero, kanıt, harekete geçirici mesaj — isteklerinizi çok daha etkili hale getirir, çünkü artık her bölümün var olmak için bir nedeni ve bir sonrakine bağlanmak için bir nedeni vardır.

Görsel yönü erkenden belirleyin

Stil, sonradan uyarlamaktan çok baştan belirlemek açısından daha kolaydır. Bir yön seçin: sakin ve zarif, cesur ve yıkıcı, premium ve şık; ardından bunu ekibin harekete geçebileceği ton sözcükleriyle ilk isteğinizde belirtin: minimal, playful, sinematik, geliştirici odaklı. Bu sözcükler süsleme olmanın ötesindedir: ilk bileşenden itibaren tipografiyi, boşlukları, rengi, gölgeyi ve köşe yarıçapını şekillendirirler. Her şeyin tutarlı kalması için sonraki isteklerde aynı stil cümlesini yeniden kullanın.

Sakin, wellness esintili bir tasarım kullanın: yumuşak geçişler, soluk toprak tonları, yuvarlatılmış köşeler, geniş iç boşluklar. Genel ton nazik ve güven verici olsun.

2. Adım: Sonuç veren istekler yazın

Uygulamaları değil, sonuçları tanımlayın

Nasıl oluşturulacağını değil, istediğiniz sonucu tanımlayın. Örneğin, “Üç seçenekli bir fiyatlandırma bölümü ekleyin ve ortadakini öne çıkarın” demek, sayfanın tam olarak nasıl kurulması gerektiğini açıklamaktan daha faydalıdır. Nelerin görünmesi gerektiğine ve bunun neden önemli olduğuna odaklanın; ekibin bunu nasıl oluşturacağına ekip karar verebilir.

Sayfalarla değil, parçalarla çalışın

Tek bir bileşene odaklanan istekler — bir hero, bir özellik ızgarası, bir referans satırı, bir fiyatlandırma tablosu — size netlik ve kontrol sağlar. Bir parça hedefi tutturmazsa, etrafındaki her şeyi yeniden üretmek yerine yalnızca o parçayı ayarlarsınız. Bir blok oluşturun, gözden geçirin, iyileştirin, sonra sonrakine geçin. Tam sayfa isteği gürültü üretir; bileşen isteği sinyal üretir.

Bir özellik bölümü oluşturun: ortalanmış bir başlık, ardından yan yana üç kart; her birinde bir simge, bir başlık ve tek satırlık bir açıklama olsun. Yumuşak gölgeler, üzerine gelindiğinde hafif yükselme efekti.

Gerçek kelimeler kullanın

Yer tutucu metin sorunları gizler; gerçek metin onları ortaya çıkarır. Gerçek bir başlık iki satır gerektirebilir; gerçek bir CTA bir fiil olarak daha iyi çalışabilir. Kullanıcının gerçekten okuyacağı şeyi yazın; taslak bile olsa, içerik gerçek olduğunda düzenler, boşluklar ve tasarım kararları iyileşir.

Hero başlığı: “Design Calmly.” Alt metin: “Turn stress into structure.” CTA: “Start Building Free.” Geniş dikey boşluklara sahip, metin odaklı bir düzen.

Gerçek öğeleri adlandırın

Sayfada ne istediğinizi açıklamak için açık ve belirli kelimeler kullanın. Tasarım terminolojisini bilmeniz gerekmez; yalnızca kullanıcıların görmesi veya etkileşime girmesi gereken şeyleri adlandırın; örneğin bir profil kartı, bir düğme veya bir form.

Belirli istekleri oluşturmak, geniş kapsamlı olanlara göre daha kolaydır. İhtiyacınız olan temel öğeyle başlayın, ardından ayrıntıları teker teker ekleyin.

Fotoğraf, ad ve takip et düğmesi içeren bir profil kartı oluşturun. Adın yanına küçük bir “Verified” etiketi ekleyin ve biri bunun üzerine geldiğinde kısa bir açıklama gösterin.

3. Adım: Hassasiyetle değiştirin

Her değişikliği kapsamlandırın: ne hareket eder, ne kalır

Mevcut çalışmayı ayarlarken, her iki tarafı da açıkça belirtin: ne değişmeli ve ne değişmemeli. “Bunu daha iyi yap” yerine “değiştir”, “güncelle” ve “ayarla” gibi yönlendirici sözcükler kullanın ve beğendiğiniz kısımları sınırlandırın. Buradaki hassasiyet, yinelemenin gerilemeye dönüşmesini engeller.

CTA metnini “Get Started” olarak değiştirin ve yatay iç boşluğunu artırın. Mevcut renkleri, yazı tipini ve bu bölümdeki diğer her şeyi değiştirmeden bırakın.

Her seferinde anlamlı tek bir değişiklik

Önce metni, sonra düzeni, sonra etkileşimleri güncelleyin ve bir sonraki isteğe geçmeden önce her sonucu kontrol edin. Küçük, bilinçli adımlar birleşerek cilalı bir ürün oluşturur; tek bir mesajda yapılan on değişiklik ise belirsizlik yaratır ve bir şey ters gittiğinde buna hangi değişikliğin neden olduğunu bilemezsiniz.

Görev ortasındaki düzeltmeler sohbette yapılır. İstem Kuyruğu sohbetinizde kullanılabiliyorsa ve Agent çalışması etkinse, takip mesajları çalışan işin arkasında kuyruğa alınır. Başka bir kopya göndermeden önce mesajınızın kuyrukta göründüğünü doğrulayın. Kuyruk denetimleri görünmüyorsa yeniden göndermeyin: mevcut işin bitmesini bekleyin veya sohbetinizde varsa bir kesme denetimi kullanın, ardından takip mesajı göndermeden önce görev durumunu doğrulayın. Ayrıntılar için Proje sohbeti bölümüne bakın.

Arayüzün bir adım ilerisini düşünün

Projenizin yalnızca iyi görünmekten fazlasını yapması gerekiyorsa, görünümün yanında davranışı da tanımlayın. Kullanıcılar oturum açmışken veya açmamışken ne gördüklerini, dinamik içeriğin nereden geldiğini ve arayüzün boş, yükleniyor ve hata durumlarını nasıl ele aldığını belirtin. Bu senaryolar etrafında tasarım yapmak için çalışan bir backend'e ihtiyacınız yoktur — bunları erkenden planlamak, daha sonra büyük UI yeniden çalışmalarını önlemeye yardımcı olur.

Kullanıcı oturum açmışsa, sağ üstte avatarını ve adını gösterin. Değilse, auth ekranına yönlendiren bir “Log In” düğmesi gösterin.

SSS

AI agent için etkili bir istemi nasıl yazarım?

İsteminizi şu temel öğelerle yapılandırın:

1. Bağlam — Sahneyi kurun. Ne oluşturduğunuzu ve şu anda durumun ne olduğunu açıklayın.

2. Hedef — İstediğiniz tam sonucu veya özelliği açıkça belirtin.

3. Gereksinimler & Kısıtlar — Neyin değişmesi ve neyin dokunulmadan kalması gerektiğini net şekilde listeleyin.

4. Beklenen Sonuç — Başarının nasıl göründüğünü tanımlayın (ör. UI davranışı, hata işleme, durumun kalıcılığı).

5. Referanslar — Mümkün olduğunda ekran görüntüleri, bağlantılar, iş akışı adımları veya kod örnekleri ekleyin. Paylaşmadan önce parolaları, doğrulama kodlarını, API anahtarlarını, çerezleri, kişisel verileri ve ödeme ayrıntılarını kaldırın.

Örnek: "Kenar çubuğu olan bir gösterge paneli oluşturuyorum. Kenar çubuğunun altına bir çıkış yap düğmesi ekleyin. Oturumu temizlemeli ve /login adresine yönlendirmeli. Kenar çubuğu düzenini veya gezinme bağlantılarını değiştirmeyin. Tıklandıktan sonra kullanıcı 1 saniye içinde giriş sayfasını görmeli."

Birden fazla özelliği içeren karmaşık istekleri nasıl ele almalıyım?

Karmaşık isteklerde, bunları daha küçük görevlere bölün:

1. Mevcut sorunu ve nihai hedefi belirtin.

2. Her alt görevi ayrı ayrı listeleyin (görev 1, görev 2, görev 3).

3. Sonrakine geçmeden önce her görevi doğrulayın.

4. En sonda tam akışı test edin.

Bu yaklaşım, Agent'tan aynı anda çok fazla şey yapmasını istemekten kaynaklanan beklenmedik değişiklikleri azaltır. Her istem, tek ve doğrulanabilir bir sonuca odaklanmalıdır.

Bir hatayı düzeltmek için nasıl istem yazarım?

Kullanışlı bir hata düzeltme istemi şunları içermelidir:

• Sayfa, özellik, ortam ve etkilenen kullanıcılar
• Sorunu yeniden üretmek için tam adımlar
• Gerçek davranış ve beklenen davranış
• Hatanın tam metni ve ne zaman oluştuğu
• İlgili ekran görüntüleri veya günlükler; parolalar, jetonlar, çerezler, kişisel veriler ve ödeme ayrıntıları kaldırılmış olmalı
• Neyin değişmeden kalması gerektiği
• Düzeltmenin nasıl doğrulanacağı ve hangi regresyon kontrollerinin çalıştırılacağı

Örnek: “Preview içindeki ödeme sayfasında, Submit seçildiğinde 500 hatası dönüyor. Beklenen: sipariş onaylanır ve kullanıcı teşekkür sayfasına ulaşır. Yeniden üretim: [adımlar]. Sepet toplamlarını veya ödeme akışını değiştirmeden nedeni düzeltin, ardından bir başarılı ve bir reddedilmiş ödeme durumunu doğrulayın. Ekli günlükten tüm gizli değerleri kaldırdım.”

Sayfa düzenini veya stilini değiştirmek için nasıl istem yazarım?

Sayfa değişiklikleri isterken şunları ekleyin:

1. Değiştirilecek belirli sayfa, modül ve öğe.

2. Mevcut durum ve hedef sonuç.

3. Referans bağlantıları veya ekran görüntüleri.

4. Değişmeden kalması gereken özellikler.

5. Kabul kriterleri (ör. hem masaüstünde hem mobilde çalışmalı).

Örnek: " /pricing sayfasında, plan kartı ızgarasını masaüstünde 2 sütundan 3 sütuna değiştirin. Mobil düzeni tek sütun olarak koruyun. Bu ekran görüntüsünü referans alın [ekleyin]. Kart içeriğini veya düğme stillerini değiştirmeyin."

Düzeltmelere rağmen agent sürekli yanlış değişiklikler yapıyorsa ne yapmalıyım?

Agent tekrar tekrar hedefi kaçırıyorsa, daha fazla talimat eklemek bazen daha fazla kafa karışıklığına neden olabilir. Bunun yerine:

1. Mevcut durumu koruyun — Çakışan düzeltmeler göndermeyi bırakın. Sohbetinizde bir Geri Al denetimi görünüyorsa, kullanmadan önce onay metnini okuyun, korumanız gereken sonraki değişiklikleri not edin ve ardından projeyi doğrulayın. Kapsam net değilse devam etmeyin; Proje sohbeti yönergelerini kullanın veya redakte edilmiş bir Sohbet Bağlantısı ve ekran görüntüsüyle Destek ekibiyle iletişime geçin.

2. Gürültüyü temizleyin — Üstüne ek talimatlar yığmak yerine, temel sorunu sıfırdan temiz bir şekilde yeniden ifade edin.

3. Her seferinde tek görev — Devam etmeden önce tek bir sorunu düzeltmeye odaklanın.

Bir adım geri çekilip değişiklikleri kademeli olarak ele almak, genellikle tek bir istemde birden fazla çakışan sorunu çözmeye çalışmaktan çok daha hızlı şekilde sorunları çözer.