Oil UI
Buku Pedoman Skenario · Pembaruan Proyek yang Ada

Pembaruan UI Proyek yang Ada: Segarkan Aplikasi React & Web dengan Aman

Membuat demo proyek baru dari nol itu mudah; memperbarui aplikasi produksi langsung tanpa merusak kontrak API, validasi formulir, atau status URL adalah titik tempat prompt AI sekali jalan berantakan. Jalur amannya adalah mengunci logika bisnis yang tidak boleh berubah terlebih dahulu, mengikuti cakupan pembaruan langkah demi langkah, menelusuri tugas nyata sambil menghitung klik, dan mengekstrak DESIGN.md bersama dari layar pertama yang selesai.

Poin utama

Kunci invarian bisnis terlebih dahulu

daftarkan payload API, parameter rute, dan handler formulir yang tidak boleh disentuh agen.

Lakukan pembaruan dalam tiga langkah jelas

Langkah 1 membuang derau garis tepi dan warna, Langkah 2 meningkatkan tata letak dan status yang hilang, serta Langkah 3 meringkas rantai modal multihalaman.

Poin penting 3

Verifikasi kegunaan dengan menghitung klik—memangkas siklus halaman detail 8 klik menjadi 2 tindakan batch sebaris jauh mengalahkan ganti kulit kosmetik.

Poin penting 4

Begitu layar unggulan Anda lulus tinjauan, simpan token, skala huruf, dan jaraknya ke dalam DESIGN.md agar setiap rute sejenis seragam.

Klik untuk selesai
2langkah
Transisi halaman
0halaman
Risiko bolak-balik
Tanpa lompatan · pratinjau belah + proses massal & urung 1 klik
Ranting · Korespondensi
Antrean belum dibalas (3)
06 Okt
08 Okt
09 Okt
2 dipilih
KONTEKS PESAN

Zhou Yu · Toko Buku Xiaoman

Pameran buku musim gugur & kartu anggota

Terakhir dikirim
06 Okt · Draf proposal terkirim
Status
Menunggu balasan klien
“Draf pameran buku musim gugur & kartu anggota sudah siap ditinjau. Dengan konfirmasi minggu ini, tahap berikutnya tetap sesuai jadwal.”
Instal Oil UI Pro untuk alur kerja pembaruan & diagnosis 3 langkah lengkap
npx github:oil-oil/oil-cli install oil-ui-pro

Untuk mencoba papan arah dasar dan pembersihan anti-slop pada satu layar terlebih dahulu, jalankan npx skills add oil-oil/oil-ui untuk skill gratis.

Tiga Langkah Pembaruan UI: Pilih Radius Dampak Anda

Tim sering ragu membiarkan agen pemrograman menyentuh tampilan produksi karena prompt kabur seperti "buat halaman ini terlihat lebih bagus" dapat mengacak props komponen atau menghapus filter yang bekerja. Di Oil UI (dan khususnya alur kerja proyek yang ada di Oil UI Pro), pembaruan mengikuti tiga langkah eksplisit:

Tiga langkah pembaruan proyek yang ada di Oil UI
LangkahKapan digunakanApa yang berubahApa yang tetap tidak tersentuh
Langkah 1: Rapikan derau visualAlurnya bekerja, tetapi garis tepi, ukuran huruf, jarak, dan warna terasa berantakan atau usangSkala tipografi, pengurangan garis tepi, perataan, pengendalian warna, dan perapian kartuStruktur DOM, rute, state hooks, dan seluruh alur interaksi
Langkah 2: Tingkatkan tata letak & statusHierarki visual datar, tindakan utama terkubur, atau status memuat/kosong/error hilangHierarki bagian, proporsi multikolom, breakpoint responsif, dan status UI lengkapKontrak API backend, logika bisnis, dan navigasi antarhalaman
Langkah 3: Rombak alur kaku & ekstrak DESIGN.mdPengguna mengklik melalui modal bertumpuk atau layar terpecah untuk menyelesaikan tugas dasarKonsolidasi langkah, pengeditan sebaris, desain ulang layar unggulan, dan DESIGN.md seluruh repositoriModel domain dasar dan aturan integritas data

Empat Langkah Memperbarui Aplikasi Langsung dengan Aman

