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
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 độ.”
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:
| Bước | Khi nào dùng | Phần thay đổi | Phần giữ nguyên |
|---|---|---|---|
| Bước 1: Dọn nhiễu thị giác | Luồ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ời | Thang 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ái | Phâ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ỗi | Phân cấp phân vùng, tỷ lệ nhiều cột, điểm ngắt responsive và đầy đủ trạng thái UI | Hợ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.md | Ngườ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ản | Gộ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 repo | Mô 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:
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).
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.
Đ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.
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:
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 →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 →npx github:oil-oil/oil-cli install oil-ui-proCâ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.


