Tóm tắt nhanh:
ak-code-reviewlấy đúng phần cần xem, đối chiếu với plan hoặc spec rồi soát chất lượng, và trả về danh sách phát hiện có file, dòng, hậu quả, bằng chứng. Xong thì bạn chuyển sangak-ship, hoặcak-fixkhi kiểm cả codebase. Chỉ review thì nó không sửa code, không đăng lên PR, không merge.
Công khai: mình là maintainer của AgentKit và có quan hệ affiliate: link AgentKit trong bài là link affiliate, mua qua link này bạn được giảm 30%.
Tóm tắt
Dùng khi bạn vừa viết xong code và muốn biết nó có lỗi không, có làm hỏng chỗ khác không, có đúng yêu cầu không: trước khi commit, trước khi merge một PR, sau một commit rủi ro cao, trước bản phát hành lớn, hoặc khi cần kiểm góp ý review của người khác. Không cần chạy cả quy trình cho thay đổi nhỏ như sửa lỗi chính tả, và đừng mong nó tự sửa nếu bạn chưa cho phép.
flowchart LR
A["Code đã viết, test đã chạy"] --> B["ak-code-review"]
B --> C["Phát hiện kèm file, dòng, bằng chứng"]
C --> D["ak-ship"]
C --> E["Bạn cho phép sửa, rồi review lại"]
C --> F["Dừng, chỉ nhận báo cáo"]Nó xoay quanh 4 điều:
| Điều | Câu hỏi | Ví dụ |
|---|---|---|
| Đầu vào | Lần này review cái gì? | #<số PR> hoặc link PR, một mã commit từ 7 ký tự hex, --pending cho thay đổi chưa commit, codebase để quét cả repo, codebase parallel để nhiều reviewer cùng soát. Không ghi gì thì nó xem các thay đổi vừa làm trong phiên, không có thì hỏi bạn. |
| Đúng yêu cầu trước, tốt sau | Code có làm đúng điều plan hoặc spec yêu cầu không? | Plan ghi 5 yêu cầu, code mới có 4: yêu cầu thiếu bị đánh MISSING và phải bổ sung trước khi soát chất lượng. Phần code làm thêm mà spec không nhắc bị đánh EXTRA và được đề xuất bỏ, trừ khi có lý do giữ. |
| Phát hiện có bằng chứng | Lỗi nằm ở đâu, hỏng gì, dựa vào đâu mà nói vậy? | [src/api/search.ts:18] từ khoá tìm kiếm được nối vào câu SQL, ai cũng đọc được bảng khác. Kèm cách sửa. Điểm số không bao giờ thay cho lệnh kiểm tra hay phát hiện cụ thể. |
| Chỉ review là chỉ review | Nó có tự sửa code, tự comment lên PR, tự merge không? | Không. Bạn phải nói rõ là cho sửa. Khi đó nó chỉ sửa các phát hiện đã xác nhận, trong phạm vi, rồi review lại bản đã sửa. |
Phạm vi bạn yêu cầu được coi là ràng buộc, không phải lỗi để cắt: chỉ khi có --yagni nó mới đề xuất bỏ bớt. Nó cũng không khẳng định code đúng ở những chỗ nó chưa xem.
Prompt mẫu trước khi commit:
/ak-code-review --pending
Mục đích: sửa cách tính tổng tiền khi áp mã giảm giá cho <tên app>.
Ràng buộc: không đổi định dạng giá trả về cho API cũ.| Cờ | Để làm gì | Từ ak |
|---|---|---|
--pending | Review thay đổi chưa commit | 1.0.0 |
--ultra | 5 reviewer độc lập, giữ mọi lỗi kiểm được | 2.13.0 |
--advice | Model mạnh hơn góp ý ở mốc quan trọng | 2.13.0 |
--yagni | Cho phép đề xuất cắt phạm vi | 2.8.0 |
Phần dưới đây là bản chi tiết: luồng chạy, 5 tình huống kèm prompt, giải thích từng cờ (dùng khi, không cần khi, nhận lại gì, đi kèm cờ nào), lịch sử thay đổi theo bản ak và các lỗi hay vấp. Bản chi tiết và trang trực quan dành cho subscriber. Agent của bạn cũng tìm được trong đó qua MCP của portal.
Mở khi tài khoản có quyền subscriber
Bài này dành cho subscriber
Khi tài khoản có quyền, toàn bộ bài, bản visual tương tác và lệnh gọi từ agent đều mở.
- Đăng nhập hoặc tạo tài khoản modernEngineerQuyền đọc gắn với email tài khoản.
- Chọn gói trên trang Bảng giáGói 1, 3 hoặc 12 tháng, trả bằng chuyển khoản VietQR. Quyền đọc mở khoảng một phút sau khi tiền về.
- Hoặc nhập mã Facebook subscriberNgười ủng hộ trang qua Facebook nhận mã kích hoạt qua tin nhắn mỗi tháng.
Đã là subscriber? Đăng nhập để đọc.
Dùng bài này trong agent của bạn
Lấy API keyChép đoạn dưới, dán vào Claude Code, Codex hay agent bạn đang dùng. Agent đọc bài rồi đối chiếu với repo đang mở.
Đọc bài "ak-code-review: tìm lỗi và hồi quy trong code, kèm bằng chứng" trên modernEngineer rồi áp dụng vào repo này.
1. Gọi tool content_get của MCP server modernengineer với locale "vi", slug "ak-code-review". Nếu chưa nối MCP server modernengineer, dừng lại và hướng dẫn tôi nối theo https://modernengineer.dev/vi/mcp.
2. Tóm tắt các bước chính của bài, chỉ ra bước nào áp dụng được cho repo này.
3. Đề xuất thay đổi cụ thể và hỏi tôi trước khi sửa file.Nối MCP cho Claude Code (một lần)
claude mcp add --transport http modernengineer \
https://api.modernengineer.dev/mcp \
--header "Authorization: Bearer <API key>"Đọc trọn bài qua MCP cần API key của tài khoản subscriber hoặc đã mua guide này. Không có quyền, agent sẽ chỉ đọc được phần mở đầu.
- Phiên bản
- v1.0.0
- Cập nhật
- 22/10/2026
- Giấy phép
- Bảo lưu mọi quyền
- Slug
- ak-code-review
