feat: add AI code review documentation, demonstration project, and update guidelines

This commit is contained in:
2026-06-26 17:05:00 +07:00
parent 7f99c55963
commit 852c9bc9c8
11 changed files with 296 additions and 103 deletions
+24
View File
@@ -0,0 +1,24 @@
# Runbook Demo — 5 phút
## Chuẩn bị trước (KHÔNG làm live)
- Mở sẵn: `PROMPTS.md`, `CLAUDE.md`, `PR-diff.md`, `orderService.js`.
- Chạy thử 1 lần trước buổi nói, **quay màn hình** làm backup (AI live đôi khi chậm/khác).
- Diff đã đủ nhỏ (~10 dòng) để khán giả đọc hết trong 10 giây.
## Kịch bản
| Thời gian | Làm gì | Thông điệp |
|-----------|--------|-----------|
| 0:000:30 | Chiếu PR-diff, đọc to "feature hủy đơn, ~10 dòng". Đừng nói có lỗi. | Bối cảnh |
| 0:302:00 | Chạy prompt **① BEFORE** | Góp ý linh tinh, **bỏ lọt** lỗi nguy hiểm |
| 2:003:30 | Chạy prompt **② AFTER** | Bắt đúng lỗi cancel-shipped + trích rule, bỏ nitpick |
| 3:304:30 | Chạy **③ persona** (maintainability) | Tóm `toMoney` trùng `formatCurrency` |
| 4:305:00 | Slide so sánh + chốt | "Cùng một model, khác ở cách đưa context" |
## Mẹo chống "chết" trên sân khấu
- Tuyệt đối không gõ tay — copy từ PROMPTS.md.
- Nếu "before" lỡ bắt được lỗi: nhấn mạnh nó vẫn báo kèm nhiều nitpick vô nghĩa, còn "after" thì gọn & trúng.
- Có thể chia màn hình chạy song song before/after cho tương phản tức thì.
## Đáp án 2 lỗi cài sẵn (cho người trình bày)
1. cancelOrder không check `status === 'shipped'` → vi phạm business rule.
2. `toMoney()` trùng `formatCurrency()` đã có.