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
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.”
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:
| Langkah | Kapan digunakan | Apa yang berubah | Apa yang tetap tidak tersentuh |
|---|---|---|---|
| Langkah 1: Rapikan derau visual | Alurnya bekerja, tetapi garis tepi, ukuran huruf, jarak, dan warna terasa berantakan atau usang | Skala tipografi, pengurangan garis tepi, perataan, pengendalian warna, dan perapian kartu | Struktur DOM, rute, state hooks, dan seluruh alur interaksi |
| Langkah 2: Tingkatkan tata letak & status | Hierarki visual datar, tindakan utama terkubur, atau status memuat/kosong/error hilang | Hierarki bagian, proporsi multikolom, breakpoint responsif, dan status UI lengkap | Kontrak API backend, logika bisnis, dan navigasi antarhalaman |
| Langkah 3: Rombak alur kaku & ekstrak DESIGN.md | Pengguna mengklik melalui modal bertumpuk atau layar terpecah untuk menyelesaikan tugas dasar | Konsolidasi langkah, pengeditan sebaris, desain ulang layar unggulan, dan DESIGN.md seluruh repositori | Model 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:
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).
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.
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.
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:
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 →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 →npx github:oil-oil/oil-cli install oil-ui-proPertanyaan 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.


