Debug checklist: từ symptom → root cause

Kết quả ra chung chung khi các ô nhập bị bỏ trống hoặc điền sơ sài. Prompt cần đủ System, Goal, Scope, Constraints và Evidence bằng thông tin thật của dự án. Thiếu ô nào thì AI không có bối cảnh để khoanh vùng, nên chỉ đưa ra lời khuyên chung.

Vẫn chạy được, nhưng kết quả dễ rơi vào loại Fail vì thiếu evidence. Ô Evidence nhận logs, GSC, GA4, Lighthouse hoặc screenshots. Phần nào chưa có dữ liệu thì AI phải ghi “CẦN BỔ SUNG” để bạn biết cần thu thập thêm gì trước khi kết luận root cause.

Prompt đặt sẵn nguyên tắc: mô tả rõ bối cảnh, không đoán, thiếu dữ liệu thì ghi “CẦN BỔ SUNG”. Kèm đó, bạn điền ô Evidence bằng logs hoặc số liệu thật. Khi thiếu bằng chứng, chỗ trống được đánh dấu rõ để bạn bổ sung trước khi kết luận.

Không nên dùng ngay. Theo bảng Pass/Fail, kết quả thiếu QA hoặc rollback thuộc loại Fail. Bạn sửa ô nhập còn chưa rõ rồi chạy lại đến khi đầu ra có checklist QA, deploy plan và rollback plan.

Mỗi ô ghi một loại thông tin riêng của dự án. 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 tới sitewide hoặc API. Constraints là giới hạn như dev time, plugin, hosting, privacy. Evidence là bằng chứng như logs, GSC, GA4, Lighthouse, screenshots.

Đầu ra chuẩn đi theo thứ tự: spec rõ với 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, đầu ra kỳ vọng gồm PRD/Spec 1 trang kèm acceptance criteria, checklist QA kèm test cases, deploy plan, rollback plan và monitoring/alert rules.

Bảng Pass/Fail dựa vào hai nhóm tiêu chí. Nhóm Pass gồm spec rõ, có AC/test, có rollback và có monitoring. Nhóm Fail là khi mô tả chung chung, thiếu evidence hoặc thiếu QA/rollback. Bạn chấm theo hai tiêu chí này trước khi dùng, trượt tiêu chí nào thì sửa ô nhập đó rồi chạy lại.

Ô Constraints ghi những giới hạn thật khi sửa lỗi, như dev time, plugin, hosting hoặc privacy. Trong ví dụ thực chiến, Constraints là chỉ sửa 10 task/tuần. Giới hạn rõ giúp AI đưa ra kế hoạch vừa với nguồn lực thật.

Debug checklist từ symptom tới root cause là một prompt AI giúp debug có hệ thống. Người dùng điền 5 ô System, Goal, Scope, Constraints, Evidence, rồi nhận đầu ra gồm spec rõ với AC và edge cases, checklist QA, plan deploy và rollback, log và monitoring. Kết quả được chấm bằng bảng Pass/Fail.

Có, prompt debug checklist cần đủ 5 ô nhập System, Goal, Scope, Constraints và Evidence trước khi dán vào ChatGPT, Gemini hoặc Claude. Ô nào bỏ trống thì kết quả sẽ chung chung. Khi thiếu dữ liệu thật, prompt yêu cầu AI ghi “CẦN BỔ SUNG” để không đoán nguyên nhân lỗi.

Nên bắt đầu prompt debug checklist bằng ví dụ thực chiến có sẵn: SYSTEM là Dev, GOAL là tăng tốc và giảm lỗi, SCOPE là sitewide, CONSTRAINTS là chỉ sửa 10 task/tuần. Đối chiếu kết quả ví dụ với bảng Pass/Fail, sau đó mới thay bằng dữ liệu dự án của bạn.

Prompt debug checklist dùng được cho WordPress, Next.js, Shopify hoặc hệ thống Custom, ghi vào ô System. Phạm vi trải từ 1 page, 10 URLs, sitewide tới API, ghi vào ô Scope. Mục tiêu có thể là perf, SEO, tracking, automation hoặc reliability, ghi vào ô Goal trước khi chạy.