Oil UI
Panduan Agen · Cursor / Windsurf / IDE

Menggunakan Oil UI di Cursor, Windsurf & Agen Pemrograman IDE

Banyak pengembang membangun dan menyempurnakan antarmuka langsung di dalam Cursor, Windsurf, Antigravity, atau Gemini CLI berdampingan dengan kode aplikasi mereka. Karena Oil UI menggunakan format skill terbuka, satu perintah npx skills add oil-oil/oil-ui membekali agen IDE ini dengan alur kerja berorientasi tugas yang sama: eksplorasi arah, implementasikan status yang berfungsi di dalam stack Anda, dan verifikasi tangkapan layar hasil render.

Poin utama

Satu penginstal mencakup agen pemrograman utama

jalankan npx skills add oil-oil/oil-ui lalu pilih Cursor, Windsurf, Claude Code, atau Codex.

Poin penting 2

Saat menyegarkan layar di dalam basis kode yang ada, batasi setiap prompt ke satu halaman atau alur pengguna dan cantumkan props, hooks, serta rute yang tidak boleh disentuh.

Poin penting 3

Untuk modul UI mandiri (pengunggah, checkout, konfigurator), minta agen mengimplementasikan status idle, aktif, selesai, dan error sejak awal.

Poin penting 4

Minta agen IDE Anda membuka server pengembangan lokal dan memeriksa tangkapan layar peramban nyata 1440px dan 390px alih-alih hanya mengandalkan diff kode.

Instal Skill Oil UI open-source gratis untuk agen Cursor, Windsurf & IDE
npx skills add oil-oil/oil-ui

Mendukung instalasi lingkup proyek (dibagikan ke tim Anda) maupun instalasi tingkat pengguna.

Menginstal Oil UI di Seluruh Agen IDE dan CLI

Baik Anda bekerja di bilah samping agen Cursor, Windsurf Cascade, Antigravity, maupun agen terminal, Oil UI menyediakan alur kerja desain dan daftar periksa tinjauan visual yang sama.

  1. Jalankan penginstal skill interaktif

    Eksekusi perintah di root proyek atau terminal Anda dan pilih agen pemrograman yang Anda gunakan sehari-hari.

    npx skills add oil-oil/oil-ui
  2. Gunakan instalasi lingkup proyek untuk konsistensi tim

    Memilih lingkup proyek menempatkan skill di dalam repositori Anda sehingga agen IDE setiap anggota tim mengikuti standar tata letak dan tinjauan yang sama.

  3. Panggil Oil UI secara eksplisit di dalam prompt Anda

    Awali prompt UI dengan "Gunakan Oil UI untuk merancang..." atau "Gunakan Oil UI untuk menyegarkan layar ini..." agar agen menjalankan alur kerja desain alih-alih menambal gaya secara acak.

Empat Kebiasaan untuk Merancang di Dalam Basis Kode yang Ada

Mode kegagalan paling umum pada agen IDE adalah mencampur plumbing backend dan perombakan visual penuh dalam satu prompt yang melebar. Memisahkan cakupan menjaga kode dan tata letak tetap bersih:

Batasi pada satu modul mandiri atau alur tugas per sesi
Sempurnakan satu modul secara menyeluruh—seperti modul unggah file Chute atau konfigurator papan ketik mekanis KEEB di galeri—sebelum berpindah ke layar di sebelahnya.
Nyatakan data hooks dan handler mana yang terlarang diubah
Saat memperbarui tampilan React atau Vue produksi, beri tahu agen: "Pertahankan status formulir, mutasi API, dan parameter rute yang ada; rombak tata letak, hierarki, dan umpan balik statusnya saja."
Bandingkan arah baru di rute sementara sebelum menggabungkan
Jika halaman membutuhkan arah visual segar, biarkan agen merender 3 opsi berbeda secara berdampingan terlebih dahulu, baru pindahkan arah terpilih ke komponen utama Anda.
Selalu verifikasi di localhost pada lebar desktop dan seluler
Sebelum menerima diff, minta agen membuka server pengembangan yang berjalan dan mengambil tangkapan layar 1440px serta 390px untuk menangkap luapan, jarak sesak, atau kontras yang rusak.

Prompt Siap Pakai untuk Menyempurnakan Modul di Cursor & Windsurf

Tandai file komponen target di obrolan IDE Anda dan gunakan struktur ini untuk mendapatkan implementasi multistatus yang lengkap:

Prompt agen IDE untuk modul UI interaktif
Gunakan Oil UI untuk merancang dan mengimplementasikan [nama modul, mis. modul unggah berbagi file / konfigurator produk kami] di repositori ini.
- Batasan basis kode: Pertahankan [hooks, props, dan tipe API] yang ada tanpa perubahan.
- Status wajib: Implementasikan 1) status idle default, 2) umpan balik seret/input aktif, 3) status progres dan selesai (beserta konfirmasi salin/bagikan), dan 4) status error validasi atau batas.
- Disiplin visual: Hindari pembungkus kartu-di-dalam-kartu bersarang dan pil eyebrow dekoratif. Bangun hierarki melalui skala tipografi, jarak, dan status fokus yang jelas, lalu verifikasi di peramban lokal.

Bekerja optimal saat mereferensikan file komponen Anda yang sudah ada di Cursor atau Windsurf.

Contoh galeri langsung & prompt

Jelajahi koleksi →
Oil UI Pro

Buka pembaruan proyek yang ada dan keahlian komponen dengan Oil UI Pro

Oil UI Pro menambahkan alur kerja khusus untuk basis kode yang sudah ada—termasuk diagnosis satu halaman beranotasi, sistem pembaruan 3 tingkat (rapikan / tingkatkan / rombak alur + DESIGN.md), dan pemolesan ekstrem satu komponen.

Jelajahi Oil UI Pro →
Salin prompt instalasi Pro
npx github:oil-oil/oil-cli install oil-ui-pro

Pertanyaan umum

Model mana yang sebaiknya saya pilih di Cursor atau Windsurf saat menggunakan Oil UI?

Gunakan Claude Opus atau model GPT/Codex frontier saat mengeksplorasi arah visual baru atau menata ulang halaman kompleks. Setelah arah atau DESIGN.md ditetapkan, Claude Sonnet dan model yang lebih cepat bekerja baik untuk melengkapi status di layar-layar sejenis.

Apakah Oil UI bekerja berdampingan dengan shadcn/ui, Radix, atau Tailwind?

Ya. Pustaka primitif menyediakan kontrol yang aksesibel, sementara Oil UI mengatur komposisi halaman, hierarki visual, eksplorasi arah, dan pengurangan pola AI generik. Keduanya saling melengkapi dengan rapi.

Bagaimana memastikan agen tidak merusak click handler atau validasi formulir yang ada?

Cantumkan handler yang harus dipertahankan di prompt Anda, lalu ikuti langkah penelusuran Oil UI: klik alur utama secara nyata dan picu pengiriman formulir tidak valid di peramban sebelum selesai.

Bisakah tim saya menggunakan Cursor dan Claude Code / Codex pada repositori yang sama?

Ya. Pilih semua agen yang relevan saat menjalankan npx skills add oil-oil/oil-ui atau commit file DESIGN.md bersama agar setiap alat membaca aturan desain yang sama.

Panduan terkait

Panduan Desain UI Claude Code ↗Pembaruan UI Proyek yang Ada ↗Memperbaiki UI AI Slop Generik ↗