Kod asistanınız için rapor
Yapay zeka için kopyala düğmesine bir kere basmak panonuza bir görev belgesi koyar. Claude Code, Cursor ya da Copilot'a yapıştırırsınız ve asistanın elinde sorunlar, ölçülen değerler ve bunların içinde yaşadığı altyapı hazır durur. Panelin, bulguları düzeltmeyi yapacak araca teslim eden parçası burasıdır.
İçinde ne var
| Parça | Neden orada |
|---|---|
| Analiz edilen adres, sayfa başlığı, zaman damgası, motor sürümü | Asistan neye baktığını bilsin ve aynı sayfayı sonra yeniden doğrulayabilsin diye. |
| Altyapı satırı | Belgedeki en değerli satır. Eksik bir meta açıklama, Next.js'te bir metadata dışa aktarımı, WordPress'te bir eklenti alanı, düz HTML'de bir head etiketidir. |
| Yalnız sorunlar, iki sınıf hâlinde, her sınıfın içinde şiddete göre sıralı | Geçen kontroller sinyali gömer ve asistana token harcatır. Kaç tanesinin geçtiğini tek satır söyler. |
| Her bulguda: analizör anahtarı, ölçülen değer birebir, kural ve belgede nerede durduğu | İki rapor karşılaştırılabilir olur ve asistan sayfayı açmadan başlığı yeniden yazabilir. |
| Bulgu bazında render farkı | JavaScript'in yükleme sonrası eklediği bir canonical, kaynakta duran bir canonical'dan farklı düzeltilir. |
| Okunamayanlar | Yoksa asistan hiç ölçülmemiş bir indekslenebilirlik sorununu düzeltmeye kalkar. |
| Kapsamı söyleyen kapanış satırı | Tek bir render edilmiş sayfa, tarama değil. Bir depoya toptan uygulamadan önce doğrulayın. |
İki bulgu sınıfı ve bu ayrımın sebebi
Paneli okuyan insan yüzde 11,7 anahtar kelime yoğunluğunu görür, ne de olsa wordpress.org der ve yarım saniyede geçer. Asistan ise uygular. Yani insana hiçbir şeye mal olmayan bir yanlış alarm, bu belgeye yanlış bir commit'e mal olur. Bulgular ne kadar ciddi olduklarına göre değil, arkalarındaki kanıtın cinsine göre ikiye ayrılır; şiddet her grubun içinde sıralamayı yapmaya devam eder.
| Sınıf | Ne demek | Nasıl yazılır |
|---|---|---|
| Kesin | Belge o şeyi ya taşır ya taşımaz, ya da kendi kendisiyle çelişir ve düzeltme tartışmasızdır: meta açıklama yok, H1 yok, iki canonical, geçersiz hreflang kodu, eksik alt özniteliği, kaynak ile DOM arasında değişen bir robots direktifi. | Görev satırı ve kabul ölçütüyle birlikte, uygulanmaya hazır. |
| Karar bekleyen | Doğru cevabı sayfanın ne için var olduğuna bağlı bir eşik, sezgi ya da üslup kuralı; eklenti o amacı göremez: anahtar kelime yoğunluğu, metin/HTML oranı, kelime sayısı, adres biçimi, DOM boyutu, bağlantı metni kalitesi. | Kendi başlığı altında, ölçülen değer ve kuralla birlikte ama emir kipinde görev satırı olmadan. Yerine bir değerlendirme satırı geçer ve hiçbir şey yapmamak geçerli bir cevap olacak şekilde yazılır. |
Raporun çalışma kuralları bölümündeki bir satır sözleşmeyi taşır ve yapıştırmadan önce okumaya değer: karar bekleyen gözlemler başlığı altındaki hiçbir şey için kodu değiştirme, önce sor, ölçülen değeri aktar ve olduğu gibi kalsın cevabını kabul et.
Her kontrolün geçmesi gereken sınav
Doğru kurulmuş, sorunsuz bir sayfa bu kontrolü haklı olarak tetikleyebilir mi? Cevap evetse, adı ne olursa olsun o bir karar meselesidir. 53 analizör anahtarının tamamı ve beş render farkı satırı, bir tabloda birer satırlık gerekçe taşır; böylece bir inceleyici tek koda bakmadan tek satıra itiraz edebilir. Kimsenin sınıflandırmadığı anahtar karar bekleyen sayılır, çünkü gereksiz bir soru iki hatanın ucuz olanıdır.
Altyapı satırı
Rapor bu sayfayı neyin sunduğunu cevaplar ve yalnız güvendiği adları basar. Bu, analizörün cevapladığı sorudan daha zor bir sorudur; analizör bir adın bu HTML'de geçip geçmediğine bakar ve ikisi gerçek sayfalarda ayrıştı. Wikipedia'nın SEO makalesi Blogger diye bildirildi, çünkü makale bir blogspot.com adresini kaynak gösteriyordu. Bir Next.js sitesi WordPress diye bildirildi, çünkü tek bir görsel taşımadan kalma bir /wp-content/uploads/ yolu taşıyordu.
Bu yüzden tanınmayan altyapı tahmin olarak değil bilinmiyor olarak basılır; bir içerik sistemi ile bir çerçeve birlikte tespit edildiğinde de satır bir çekince taşır. O ikili ya başsız bir kurulumdur ya da taşımadan kalan bir kalıntı; asistan bir şeyi düzeltmeden önce hangisi olduğunu belirlemek zorundadır.
| Sayfa | Satır ne yazıyor |
|---|---|
| Bir WordPress haber sitesi | WordPress 7.2 (CMS) · Gutenberg (sayfa kurucu) |
| Bir Next.js App Router sayfası | Next.js (çerçeve) |
| example.com | tanımlanamadı |
| Taşınmış medya taşıyan bir Next.js sitesi | Next.js (çerçeve) · WordPress (CMS) ve yanında çekince |
Hep İngilizcedir ve bu eksik bir çeviri değildir
Raporun etrafındaki panel üç dilli kalır: kart başlığı, düğme, açılır bölüm ve notlar sizin dilinizde gelir. Belge gelmez. Onu okuyan şey, tanımlayıcıları, HTML öznitelikleri ve çerçeve arayüzleri zaten İngilizce olan bir kod tabanında çalışan bir kod asistanıdır; SEO sözlüğü de İngilizcedir. Türkçe bir rapor rel=canonical'ın yanına Türkçe bir tamlama yazmak zorunda kalırdı; bu kimseye yaramaz ve asistanı var olmayan bir öznitelik adı uydurmaya davet eder. Panel bunu bloğun altında sizin dilinizde anlatır.
Boyut ve tavana gelindiğinde
Tavan 20.000 karakter, kabaca 5.000 token. Gerçek sayfalarda belge 8.000 ile 14.000 arasına oturuyor; yani tavan rutin bir kesme değil bir sigorta. Attığında önce karar bekleyen gözlemler sondan düşer, çünkü onlar görev taşımaz ve birini atmak asistanın zaten yapmayacağı bir işi eksiltmez. Ardından en düşük şiddetli bulgular gider ve bir satır kaç tanesinin gittiğini yazar. Panoya her zaman ekrandaki belgenin tamamı gider.
Yapıştırmadan önce okuyun
Belge kapalı bir açılır bölümün altında durur. Kimse kendi kod tabanının asistanına, önce okuyamadığı bir şeyi yapıştırmamalı; panel de raporun ölçülen değerleri birebir taşıdığını iddia ediyor. Bu iddiayı sözümüze güvenerek değil tek tıkla kontrol edebilirsiniz.
Kopyalama işleminin kendisi reddedilebilir: tarayıcı panoya yazmadan önce panel belgesinin odakta olmasını ister. Reddederse düğmenin üstündeki yazı değişmez, yani olmamış bir kopyalama iddia edilmez. Panelin içine bir tıklayın ve yeniden basın.
Bilerek dışarıda bırakılanlar
- Puan. Asistan için hiçbir anlamı yok ve puanı yükselt bir kod değişikliği değil.
- Her pazarlama cümlesi ve her övgü sözcüğü.
- Kesin olmayan hiçbir şey kesinmiş gibi.
- Hız sayıları. Tek cihazda tek oturum saha verisi değildir ve bir kod tabanını ona göre ayarlamak yanlış olur.
- Zaten sorunsuz bir sayfaya zarar verecek talimatlar. Tam bu sebeple dört görev satırı kaldırıldı; içlerinden biri, büyük harf yüzünden bir adresi yeniden adlandırmaktı ve bu, sıralamayı ve o adrese verilmiş bütün linkleri harcar.