- Đưa đủ bối cảnh: mục tiêu PR, tiêu chí chấp nhận, diff và test, không chỉ một tệp sau cùng.
- Lỗi phải tái hiện được: mỗi phát hiện có input, kết quả thực tế, kết quả mong đợi và test.
- Ví dụ xuyên suốt:
items[0]trên danh sách rỗng némIndexError; review tốt chỉ ra input làm danh sách rỗng.
Bắt đầu từ một ví dụ cụ thể
Ví dụ xuyên suốt bài là một diff thêm dòng first = items[0] ngay sau bước lọc danh sách. Khi bộ lọc không giữ lại phần tử nào, dòng đó ném IndexError. Một nhận xét có giá trị phải chỉ ra input gây lỗi, dòng lỗi và kết quả mong đợi, chẳng hạn trả về danh sách rỗng, thay vì chỉ cảnh báo chung chung rằng có thể lỗi null. Các prompt bên dưới đều buộc AI đưa đủ những thông tin đó cho từng phát hiện.
Đưa mục tiêu và phạm vi
Reviewer cần biết thay đổi định làm gì và không làm gì. Cung cấp issue, tiêu chí chấp nhận, diff và test, không chỉ một tệp sau cùng. Nếu thiếu bối cảnh, AI dễ báo code cũ hoặc đề xuất thiết kế ngoài phạm vi.
Tách lỗi khỏi sở thích
Một comment tốt nêu điều kiện, hành vi thực tế, hậu quả và cách tái hiện. Ý kiến đặt tên hoặc style nên theo quy ước tự động. Hãy yêu cầu xếp mức nghiêm trọng và bỏ nhận xét không chứng minh được. Số comment ít nhưng đúng có giá trị hơn danh sách dài.
Review theo lớp
Đi từ đúng yêu cầu, ca biên, lỗi, bảo mật, hiệu năng đến khả năng bảo trì. Không bắt đầu bằng format. Với mỗi lớp, dùng checklist phù hợp ngôn ngữ và miền. Code xử lý tiền, quyền hoặc dữ liệu cá nhân cần người có chuyên môn dù AI đã xem.
Yêu cầu đường tái hiện
Nếu AI nói null, race hoặc injection, nó phải chỉ luồng dữ liệu và input. Với hiệu năng, cần độ phức tạp hoặc phép đo. Với bảo mật, cần trust boundary và sink. Điều này giảm cảnh báo tưởng tượng và giúp tác giả kiểm nhanh.
Không để AI tự phê duyệt
Tác giả và AI cùng có thể bỏ sót một giả định. Chạy test, static analysis và review người; cách đọc từng thay đổi do AI làm có trong bài kiểm chứng việc AI làm. AI hỗ trợ đọc diện rộng, nhưng người chịu trách nhiệm cân nhắc kiến trúc, nghiệp vụ và rủi ro. Không merge chỉ vì bot nói không thấy lỗi.
Biến comment thành hành động
Comment nên trỏ dòng hẹp, mô tả tác động và gợi ý hướng sửa khi cần. Phân biệt bắt buộc, đề xuất và câu hỏi. Sau bản vá, kiểm lỗi biến mất mà không tạo lỗi mới; không đóng comment chỉ vì code thay đổi.
Bốn prompt mẫu chép dùng ngay
Prompt 1: kiểm đúng tiêu chí
Đây là mục tiêu PR, tiêu chí chấp nhận và diff. Chỉ review hành vi so với tiêu chí. Với mỗi lỗi, ghi tệp/dòng, input hoặc trạng thái kích hoạt, kết quả thực tế, kết quả mong đợi và test tái hiện. Không nhận xét style, không review code ngoài diff, không suy đoán tệp chưa được cung cấp. [dán issue, acceptance criteria, diff].
Prompt 2: review ca biên và xử lý lỗi
Review diff sau về ca biên, lỗi và tài nguyên. Kiểm input rỗng, cực trị, trùng, timeout, retry, đóng file/kết nối và thông báo lỗi. Chỉ báo vấn đề có luồng thực thi cụ thể; nếu cần tệp khác để xác nhận, hãy hỏi. Xếp P0–P3 theo hậu quả và xác suất. [dán diff và interface liên quan].
Prompt 3: review bảo mật có phạm vi
Lập sơ đồ dữ liệu không tin cậy đi từ nguồn đến nơi dùng trong diff này. Kiểm xác thực, phân quyền, injection, lộ bí mật, log nhạy cảm và phụ thuộc theo checklist [chuẩn dự án]. Với mỗi phát hiện, nêu trust boundary, sink, cách tái hiện an toàn và biện pháp. Không đưa payload phá hoại; đánh dấu điều chưa đủ bằng chứng. [dán diff].
Prompt 4: phản biện bộ test của PR
Từ mục tiêu và diff, hãy ánh xạ mỗi nhánh hành vi mới sang test hiện có. Liệt kê nhánh chưa được bảo vệ, test assertion yếu và test có thể xanh dù code sai. Đề xuất tối đa 5 test ưu tiên với input-output cụ thể. Không viết lại toàn bộ test và không đòi coverage 100%. [dán mục tiêu, diff, test].
Khi kết quả chưa đúng thì sửa prompt thế nào
Nếu AI báo quá nhiều style, cấm style và yêu cầu chỉ lỗi hành vi. Nếu cảnh báo mơ hồ, bắt input và đường thực thi. Nếu review ngoài diff, nêu base/head và phạm vi tệp. Nếu mọi lỗi đều “critical”, cung cấp định nghĩa P0–P3. Nếu nó đề xuất viết lại, yêu cầu bản vá nhỏ nhất hoặc chỉ comment. Với kết luận thiếu tệp, yêu cầu chuyển thành câu hỏi thay vì khẳng định.
Bài thực hành
Lấy một diff nhỏ có lỗi ca rỗng. Viết tiêu chí chấp nhận rồi chạy Prompt 1 mà không nói vị trí lỗi. Kiểm nhận xét có input tái hiện không. Sửa lỗi, thêm test và chạy Prompt 4. Loại mọi comment chỉ là sở thích chưa có quy ước.
Ca mẫu: biến cảnh báo mơ hồ thành lỗi tái hiện được
Diff thêm dòng first = items[0] sau khi lọc danh sách. Một review yếu nói “có thể lỗi null”; nhận xét tốt chỉ ra input nào làm danh sách rỗng, dòng nào ném IndexError, tác động tới request và test mong đợi. Hãy cung cấp tiêu chí chấp nhận cùng diff để AI biết danh sách rỗng cần trả mảng hay mã lỗi. Bắt nó viết đường thực thi, không chấp nhận câu “nên cân nhắc”. Nếu nhánh chỉ xảy ra khi quyền người dùng cụ thể, trạng thái đó phải có trong cách tái hiện. Xếp mức ưu tiên theo hậu quả và xác suất của dự án, không theo từ khóa nghe nguy hiểm. Sau lỗi đúng đắn mới xem tài nguyên, bảo mật, hiệu năng và khả năng bảo trì. Style đã có formatter giải quyết thì không chiếm chỗ của comment hành vi. Khi tác giả gửi bản vá, chạy test tái hiện và đọc lại vùng diff mới; việc dòng cũ biến mất chưa chứng minh nguyên nhân đã được sửa. Review AI là lượt đọc bổ sung, còn quyết định merge vẫn cần người hiểu nghiệp vụ và chịu trách nhiệm vận hành.
Prompt thứ năm: tự kiểm bằng tình huống của bạn
Review diff này như một phiên điều tra, không như công cụ chấm style. Nhắc lại tiêu chí chấp nhận và liệt kê nhánh mới. Mỗi phát hiện phải có đường đi từ input hoặc trạng thái đầu tới dòng lỗi, hậu quả quan sát được và test tái hiện tối thiểu. Nếu thiếu tệp để chứng minh, chuyển nhận xét thành câu hỏi và nêu đúng tệp cần xem. Xếp P0–P3 theo định nghĩa tôi cung cấp, bỏ lời khen và refactor ngoài phạm vi. Sau cùng kiểm từng comment có trỏ đúng dòng thay đổi hay không.
Câu hỏi thường gặp
AI review code có thay được người review không?
Không. AI giúp đọc diện rộng và tìm ca biên, nhưng quyết định merge cần người hiểu nghiệp vụ và chịu trách nhiệm vận hành; đừng merge chỉ vì bot nói không thấy lỗi.
Làm sao để AI bớt nhận xét về style?
Ghi rõ trong prompt là không nhận xét style, để formatter và linter lo phần đó, và chỉ nhận phát hiện có input tái hiện, kết quả thực tế và kết quả mong đợi.
P0 đến P3 trong prompt nghĩa là gì?
Đó là thang ưu tiên do nhóm tự định nghĩa, thường P0 là nặng nhất. Hãy dán định nghĩa vào prompt; nếu không, AI dễ xếp mọi lỗi thành nghiêm trọng.
Học tiếp
- Prompt viết truy vấn SQL báo cáo: chốt grain, tránh JOIN nhân dòng
- Prompt viết thông báo commit rõ thay đổi và lý do
- Prompt refactor code an toàn mà không đổi hành vi
Khóa AI – Introduction to Machine Learning: nền tảng Máy học từ thuật toán cơ bản đến Neural Networks và LLM, học bằng Python. Học thử buổi 1 miễn phí.


