Oil UI
Cẩm nang kịch bản · Cải tạo dự án sẵn có

Cải tạo UI dự án sẵn có: Làm mới React & Web App an toàn

Tạo một bản demo mới tinh từ đầu rất dễ; cải tạo một ứng dụng production đang chạy mà không làm hỏng hợp đồng API, kiểm tra biểu mẫu hay trạng thái URL mới là chỗ các prompt AI một lượt hay gãy. Con đường an toàn là khóa chặt các logic nghiệp vụ bất khả xâm phạm trước, đi theo phạm vi cải tạo từng bước, tự đi hết tác vụ thật có đếm lượt bấm và trích xuất một tệp DESIGN.md dùng chung từ màn hình đầu tiên đã hoàn thiện.

Điểm chính

Khóa chặt các bất biến nghiệp vụ trước

liệt kê rõ API payload, tham số route và form handler mà agent tuyệt đối không được đụng tới.

Cải tạo theo ba bước rõ ràng

Bước 1 dọn nhiễu viền và màu, Bước 2 nâng cấp bố cục và bổ sung trạng thái còn thiếu, Bước 3 gộp các chuỗi modal nhiều trang.

Điểm chính 3

Kiểm chứng tính dễ dùng bằng cách đếm lượt bấm — rút vòng lặp trang chi tiết từ 8 lượt bấm xuống còn 2 thao tác hàng loạt tại chỗ giá trị hơn nhiều so với chỉ thay áo màu.

Điểm chính 4

Khi màn hình trọng điểm vượt qua vòng review, lưu token, thang chữ và giãn cách vào DESIGN.md để mọi route anh em đồng bộ theo.

Số lần nhấp để xong
2bước
Số lần chuyển trang
0trang
Rủi ro đi vòng
Không nhảy trang · xem song song + xử lý nhóm & hoàn tác 1 chạm
Nhành · Sổ liên hệ
Hàng đợi chưa phản hồi (3)
06 thg 10
08 thg 10
09 thg 10
Đã chọn 2
NGỮ CẢNH TIN NHẮN

Zhou Yu · Nhà sách Tiểu Mãn

Hội sách mùa thu & thẻ hội viên

Gửi gần nhất
06 thg 10 · Đã gửi bản đề xuất nháp
Trạng thái
Đang chờ khách phản hồi
“Bản nháp cho hội sách mùa thu & thẻ hội viên đã sẵn sàng để duyệt. Nếu xác nhận trong tuần này, giai đoạn tiếp theo sẽ kịp tiến độ.”
Cài Oil UI Pro cho trọn bộ quy trình chẩn đoán & cải tạo 3 bước
npx github:oil-oil/oil-cli install oil-ui-pro

Để thử bảng hướng thiết kế cơ bản và dọn rập khuôn trên một màn hình trước, hãy chạy npx skills add oil-oil/oil-ui cho bản miễn phí.

Ba bước cải tạo UI: Chọn đúng phạm vi tác động

Các nhóm kỹ thuật thường ngại cho coding agent đụng vào màn hình production vì một prompt mơ hồ kiểu "làm trang này đẹp hơn" có thể làm xáo trộn props component hoặc xóa nhầm bộ lọc đang chạy. Trong Oil UI (và đặc biệt là quy trình dự án sẵn có của Oil UI Pro), việc cải tạo đi theo ba bước rành mạch:

Ba bước cải tạo dự án sẵn có trong Oil UI
BướcKhi nào dùngPhần thay đổiPhần giữ nguyên
Bước 1: Dọn nhiễu thị giácLuồng chạy ổn, nhưng viền, cỡ chữ, khoảng cách và màu sắc bị rối hoặc lỗi thờiThang typography, lược bỏ viền thừa, căn hàng, tiết chế màu sắc và làm gọn thẻCấu trúc DOM, route, state hook và toàn bộ luồng tương tác
Bước 2: Nâng cấp bố cục & trạng tháiPhân cấp thị giác bị phẳng, thao tác chính bị chìm hoặc thiếu trạng thái tải/trống/lỗiPhân cấp phân vùng, tỷ lệ nhiều cột, điểm ngắt responsive và đầy đủ trạng thái UIHợp đồng API backend, logic nghiệp vụ và điều hướng liên trang
Bước 3: Làm lại luồng rườm rà & trích xuất DESIGN.mdNgười dùng phải bấm qua nhiều modal chồng chéo hoặc màn hình rời rạc để xong việc cơ bảnGộp bước thao tác, sửa trực tiếp tại chỗ, thiết kế lại màn hình trọng điểm và tạo DESIGN.md toàn repoMô hình dữ liệu nền tảng và các quy tắc toàn vẹn dữ liệu

Bốn bước cải tạo ứng dụng đang chạy một cách an toàn

