Mẹo dùng AI để đọc hiểu codebase lạ nhanh hơn
Mới vào dự án với một codebase vài trăm nghìn dòng, không có tài liệu, người viết ban đầu đã nghỉ. Mình dùng AI theo quy trình dưới đây và sau khoảng 3 ngày đã tự tin sửa được tính năng. Chia sẻ để ai mới vào dự án lạ có thể tham khảo. BƯỚC 1: HỎI TỔNG QUAN Cho AI đọc cấu trúc thư mục, file cấu hình (package.json, requirements.txt, docker-compose...) và hỏi: dự án dùng công nghệ gì, có những module chính nào, dữ liệu đi qua đâu. Ghi lại câu trả lời vào một file ghi chú. BƯỚC 2: LẦN THEO MỘT TÍNH NĂNG CỤ THỂ Chọn một tính năng đơn giản mà bạn dùng được trên giao diện (ví dụ đăng nhập). Nhờ AI lần theo từ nút bấm ở giao diện → API → xử lý nghiệp vụ → database. Đọc lại từng file nó chỉ ra, đừng chỉ đọc câu trả lời. BƯỚC 3: VẼ SƠ ĐỒ Yêu cầu AI vẽ sơ đồ luồng dữ liệu cho tính năng đó (dạng mermaid). Nhìn sơ đồ dễ phát hiện chỗ mình hiểu sai hơn đọc chữ. BƯỚC 4: HỎI "TẠI SAO" Với những đoạn code lạ, hỏi AI tại sao lại viết như vậy, có cách nào khác không. Nhiều khi câu trả lời là "có thể do lịch sử", lúc đó hãy xem git blame và commit message. BƯỚC 5: SỬA MỘT BUG NHỎ Tự sửa một bug nhỏ hoặc thêm một tính năng nhỏ, có viết test. Đây là bước kiểm chứng bạn có thật sự hiểu hay không. BƯỚC 6: VIẾT LẠI TÀI LIỆU Sau khi hiểu, nhờ AI viết nháp README cho từng module rồi tự chỉnh lại. Vừa củng cố kiến thức, vừa giúp người đến sau. LƯU Ý - AI có thể "tự tin nói sai" về code nó chưa đọc. Luôn yêu cầu nó trích dẫn file và dòng code cụ thể. - Đừng dán code của công ty vào công cụ bên ngoài nếu chưa được phép. Mọi người có mẹo nào khác không?