Khi bước chân vào thế giới Vibe Coding, hầu hết mọi người đều mắc phải một sai lầm chết người giống hệt nhau.
Họ vừa mở phần mềm lập trình lên là đã vội vàng gõ ngay một câu lệnh dài ngoằng: Hãy viết cho tôi một phần mềm quản lý kho hàng có đăng nhập, có quản lý khách hàng và có báo cáo doanh thu. Kết quả là chỉ sau 10 phút, AI bắt đầu tạo ra một đống mã nguồn hỗn độn, tính năng nọ đá vỡ tính năng kia, và màn hình bắt đầu đỏ rực những thông báo lỗi.
Tại sao lại như vậy? Bởi vì bạn đang bắt chú thợ xây đặt những viên gạch đầu tiên khi trong tay chưa hề có một bản vẽ kiến trúc nào cả.
Tài liệu PRD (Product Requirement Document) chính là chiếc la bàn dẫn đường tối thượng trong Vibe Coding. Nếu không có chiếc la bàn này, bạn và AI chắc chắn sẽ bị lạc lối giữa khu rừng kỹ thuật phức tạp.
1. Bản PRD là gì dưới góc nhìn của người làm kinh doanh?
Nhiều người nghe thấy cụm từ PRD thì tưởng rằng đây là thứ tài liệu hàn lâm chỉ dành cho các tập đoàn công nghệ lớn. Nhưng hiểu một cách bình dân nhất: PRD là một bản mô tả chi tiết bài toán kinh doanh và quy trình làm việc thực tế của bạn bằng văn bản.
Hãy hình dung bản PRD giống như bản thiết kế kiến trúc hoàn chỉnh của một ngôi nhà:
- Bản vẽ phải chỉ rõ: Ngôi nhà có bao nhiêu tầng, mỗi tầng có mấy phòng.
- Phòng khách đặt ở đâu, diện tích bao nhiêu mét vuông.
- Cửa chính làm bằng gỗ hay nhôm kính, mở ra phía trước hay phía sau.
- Đường ống nước và dây điện âm tường đi như thế nào để không bị chập cháy.
Khi chú thợ xây AI nhìn vào một bản thiết kế rõ ràng đến từng milimet như vậy, chú sẽ biết chính xác hôm nay cần trộn bao nhiêu bao xi măng, đặt viên gạch ở vị trí nào và không bao giờ tự ý xây một bức tường chắn ngang lối đi.
2. Bốn thành phần cốt lõi bắt buộc phải có trong một bản PRD chuẩn
Một bản PRD thực chiến để nạp cho AI không cần dùng thuật ngữ đao to búa lớn. Bạn chỉ cần trả lời dứt khoát 4 câu hỏi lớn sau đây:
Thành phần 1: Chân dung người dùng và quyền hạn (User Roles)
Bạn phải phân định rõ ràng ai là người sử dụng phần mềm và họ được phép làm những gì:
- Người quản trị tối cao (Admin): Là người chủ doanh nghiệp, nhìn thấy toàn bộ báo cáo tài chính, có quyền xem doanh thu, xem giá vốn và chỉnh sửa thông tin của mọi nhân viên.
- Người quản lý chi nhánh (Manager): Chỉ được xem dữ liệu kho hàng và doanh số của riêng chi nhánh mình quản lý.
- Nhân viên bán hàng (Staff): Chỉ có quyền tạo đơn hàng mới, tra cứu tồn kho và xem danh sách khách hàng do mình phụ trách, tuyệt đối không được xem giá nhập hàng hay lợi nhuận ròng.
Thành phần 2: Danh sách các màn hình làm việc (Screen Map)
Phần mềm của bạn gồm những trang nào? Hãy liệt kê rành mạch từng trang một:
- Trang 1: Màn hình Đăng nhập và Khôi phục mật khẩu.
- Trang 2: Màn hình Bảng điều khiển tổng quan (Dashboard) hiển thị 4 chỉ số: Doanh thu hôm nay, số đơn hàng mới, số khách cần chăm sóc và cảnh báo hàng sắp hết.
- Trang 3: Màn hình Danh sách sản phẩm kèm bộ lọc theo danh mục.
- Trang 4: Màn hình Tạo đơn hàng mới và in phiếu thu.
Thành phần 3: Quy tắc nghiệp vụ cho từng nút bấm (Business Logic)
Đây là phần quan trọng nhất để AI không làm sai lệch số liệu. Với mỗi hành động, bạn phải mô tả nguyên nhân và kết quả:
- Khi nhân viên bấm nút Xác nhận xuất kho: Hệ thống phải tự động trừ số lượng sản phẩm trong kho đi tương ứng, đồng thời ghi lại một dòng nhật ký gồm ngày giờ và tên người bấm.
- Nếu số lượng hàng trong kho nhỏ hơn 5: Hệ thống phải hiển thị dòng chữ cảnh báo màu cam thông báo hàng sắp hết.
- Nếu khách hàng nợ quá 30 ngày: Nút tạo đơn hàng mới cho khách đó phải tự động bị khóa lại.
Thành phần 4: Cấu trúc các trường dữ liệu cần lưu trữ (Data Fields)
Hãy liệt kê rõ từng ô thông tin bạn muốn ghi lại vào cuốn sổ dữ liệu:
- Với khách hàng: Họ và tên, số điện thoại, địa chỉ nhận hàng, nguồn đến từ đâu (Facebook, Zalo hay người quen giới thiệu), tổng tiền đã mua.
- Với sản phẩm: Mã hàng, tên sản phẩm, đơn vị tính (cái, thùng, hộp), giá vốn nhập vào, giá bán lẻ và số lượng tồn kho tối thiểu.
3. Kỹ thuật dùng AI để cùng viết PRD: Biến ý tưởng thô thành tài liệu chuẩn
Bạn không cần phải tự mình ngồi gõ từng chữ của bản PRD từ con số 0. Hãy dùng chính AI như một người thư ký mẫn cán để cùng bạn lên kế hoạch theo 3 bước:
Bước 1: Kể câu chuyện kinh doanh bằng ngôn ngữ đời thường
Bạn hãy nói chuyện với AI giống như đang tâm sự với một người bạn: Tôi đang mở một xưởng may đồng phục có 15 thợ may và 3 nhân viên bán hàng. Hiện tại tôi đang đau đầu vì không nhớ được đơn hàng nào đã cắt vải, đơn nào đang may và đơn nào đã giao cho khách. Tôi muốn làm một web app quản lý tiến độ đơn hàng. Hãy đóng vai một chuyên gia phân tích nghiệp vụ phần mềm và đặt cho tôi 5 câu hỏi để làm rõ yêu cầu này.
Bước 2: Trả lời từng câu hỏi để làm rõ ngóc ngách nghiệp vụ
AI sẽ hỏi bạn những câu rất thực tế: Mỗi đơn hàng có những trạng thái nào? Ai là người cập nhật trạng thái? Khi đơn may xong có cần thông báo qua Zalo không? Bạn trả lời từng câu hỏi theo đúng cách bạn đang vận hành xưởng may mỗi ngày.
Bước 3: Yêu cầu AI đóng gói thành tài liệu PRD hoàn chỉnh
Sau khi đã có đủ thông tin, bạn ra lệnh dứt khoát: Dựa trên toàn bộ câu trả lời trên, hãy tổng hợp lại thành một bản tài liệu PRD hoàn chỉnh bằng tiếng Việt, phân chia rõ ràng các mục: Mục tiêu, Đối tượng, Danh sách màn hình, Quy tắc nghiệp vụ và Bảng cấu trúc dữ liệu.
4. Ba lỗi sai kinh điển cần tránh khi lập PRD
- Lỗi 1: Dùng từ ngữ mơ hồ, chung chung. Đừng viết câu: Hệ thống có báo cáo trực quan và hiện đại. AI không biết thế nào là hiện đại. Hãy viết rõ ràng: Hệ thống có 1 biểu đồ cột thể hiện doanh thu 7 ngày gần nhất và 1 bảng danh sách 5 mặt hàng bán chạy nhất.
- Lỗi 2: Quá tham lam ôm đồm ngay từ phiên bản đầu tiên. Hãy áp dụng nguyên tắc sản phẩm tối thiểu (MVP): Chỉ chọn ra 3 tính năng sống còn nhất giải quyết được 80% công việc hàng ngày để làm trước. Đừng cố thêm tính năng chấm công hay quét mã vạch khi quy trình quản lý đơn hàng còn chưa chạy thông suốt.
- Lỗi 3: Không lưu trữ tài liệu PRD thành một tệp cố định. Bản PRD phải được lưu vào một tệp văn bản riêng biệt trong thư mục dự án (ví dụ đặt tên là PRD.md). Mỗi khi bắt đầu một phiên làm việc mới với AI, bạn chỉ cần nạp lại tệp này để AI nhớ lại toàn bộ quy định của ngôi nhà.
5. Bước tiếp theo trên hành trình Vibe Coding
Khi bạn đã cầm chắc trong tay bản kế hoạch PRD chi tiết, ngôi nhà của bạn đã có một bộ móng vững chãi. Bạn không còn phải lo lắng việc AI làm việc lan man hay bị lạc hướng nữa.
Nhưng để chú thợ xây AI có thể dựng lên giao diện mà không bị méo mó, chúng ta cần bước sang chặng tiếp theo: Chuyển hóa bản PRD thành bộ khung xương giao diện trắng đen Wireframe.
Khám phá toàn bộ chuỗi bài viết tại đây: Chuyên mục Vibe Coding A-Z
