Oil UI
Agent Kılavuzu · Cursor / Windsurf / IDE’ler

Cursor, Windsurf ve IDE Kodlama Agent’larında Oil UI Kullanımı

Birçok geliştirici arayüzleri doğrudan Cursor, Windsurf, Antigravity veya Gemini CLI içinde uygulama kodlarının yanında oluşturur ve iyileştirir. Oil UI açık skill biçimini kullandığından, tek bir npx skills add oil-oil/oil-ui komutu bu IDE agent’larını aynı görev odaklı iş akışıyla donatır: yönleri keşfedin, yığınınız içinde çalışan durumları uygulayın ve işlenmiş ekran görüntülerini doğrulayın.

Öne çıkan noktalar

Tek kurulum aracı başlıca kodlama agent’larını kapsar

npx skills add oil-oil/oil-ui komutunu çalıştırıp Cursor, Windsurf, Claude Code veya Codex’i seçin.

Önemli nokta 2

Mevcut bir kod tabanı içindeki ekranları yenilerken her prompt’u tek bir sayfa veya kullanıcı akışıyla sınırlayın ve dokunulmaması gereken prop’ları, hook’ları ve rotaları listeleyin.

Önemli nokta 3

Bağımsız UI modülleri (yükleyiciler, ödeme modülleri, yapılandırıcılar) için agent’tan baştan itibaren boşta, etkin, tamamlanmış ve hata durumlarını uygulamasını isteyin.

Önemli nokta 4

Yalnızca kod farklarına güvenmek yerine IDE agent’ınızın yerel geliştirme sunucusunu açmasını ve gerçek 1440px ile 390px tarayıcı ekran görüntülerini incelemesini sağlayın.

Cursor, Windsurf ve IDE agent’ları için ücretsiz açık kaynak Oil UI Skill’i kurun
npx skills add oil-oil/oil-ui

Hem proje kapsamlı kurulumu (ekibinizle paylaşılan) hem de kullanıcı düzeyinde kurulumu destekler.

IDE ve CLI Agent’larında Oil UI Kurulumu

İster Cursor’ın agent kenar çubuğunda, ister Windsurf Cascade’de, Antigravity’de veya bir terminal agent’ında çalışın, Oil UI aynı tasarım iş akışını ve görsel inceleme kontrol listelerini sunar.

  1. Etkileşimli skill kurulum aracını çalıştırın

    Komutu proje kök dizininizde veya terminalde çalıştırın ve günlük kullandığınız kodlama agent’larını seçin.

    npx skills add oil-oil/oil-ui
  2. Ekip tutarlılığı için proje kapsamlı kurulumu kullanın

    Proje kapsamını seçmek skill’i deponuzun içine yerleştirir, böylece her ekip arkadaşınızın IDE agent’ı aynı yerleşim ve inceleme standartlarını izler.

  3. Prompt’unuzda Oil UI’ı açıkça çağırın

    Agent’ın stillere rastgele yama yapmak yerine tasarım iş akışını çalıştırması için UI prompt’larını “...tasarlamak için Oil UI kullan” veya “Bu ekranı yenilemek için Oil UI kullan” ile başlatın.

Mevcut Bir Kod Tabanı İçinde Tasarım Yaparken Dört Alışkanlık

Bir IDE agent’ında en sık görülen hata biçimi, arka uç tesisatıyla tam görsel yeniden tasarımı tek bir dağınık prompt’ta karıştırmaktır. Sorumlulukları ayırmak hem kodu hem de yerleşimi temiz tutar:

Tek seferde tek bir kendi kendine yeterli modüle veya görev akışına odaklanın
Bitişik ekranlara geçmeden önce galerideki Chute dosya yükleme modülü veya KEEB mekanik klavye yapılandırıcısı gibi tek bir modülü uçtan uca parlatın.
Hangi veri hook’larının ve işleyicilerin dokunulmaz olduğunu belirtin
Üretimdeki bir React veya Vue görünümünü güncellerken agent’a şunu söyleyin: “Mevcut form durumunu, API mutasyonlarını ve rota parametrelerini koru; yalnızca yerleşimi, hiyerarşiyi ve durum geri bildirimini yeniden düzenle.”
Birleştirmeden önce yeni yönleri geçici bir rotada karşılaştırın
Bir sayfanın taze bir görsel yöne ihtiyacı varsa, önce agent’ın 3 farklı seçeneği yan yana oluşturmasına izin verin, ardından seçilen yönü ana bileşenlerinize aktarın.
Her zaman localhost üzerinde masaüstü ve mobil genişliklerde doğrulayın
Bir diff’i kabul etmeden önce taşma, sıkışık boşluklar veya bozuk kontrastı yakalamak için agent’ın çalışan geliştirme sunucusunu açmasını ve 1440px ile 390px ekran görüntüleri almasını sağlayın.

