React Doctor — Công cụ chẩn đoán xác minh mã React do AI tạo ra bằng phân tích tĩnh

Ai đang thực sự xem xét liệu mã React do các tác nhân lập trình AI viết ra có đúng hay không? React Doctor là công cụ bắt đầu từ հենց câu hỏi đó. Chỉ với một dòng npx react-doctor@latest để quét dự án, kết quả chẩn đoán trên toàn bộ các khía cạnh như quản lý trạng thái, side effect, hiệu năng, bảo mật, khả năng truy cập và kiến trúc sẽ được in ra terminal kèm điểm số từ 0 đến 100. Công cụ được phát triển bởi Million.co và phát hành theo giấy phép MIT.

Tính năng chính

• Hỗ trợ tích hợp tác nhân AI một cách tường minh. Khi chạy react-doctor install, công cụ sẽ tự động đăng ký skill cho các tác nhân phổ biến như Claude Code, Cursor, Codex, OpenCode, đồng thời cài đặt các hook git post-checkout/post-merge. Đây là cấu trúc nơi một tác nhân gây ra vấn đề và một tác nhân khác sửa lại.
• Tích hợp hơn 100 quy tắc dựa trên oxlint. Công cụ trực tiếp hiện thực các quy tắc trong plugin oxlint riêng (oxlint-plugin-react-doctor), cho phép phân tích nhanh mà không cần runtime ESLint riêng biệt. Các preset quy tắc theo framework như Next.js, TanStack, React Native, Expo cũng được chuẩn bị sẵn.
• Tích hợp các quy tắc của React Compiler. Thông qua nhóm quy tắc react-hooks-js/*, công cụ phát hiện ngay khi vẫn còn mã manual memoization trong môi trường đã bật React Compiler.
• Hỗ trợ GitHub Actions gốc. Chỉ cần thêm action chính thức trên Marketplace, kết quả chẩn đoán sẽ được ghi lại ở mỗi PR dưới dạng inline annotation và sticky comment. Khi dùng chế độ --diff, công cụ chỉ quét các tệp đã thay đổi để giảm thời gian CI.
• Pipeline streaming dựa trên Effect v4. Bên trong, scan engine được cấu thành bằng dependency injection, tagged error và luồng điều khiển dựa trên generator của thư viện Effect, đồng thời chạy song song linting và phân tích dead code.
• Cũng hỗ trợ cách tiếp cận lập trình. Thông qua hàm diagnose() của gói @react-doctor/api, có thể nhận trực tiếp kết quả chẩn đoán đã được định kiểu trong mã Node.js để xử lý.
• Cung cấp tính năng chia sẻ điểm số. Có thể đăng kết quả quét lên react.doctor/share để chia sẻ với nhóm hoặc bên ngoài.

Điểm khác biệt

Khác với các plugin React dựa trên ESLint hiện có, nơi nhà phát triển phải tự chọn và cấu hình từng quy tắc, React Doctor được định vị là một “công cụ kiểm toán” có thể chạy chẩn đoán toàn bộ danh mục ngay sau khi cài đặt. Đặc biệt, việc đặt kịch bản sử dụng là xác minh chất lượng mã do AI viết lên vị trí trung tâm là một hướng đi khá nổi bật.

v0.2.4 đánh dấu quá trình migrate sang Effect v4, v0.2.7 bổ sung phân tích song song và phát hiện tác nhân, và nhịp phát hành ngắn vẫn tiếp tục tới phiên bản hiện tại là v0.2.8. Vì chưa đạt tới major version nên API vẫn có thể thay đổi, nhưng tốc độ phát triển và xu hướng mở rộng coverage vẫn khá ổn định. Trong bối cảnh việc tạo mã bằng AI đã trở nên thường nhật, đây là một công cụ đáng chú ý với mục tiêu đóng vai trò chốt kiểm tra cuối cùng cho chất lượng codebase.

[runedia]

Vì thấy chạy được cả bằng bunx nên tôi đã thử dùng cho dự án đang phát triển, và nó bắt được rất nhiều lỗi với cảnh báo.

Phần lớn là những nội dung không quá quan trọng, nhưng nhờ tìm ra được vài lỗi mà tôi đã bỏ sót nên có vẻ đây là một công cụ đáng để thử ít nhất một lần.