Baik Anda menyegarkan aplikasi tinjauan kontrak (seperti MOQI di galeri), pelacak sprint (Relay), klien email (Post), maupun alur checkout (Pinch Checkout), ikuti urutan yang terkendali:

  1. Tangkap layar saat ini dan jalankan diagnosis beranotasi

    Minta agen mengambil tangkapan layar halaman yang berjalan terlebih dahulu dan mendaftar cacat visual serta interaksi bernomor (misalnya: tiga tombol berwarna utama saling bersaing di header, tabel 12 kolom terpotong pada 1280px, atau kotak alert mentah saat error).

  2. Perbarui satu layar unggulan terlebih dahulu

    Jangan sentuh dua puluh rute sekaligus. Pilih satu layar tempat pengguna paling banyak menghabiskan waktu, bandingkan 2 hingga 3 arah pembaruan dengan data nyata, lalu kunci pemenangnya.

  3. Telusuri tugas pengguna lengkap dan hitung klik

    Klik dan ketik melewati alur nyata di peramban—memfilter, mengirim, memicu error validasi, dan memulihkan. Pastikan tugas berfrekuensi tinggi membutuhkan langkah lebih sedikit dari sebelumnya.

  4. Ekstrak DESIGN.md dan terapkan ke halaman sejenis

    Begitu layar unggulan lulus tinjauan visual, minta agen menuliskan palet permukaan, skala huruf, kepadatan tabel, dan aturan anti-slop ke DESIGN.md, lalu terapkan spesifikasi tersebut ke seluruh bagian lain aplikasi.

Templat Prompt untuk Memperbarui Layar yang Sudah Ada

Gunakan struktur ini di Claude Code, Codex, atau Cursor untuk meningkatkan tampilan langsung sambil melindungi logika aplikasi Anda:

Templat prompt pembaruan UI proyek yang ada
Gunakan Oil UI untuk memperbarui [jalur rute atau komponen, mis. app/billing/page.tsx] di proyek ini.
- Perilaku yang harus dijaga ketat: Pertahankan semua [kueri data, parameter filter URL, aturan validasi formulir, dan handler kirim/ekspor] yang ada. Jangan hapus kolom domain mana pun.
- Masalah saat ini yang harus diperbaiki: [mis. setiap bagian tampak seperti kartu berbingkai identik; kolom tabel terlipat canggung; status filter kosong dan pembayaran gagal hilang].
- Langkah pembaruan: [Pilih: Langkah 1 rapikan derau / Langkah 2 tingkatkan tata letak & status / Langkah 3 rombak alur & ekstrak DESIGN.md].
Mulai dengan menangkap dan mendiagnosis layar langsung saat ini, ajukan arah desain, dan verifikasi halaman jadi pada 1440×900 dan 390×844.

Mencantumkan perilaku yang dipertahankan pada poin pertama mencegah regresi yang tidak disengaja.

Contoh galeri langsung & prompt

Jelajahi koleksi →
Oil UI Pro

Perbarui aplikasi produksi langsung dengan aman bersama Oil UI Pro

Prompt perombakan yang kabur sering merusak filter dan handler formulir yang berjalan. Oil UI Pro mendiagnosis layar langsung Anda dari tangkapan layar terlebih dahulu, memperbarui dalam tiga langkah terkendali, menghitung klik di seluruh tugas nyata, dan mengekstrak DESIGN.md seluruh repo ($19.99 beli sekali).

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

Pertanyaan umum

Haruskah saya mendefinisikan token CSS global dulu atau memperbarui satu layar nyata dulu?

Perbarui satu layar representatif terlebih dahulu. File token abstrak yang ditulis di ruang hampa jarang bertahan saat berhadapan dengan kepadatan tabel nyata dan status formulir. Menyempurnakan satu layar unggulan dengan data nyata membuat ekstraksi token akurat ke DESIGN.md menjadi lugas.

Bisakah saya memperbarui aplikasi lama secara bertahap tanpa menulis ulang widget pihak ketiga?

Ya. Langkah 1 atau Langkah 2 dapat menata ulang kisi halaman, tipografi, jarak, dan status di sekitarnya sambil membiarkan widget tertanam yang kompleks tetap utuh sampai Anda siap menggantinya.

Bagaimana memverifikasi bahwa desain ulang benar-benar meningkatkan kegunaan?

Periksa dua hal: pertama, buramkan teks untuk memastikan tindakan utama dan status pengecualian menonjol secara struktural; kedua, selesaikan tugas pengguna utama di peramban dan pastikan hitungan klik, pencarian gulir, serta pemulihan error lebih cepat daripada sebelumnya.

Di mana DESIGN.md disimpan setelah diekstrak?

Simpan DESIGN.md di root repositori atau folder docs/ Anda. Kapan pun Anda atau rekan tim membangun fitur baru di Claude Code, Codex, atau Cursor, arahkan agen ke DESIGN.md agar layar baru selaras dengan sistem yang telah ditetapkan.

Panduan terkait

Panduan UI Cursor & Windsurf ↗Memperbaiki UI AI Slop Generik ↗Tinjauan Buta Layar Nyata ↗