Oil UI
Senaryo Rehberi · Mevcut Proje Yenileme

Mevcut Proje UI Yenilemesi: React ve Web Uygulamalarını Güvenle Tazeleme

Sıfırdan sıfır kilometre bir demo üretmek kolaydır; API sözleşmelerini, form doğrulamayı veya URL durumunu bozmadan canlı bir üretim uygulamasını yenilemek ise tek seferlik yapay zekâ prompt’larının dağıldığı noktadır. Güvenli yol, önce vazgeçilmez iş mantığınızı kilitlemek, adım adım bir yenileme kapsamı izlemek, tıklamaları sayarak gerçek görevi yürütmek ve biten ilk ekranınızdan ortak bir DESIGN.md çıkarmaktır.

Öne çıkan noktalar

Önce iş kurallarını kilitleyin

agent’ın dokunmaması gereken API yüklerini, rota parametrelerini ve form işleyicilerini listeleyin.

Üç net adımda yenileyin

Adım 1 kenarlık ve renk gürültüsünü temizler, Adım 2 yerleşimi ve eksik durumları yükseltir, Adım 3 çok sayfalı modal zincirlerini sadeleştirir.

Önemli nokta 3

Kullanılabilirliği tıklamaları sayarak doğrulayın—8 tıklamalık bir ayrıntı sayfası döngüsünü 2 satır içi toplu eyleme indirmek, kozmetik bir dış görünüş değişiminden çok daha değerlidir.

Önemli nokta 4

Amiral gemisi ekranınız incelemeden geçer geçmez token’larını, yazı ölçeğini ve boşluklarını DESIGN.md içine kaydedin ki her kardeş rota uyum sağlasın.

Tamamlama tıklaması
2adım
Sayfa geçişleri
0sayfa
Geri dönme riski
Sıfır geçiş · bölünmüş önizleme + tek tıkla toplu işlem ve geri alma
Dal · Yazışmalar
Yanıtsız kuyruk (3)
06 Eki
08 Eki
09 Eki
2 seçili
MESAJ BAĞLAMI

Zhou Yu · Xiaoman Kitabevi

Sonbahar kitap fuarı ve üyelik kartları

Son gönderim
06 Eki · Taslak teklif iletildi
Durum
Müşteri yanıtı bekleniyor
“Sonbahar kitap fuarı ve üyelik kartları taslağı incelemeniz için hazır. Bu hafta onaylarsanız bir sonraki aşamayı takvimde tutabiliriz.”
Tam 3 adımlı yenileme ve teşhis iş akışı için Oil UI Pro’yu kurun
npx github:oil-oil/oil-cli install oil-ui-pro

Önce tek bir ekranda temel yön panolarını ve anti-slop temizliğini denemek için ücretsiz skill adına npx skills add oil-oil/oil-ui komutunu çalıştırın.

UI Yenilemenin Üç Adımı: Etki Alanınızı Seçin

Ekipler çoğu zaman “bu sayfayı daha güzel göster” gibi belirsiz bir prompt bileşen prop’larını karıştırabileceği veya çalışan filtreleri silebileceği için kodlama agent’larının üretim görünümlerine dokunmasına izin vermekte tereddüt eder. Oil UI’da (ve özellikle Oil UI Pro’daki mevcut proje iş akışında) yenilemeler üç açık adımı izler:

Oil UI’da mevcut proje yenilemenin üç adımı
AdımNe zaman kullanılırNeler değişirNelere dokunulmaz
Adım 1: Görsel gürültüyü temizleAkış çalışıyor ama kenarlıklar, yazı boyutları, boşluklar ve renkler dağınık veya eskimiş duruyorTipografik ölçek, kenarlık sadeleştirme, hizalama, renk ölçülülüğü ve kart temizliğiDOM yapısı, rotalar, durum hook’ları ve tüm etkileşim akışları
Adım 2: Yerleşimi ve durumları yükseltGörsel hiyerarşi düz, temel eylemler gömülü veya yükleme/boş/hata durumları eksikBölüm hiyerarşisi, çok sütunlu oranlar, duyarlı kırılma noktaları ve eksiksiz UI durumlarıArka uç API sözleşmeleri, iş mantığı ve sayfalar arası gezinme
Adım 3: Hantal akışları yeniden kur ve DESIGN.md çıkarKullanıcılar temel görevleri tamamlamak için üst üste modallardan veya dağınık ekranlardan geçiyorAdım birleştirme, satır içi düzenleme, amiral gemisi ekran yeniden tasarımı ve depo çapında DESIGN.mdTemel alan modeli ve veri bütünlüğü kuralları

Canlı Bir Uygulamayı Güvenle Yenilemek İçin Dört Adım

