Alibaba công bố Open Code Review: Tác nhân AI mã nguồn mở giúp tự động hóa review code

Alibaba vừa chính thức công bố mã nguồn mở cho dự án Open Code Review, một công cụ đánh giá mã nguồn (code review) dựa trên AI hoạt động dưới dạng dòng lệnh (CLI). Trước đây, đây là trợ lý review code nội bộ chính thức của Alibaba Group, đã phục vụ hàng chục nghìn nhà phát triển và phát hiện hàng triệu lỗi mã trong vòng hai năm qua.

NPM Version GitHub Actions License

Vấn đề của các tác nhân AI tổng quát

Theo Alibaba, các tác nhân AI tổng quát (general-purpose agents) như Claude Code thường gặp phải ba vấn đề lớn khi thực hiện review code:

• Độ phủ sóng không đầy đủ: Với các thay đổi mã lớn, các tác nhân có xu hướng "cắt góc", chỉ chọn review một số file và bỏ sót các file khác.
• Sai lệch vị trí (Position drift): Các vấn đề được báo cáo thường không khớp với vị trí mã thực tế, số dòng hoặc tham chiếu file bị trôi.
• Chất lượng không ổn định: Các kỹ năng dựa trên ngôn ngữ tự nhiên khó gỡ lỗi và chất lượng review dao động lớn dù chỉ có thay đổi nhỏ trong prompt.

Nguyên nhân gốc rễ là do kiến trúc thuần túy dựa trên ngôn ngữ thiếu các ràng buộc cứng (hard constraints) đối với quy trình review.

Thiết kế cốt lõi: Kỹ thuật xác định × Tác nhân AI

Open Code Review áp dụng triết lý kết hợp giữa Kỹ thuật xác định (Deterministic Engineering) và Tác nhân AI (Agent), tận dụng thế mạnh của từng bên.

Kỹ thuật xác định — Ràng buộc cứng

Đối với các bước review không được phép sai, logic kỹ thuật (không phải mô hình ngôn ngữ) sẽ đảm bảo tính chính xác:

• Chọn file chính xác: Xác định chính xác những file nào cần review và file nào nên được lọc bỏ.
• Gom nhóm file thông minh: Gom các file liên quan thành một đơn vị review duy nhất (ví dụ: các file ngôn ngữ khác nhau nhưng cùng nội dung). Mỗi nhóm chạy như một tác nhân con với ngữ cảnh cô lập.
• Khớp quy tắc chi tiết: Khớp các quy tắc review với đặc điểm của từng file để giữ sự tập trung của mô hình, loại bỏ nhiễu thông tin.
• Định vị và phản hồi bên ngoài: Các module độc lập để định vị nhận xét và phản hồi, cải thiện độ chính xác về vị trí và nội dung.

Tác nhân AI — Quyết định động

Tác nhân AI tập trung vào các điểm quan trọng nhất: ra quyết định động và truy xuất ngữ cảnh động:

• Prompt được tinh chỉnh theo kịch bản: Các mẫu prompt được tối ưu hóa sâu cho review code, giúp tăng hiệu quả và giảm tiêu thụ token.
• Bộ công cụ chuyên dụng: Được chắt lọc từ dữ liệu sản xuất quy mô lớn, tạo ra bộ công cụ ổn định và dễ dự đoán hơn cho code review so với bộ công cụ chung.

Cách sử dụng

Cài đặt

Bạn có thể cài đặt công cụ này qua NPM (khuyên dùng):

npm install -g @alibaba-group/open-code-review

Sau khi cài đặt, lệnh ocr sẽ có sẵn toàn cục. Bạn cũng có thể tải binary trực tiếp từ GitHub Releases cho macOS, Linux hoặc Windows.

Cấu hình và Review

Trước hết, bạn cần cấu hình một LLM (Large Language Model):

ocr config set llm.url https://api.anthropic.com/v1/messages
ocr config set llm.auth_token your-api-key-here
ocr config set llm.model claude-opus-4-6
ocr config set llm.use_anthropic true

Sau đó, bạn có thể bắt đầu review code trong thư mục dự án của mình:

# Review tất cả các thay đổi đã staged, unstaged và untracked
ocr review

# So sánh giữa hai nhánh
ocr review --from main --to feature-branch

# Review một commit cụ thể
ocr review --commit abc123

Tích hợp CI/CD và AI Agents

Open Code Review có thể tích hợp liền mạch vào các pipeline CI/CD để tự động hóa review trên Merge Requests hoặc Pull Requests. Nó cũng hỗ trợ tích hợp với các tác nhân coding AI như một lệnh slash (slash command).

Đặc biệt, với Claude Code, người dùng có thể cài đặt plugin để sử dụng lệnh /open-code-review:review, giúp chạy OCR và tự động lọc cũng như sửa lỗi.

Tính năng khác

Công cụ này cũng cung cấp các tính năng nâng cao như:

• Quản lý quy tắc (Review Rules): Hệ thống quy tắc đa tầng, cho phép tùy chỉnh quy tắc review theo cấp độ dự án hoặc toàn cục.
• Viewer: Giao diện WebUI để xem lịch sử các phiên review trên localhost.
• Telemetry: Hỗ trợ OpenTelemetry để quan sát hiệu suất (spans, metrics).

Open Code Review hiện đang được phát hành dưới giấy phép Apache-2.0 và sẵn sàng cho cộng đồng nhà phát triển trải nghiệm.