PRD 1 trang: viết spec nhanh cho dev

Spec chung chung thường do ô nhập bị bỏ trống hoặc điền sơ sài. Khi thiếu System, Goal, Scope, Constraints hay Evidence, AI không có bối cảnh để viết acceptance criteria và edge cases cụ thể. Bạn điền đủ thông tin thật của dự án trước khi chạy, phần nào chưa có thì ghi “CẦN BỔ SUNG” để AI không đoán.

Không nên. Nguyên tắc khi chạy prompt là mô tả rõ bối cảnh và không đoán. Chỗ nào thiếu dữ liệu, bạn ghi “CẦN BỔ SUNG” để dev và người duyệt thấy ngay phần còn trống. Spec thiếu evidence bị tính là không đạt theo bảng Pass/Fail, nên bạn bổ sung logs, GSC, GA4, Lighthouse hoặc screenshots trước khi giao.

Thường thiếu QA, rollback hoặc monitoring. Bảng Pass/Fail chỉ tính đạt khi spec rõ, có AC/test, có rollback và có monitoring cùng lúc. Một bản spec có AC nhưng thiếu checklist QA, thiếu kế hoạch rollback hoặc không có monitoring vẫn bị tính Fail. Bạn sửa ô nhập liên quan rồi chạy lại prompt.

Không nên sửa câu mở đầu của mẫu. Câu đó giao cho AI vai Web/Dev/Automation Engineer + SEO-aware, nhờ vậy lần chạy nào cũng ra cùng một cấu trúc. Khi cần đổi nội dung, bạn chỉ thay 5 ô System, Goal, Scope, Constraints và Evidence, phần khung còn lại để nguyên.

Prompt cần 5 ô nhập: System, Goal, Scope, Constraints và Evidence. System là nền tảng như WordPress, Next.js, Shopify hoặc Custom. Goal là mục tiêu như perf, SEO, tracking, automation, reliability. Scope là phạm vi từ 1 page, 10 URLs, sitewide tới API. Constraints là giới hạn về dev time, plugin, hosting, privacy. Evidence là logs, GSC, GA4, Lighthouse, screenshots.

Đầu ra chuẩn đi theo thứ tự: spec rõ có AC và edge cases, rồi checklist QA, rồi plan deploy và rollback, cuối cùng là log và monitoring. Trong ví dụ thực chiến, kết quả kỳ vọng là PRD/Spec 1 trang kèm acceptance criteria, checklist QA kèm test cases, deploy plan kèm rollback plan và monitoring/alert rules.

Ô Constraints ghi các giới hạn ảnh hưởng tới cách triển khai như dev time, plugin, hosting và privacy. Trong ví dụ thực chiến với WordPress, ràng buộc được ghi là chỉ sửa 10 task/tuần. Ghi ràng buộc cụ thể giúp spec bám sát điều kiện thật của dự án.

Ví dụ thực chiến điền SYSTEM là WordPress, GOAL là tăng tốc + giảm lỗi, SCOPE là sitewide và CONSTRAINTS là chỉ sửa 10 task/tuần. Bạn đối chiếu kết quả ví dụ với bảng Pass/Fail để biết đầu ra đạt trông ra sao, rồi mới thay bằng dữ liệu dự án của bạn.

PRD 1 trang dùng được cho cả WordPress, Next.js, Shopify và hệ thống Custom, vì ô System trong prompt nhận đúng các lựa chọn đó. Phạm vi cũng linh hoạt từ 1 page, 10 URLs, sitewide tới API. Dù chọn nền tảng nào, PRD 1 trang vẫn nhắm tới bản spec gọn để dev làm đúng ngay.

Có, khi bạn muốn dev làm đúng ngay. PRD 1 trang ghi rõ acceptance criteria, edge cases, checklist QA, rollback và monitoring, nên dev biết thế nào là xong và cách lùi lại khi có lỗi. Chỗ nào thiếu dữ liệu thì PRD ghi “CẦN BỔ SUNG” để không ai phải đoán.

Spec PRD đạt khi rõ ràng, có AC/test, có rollback và có monitoring. Spec PRD không đạt khi mô tả chung chung, thiếu evidence hoặc thiếu QA/rollback. Khi một bản spec do AI viết trượt tiêu chí nào, bạn sửa ô nhập tương ứng trong prompt PRD 1 trang rồi chạy lại cho tới khi đạt.

Viết spec cho dev bằng ChatGPT nên bắt đầu từ việc gom thông tin thật của dự án vào 5 ô: System, Goal, Scope, Constraints và Evidence. Sau đó bạn dán mẫu prompt PRD 1 trang vào ChatGPT, Gemini hoặc Claude, thay các ô bằng dữ liệu đã gom, chạy rồi chấm kết quả theo bảng Pass/Fail.