İster bir sözleşme inceleme uygulamasını (galerideki MOQI gibi), ister bir sprint takip aracını (Relay), bir e-posta istemcisini (Post) ya da bir ödeme akışını (Pinch Checkout) tazeliyor olun, kontrollü bir sıra izleyin:

  1. Mevcut ekranı yakalayın ve açıklamalı bir teşhis çalıştırın

    Önce agent’ın çalışan sayfanın ekran görüntüsünü almasını ve numaralandırılmış görsel ve etkileşim kusurlarını listelemesini sağlayın (örneğin: üst bilgide yarışan üç birincil renkli düğme, 1280px’te kırpılan 12 sütunlu bir tablo veya hatada çıkan ham uyarı kutuları).

  2. Önce tek bir amiral gemisi ekranı yenileyin

    Aynı anda yirmi rotaya dokunmayın. Kullanıcıların en çok zaman geçirdiği tek ekranı seçin, gerçek verilerle 2 veya 3 yenileme yönünü karşılaştırın ve kazananı sabitleyin.

  3. Tam kullanıcı görevini yürüyün ve tıklamaları sayın

    Tarayıcıda gerçek akış boyunca tıklayın ve yazın—filtreleme, gönderme, doğrulama hatası tetikleme ve kurtarma. Sık kullanılan görevlerin eskisinden daha az adım aldığını doğrulayın.

  4. DESIGN.md çıkarın ve kardeş sayfalara yayın

    Amiral gemisi ekran görsel incelemeden geçtikten sonra agent’ın yüzey paletini, yazı ölçeğini, tablo yoğunluğunu ve anti-slop kurallarını DESIGN.md içine yazmasını sağlayın, ardından bu spesifikasyonu uygulamanın geri kalanına uygulayın.

Mevcut Bir Ekranı Yenilemek İçin Prompt Şablonu

Uygulama mantığınızı koruyarak canlı bir görünümü yükseltmek için Claude Code, Codex veya Cursor’da bu yapıyı kullanın:

Mevcut proje UI yenileme prompt şablonu
Bu projedeki [rota veya bileşen yolu, ör. app/billing/page.tsx] ekranını yenilemek için Oil UI kullan.
- Kesinlikle korunacak davranışlar: Mevcut tüm [veri sorgularını, URL filtre parametrelerini, form doğrulama kurallarını ve gönder/dışa aktar işleyicilerini] olduğu gibi koru. Hiçbir alan verisini silme.
- Düzeltilecek mevcut sorunlar: [ör. her bölüm özdeş kenarlıklı bir kart gibi görünüyor; tablo sütunları garip kırılıyor; boş filtre ve başarısız ödeme durumları eksik].
- Yenileme adımı: [Seçin: Adım 1 gürültüyü temizle / Adım 2 yerleşimi ve durumları yükselt / Adım 3 akışı yeniden kur ve DESIGN.md çıkar].
Mevcut canlı ekranı yakalayıp teşhis ederek başla, yönler öner ve bitmiş sayfayı 1440×900 ile 390×844 boyutlarında doğrula.

İlk maddede korunan davranışları listelemek kazara gerilemeleri önler.

Çalışan galeri örnekleri ve prompt’lar

Koleksiyona göz at →
Oil UI Pro

Oil UI Pro ile canlı üretim uygulamalarını güvenle yenileyin

Belirsiz yeniden tasarım prompt’ları çoğu zaman çalışan filtreleri ve form işleyicilerini bozar. Oil UI Pro önce canlı ekranınızı ekran görüntülerinden teşhis eder, üç kontrollü adımda yeniler, gerçek görev boyunca tıklamaları sayar ve depo çapında bir DESIGN.md çıkarır ($19.99 tek seferlik satın alma).

Oil UI Pro’yu keşfet →
Pro kurulum prompt’unu kopyala
npx github:oil-oil/oil-cli install oil-ui-pro

Sık sorulan sorular

Önce global CSS token’larını mı tanımlamalıyım yoksa önce gerçek bir ekranı mı yenilemeliyim?

Önce temsili bir ekranı yenileyin. Boşlukta yazılan soyut token dosyaları gerçek tablo yoğunluğu ve form durumlarıyla karşılaştığında nadiren ayakta kalır. Gerçek verilerle tek bir amiral gemisi ekranı kusursuzlaştırmak, doğru token’ları DESIGN.md içine çıkarmayı kolaylaştırır.

Üçüncü taraf bileşenleri yeniden yazmadan eski bir uygulamayı artımlı olarak yenileyebilir miyim?

Evet. Bir Adım 1 veya Adım 2 geçişi, siz değiştirmeye hazır olana kadar karmaşık gömülü bileşenlere dokunmadan sayfa ızgarasını, tipografiyi, boşlukları ve çevreleyen durumları yeniden düzenleyebilir.

Bir yeniden tasarımın kullanılabilirliği gerçekten artırdığını nasıl doğrularım?

İki şeyi kontrol edin: birincisi, birincil eylemin ve istisna durumlarının yapısal olarak öne çıktığını doğrulamak için metni bulanıklaştırın; ikincisi, tarayıcıda ana kullanıcı görevini tamamlayın ve tıklama sayısının, kaydırma aramasının ve hata kurtarmanın eskisinden hızlı olduğunu doğrulayın.

DESIGN.md çıkarıldıktan sonra nerede tutulur?

DESIGN.md dosyasını depo kök dizininizde veya docs/ klasöründe tutun. Siz ya da bir ekip arkadaşınız Claude Code, Codex veya Cursor’da yeni bir özellik geliştirirken yeni ekranların kurulan sistemle uyuşması için agent’ı DESIGN.md dosyasına yönlendirin.

İlgili kılavuzlar

Cursor ve Windsurf UI Kılavuzu ↗Basmakalıp Yapay Zekâ Arayüzlerini Düzeltme ↗Gerçek Ekran Kör İncelemesi ↗