Dù bạn đang làm mới ứng dụng duyệt hợp đồng (như MOQI trong thư viện), trình theo dõi sprint (Relay), ứng dụng email (Post) hay luồng thanh toán (Pinch Checkout), hãy đi theo trình tự có kiểm soát:

  1. Chụp màn hình hiện tại và chạy chẩn đoán có chú thích

    Để agent chụp ảnh trang đang chạy trước rồi liệt kê các lỗi trực quan và tương tác được đánh số (ví dụ: ba nút màu chính tranh nhau trên header, bảng 12 cột bị cắt ở 1280px, hoặc hiện hộp alert thô khi lỗi).

  2. Cải tạo một màn hình trọng điểm trước

    Đừng sửa hai mươi route cùng một lúc. Chọn một màn hình mà người dùng dành nhiều thời gian nhất, so sánh 2 đến 3 hướng cải tạo với dữ liệu thật rồi chốt phương án tốt nhất.

  3. Đi hết tác vụ người dùng thật và đếm số lượt bấm

    Tự bấm và nhập liệu qua toàn bộ luồng trên trình duyệt — lọc dữ liệu, gửi biểu mẫu, kích hoạt lỗi kiểm tra hợp lệ và khôi phục. Xác nhận các tác vụ tần suất cao tốn ít bước hơn trước.

  4. Trích xuất DESIGN.md và áp dụng ra các trang lân cận

    Khi màn hình trọng điểm đã qua vòng review trực quan, để agent ghi bảng màu bề mặt, thang chữ, mật độ bảng và quy tắc chống rập khuôn vào DESIGN.md, rồi áp dụng quy chuẩn đó cho phần còn lại của ứng dụng.

Mẫu Prompt để cải tạo một màn hình sẵn có

Dùng cấu trúc này trong Claude Code, Codex hoặc Cursor để nâng cấp một view đang chạy mà vẫn bảo vệ logic ứng dụng:

Mẫu prompt cải tạo UI dự án sẵn có
Dùng Oil UI để cải tạo [đường dẫn route hoặc component, ví dụ: app/billing/page.tsx] trong dự án này.
- Hành vi cần bảo toàn tuyệt đối: Giữ nguyên toàn bộ [truy vấn dữ liệu, tham số bộ lọc trên URL, quy tắc kiểm tra biểu mẫu và các handler gửi/xuất dữ liệu] hiện có. Không xóa bất kỳ trường nghiệp vụ nào.
- Vấn đề hiện tại cần sửa: [ví dụ: phân vùng nào cũng giống hệt một thẻ có viền; các cột bảng xuống dòng gượng; thiếu trạng thái bộ lọc trống và thanh toán thất bại].
- Bước cải tạo: [Chọn: Bước 1 dọn nhiễu / Bước 2 nâng cấp bố cục & trạng thái / Bước 3 làm lại luồng & trích xuất DESIGN.md].
Hãy bắt đầu bằng việc chụp và chẩn đoán màn hình đang chạy hiện tại, đề xuất các hướng thiết kế và kiểm chứng trang hoàn thiện ở 1440×900 và 390×844.

Liệt kê các hành vi cần bảo toàn ngay ở gạch đầu dòng đầu tiên giúp ngăn lỗi hồi quy ngoài ý muốn.

Ví dụ thực tế & prompt trong thư viện

Xem bộ sưu tập →
Oil UI Pro

Cải tạo ứng dụng production đang chạy an toàn với Oil UI Pro

Các prompt thiết kế lại mơ hồ thường làm hỏng bộ lọc và form handler đang chạy. Oil UI Pro chẩn đoán màn hình thật từ ảnh chụp trước, cải tạo theo ba bước kiểm soát chặt, đếm lượt bấm qua tác vụ thật và trích xuất DESIGN.md toàn repo ($19.99 mua một lần).

Khám phá Oil UI Pro →
Sao chép prompt cài đặt Pro
npx github:oil-oil/oil-cli install oil-ui-pro

Câu hỏi thường gặp

Nên định nghĩa global CSS token trước hay cải tạo một màn hình thật trước?

Hãy cải tạo một màn hình đại diện trước. Các tệp token trừu tượng viết trong chân không hiếm khi chịu nổi khi đụng mật độ bảng thật và các trạng thái biểu mẫu. Hoàn thiện một màn hình trọng điểm với dữ liệu thật giúp việc rút ra token chuẩn xác vào DESIGN.md trở nên tự nhiên.

Tôi có thể cải tạo dần một ứng dụng cũ mà không viết lại các widget bên thứ ba không?

Có. Một lượt Bước 1 hoặc Bước 2 có thể sắp xếp lại lưới trang, typography, giãn cách và các trạng thái xung quanh trong khi giữ nguyên các widget nhúng phức tạp cho tới khi bạn sẵn sàng thay thế.

Làm sao kiểm chứng bản thiết kế mới thực sự cải thiện tính dễ dùng?

Kiểm tra hai điều: thứ nhất, làm mờ chữ để xác nhận thao tác chính và trạng thái ngoại lệ vẫn nổi bật về mặt cấu trúc; thứ hai, hoàn thành tác vụ người dùng chính trên trình duyệt và xác nhận số lượt bấm, việc cuộn tìm kiếm và khôi phục lỗi đều nhanh hơn trước.

DESIGN.md được lưu ở đâu sau khi trích xuất?

Đặt DESIGN.md ở thư mục gốc repository hoặc thư mục docs/. Bất cứ khi nào bạn hay đồng đội làm tính năng mới trong Claude Code, Codex hay Cursor, hãy trỏ agent tới DESIGN.md để các màn hình mới khớp với hệ thống đã chốt.

Hướng dẫn liên quan

Hướng dẫn UI Cursor & Windsurf ↗Khắc phục UI AI rập khuôn ↗Blind Review màn hình thật ↗