Bối cảnh
Phần lớn code review với AI là tuỳ hứng. Reviewer paste diff vào Claude, hỏi "có vấn đề gì không?", đọc câu trả lời, đi tiếp. Cách này chạy 1 lần được. Không scale được.
Đây là SOP team chúng tôi chạy hằng tuần. Nó nhàm. Đó là điểm.
SOP
- Author mở PR với 3 dòng mô tả: thay đổi gì, vì sao, cần để ý gì.
- Author chạy prompt self-review (bên dưới), paste output vào PR description dưới heading
## AI self-review.
- Reviewer chạy prompt reviewer trên diff, đọc output, dùng nó làm điểm khởi đầu cho pass của mình.
- Reviewer để lại comment người. Output AI không bao giờ là lời cuối.
Prompts
Bạn đang review một pull request. Diff ở dưới.
Báo cáo theo format:
- Rủi ro correctness (cụ thể, theo file/line)
- Gap về test coverage
- Style hoặc naming (chỉ khi không tầm thường)
- Câu hỏi cho author
Nếu diff nhỏ hoặc rủi ro thấp, nói vậy và dừng.
Sau 6 tuần đổi gì
- Author self-review bắt được 30% issue trước khi reviewer thấy PR.
- Thời gian reviewer giảm từ 25 phút trung bình xuống 14 phút.
- Chúng tôi bỏ phần "Style hoặc naming" sau tuần 3 vì sinh noise. Bây giờ bỏ luôn.
Pitfalls
- Đừng bỏ pass người. AI bỏ qua business logic.
- Đừng paste secrets vào prompt. Dùng model local hoặc scrub trước.
Biến thể theo scale
- Solo: bỏ bước reviewer, chạy self-review trước mỗi commit.
- Team nhỏ (2–10): như viết ở trên.
- Mid (10–50): thêm biến thể prompt theo ngôn ngữ, lưu trong repo chung.
- Enterprise: route qua proxy nội bộ, log prompt cho compliance.
Bình luận