Cursor ve Windsurf’te Modülleri Parlatmak İçin Yeniden Kullanılabilir Prompt

IDE sohbetinizde hedef bileşen dosyasını etiketleyin ve eksiksiz, çok durumlu bir uygulama elde etmek için bu yapıyı kullanın:

Etkileşimli UI modülleri için IDE agent prompt’u
Bu depodaki [modül adı, ör. dosya paylaşım yükleme modülümüz / ürün yapılandırıcımız] için tasarım ve uygulama yapmak üzere Oil UI kullan.
- Kod tabanı kısıtlamaları: Mevcut [hook’ları, prop’ları ve API tiplerini] değiştirmeden koru.
- Gerekli durumlar: 1) varsayılan boşta durumu, 2) etkin sürükleme/girdi geri bildirimi, 3) ilerleme ve tamamlanma durumu (kopyalama/paylaşma onayıyla) ve 4) doğrulama veya sınır hata durumu uygulamasını yap.
- Görsel disiplin: Kart içinde kart sarmalayıcılarından ve dekoratif üst etiket haplarından kaçın. Hiyerarşiyi tipografik ölçek, boşluk ve net odak durumlarıyla kur, ardından yerel tarayıcıda doğrula.

Cursor veya Windsurf’te mevcut bileşen dosyanıza referans verirken iyi çalışır.

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

Koleksiyona göz at →
Oil UI Pro

Oil UI Pro ile mevcut proje yenileme ve bileşen zanaatını açın

Oil UI Pro, mevcut kod tabanları için özel iş akışları ekler—açıklamalı tek sayfa teşhisi, 3 kademeli yenileme sistemi (gürültü temizle / yükselt / akışı yeniden kur + DESIGN.md) ve tek bileşende üst düzey ince ayar dahil.

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

Oil UI kullanırken Cursor veya Windsurf içinde hangi modeli seçmeliyim?

Yeni görsel yönler keşfederken veya karmaşık sayfaları yeniden yapılandırırken Claude Opus ya da öncü GPT/Codex modellerini kullanın. Bir yön veya DESIGN.md belirlendikten sonra, Claude Sonnet ve daha hızlı modeller kardeş ekranlara durumları yaymak için iyi çalışır.

Oil UI; shadcn/ui, Radix veya Tailwind ile birlikte çalışır mı?

Evet. Temel bileşen kütüphaneleri erişilebilir kontroller sağlarken, Oil UI sayfa kompozisyonunu, görsel hiyerarşiyi, yön keşfini ve anti-slop sadeleştirmesini yönetir. Birbirlerini temiz bir şekilde tamamlarlar.

Agent’ın mevcut tıklama işleyicilerini veya form doğrulamalarını bozmadığından nasıl emin olurum?

Korunacak işleyicileri prompt’unuzda listeleyin ve Oil UI’ın yürütme adımını izleyin: bitirmeden önce tarayıcıda birincil akışa gerçekten tıklayıp geçin ve geçersiz bir form gönderimini tetikleyin.

Ekibim aynı depoda Cursor ve Claude Code / Codex’i birlikte kullanabilir mi?

Evet. npx skills add oil-oil/oil-ui sırasında ilgili tüm agent’ları seçin veya her aracın aynı tasarım kurallarını okuması için ortak bir DESIGN.md dosyasını depoya işleyin.

İlgili kılavuzlar

Claude Code UI Tasarım Kılavuzu ↗Mevcut Proje UI Yenilemesi ↗Basmakalıp Yapay Zekâ Arayüzlerini Düzeltme ↗