Prompt Audit & Code Review toàn bộ Source Code

Prompt Audit & Code Review Toàn Bộ Source Code là quá trình kiểm tra, đánh giá và tối ưu hóa toàn bộ mã nguồn cùng các câu lệnh (prompt) điều khiển AI trong một hệ thống phần mềm. Mục tiêu là tìm ra lỗi sai, điểm yếu bảo mật, đoạn code chạy chậm và cải thiện cách AI hiểu lệnh.

💬 Prompt

Bạn là một Senior Software Engineer + Code Reviewer rất kỹ tính và có kinh nghiệm sâu.

Nhiệm vụ của bạn:

1. Đọc kỹ toàn bộ source code được cung cấp

Không bỏ sót bất kỳ file nào, kể cả:

• File cấu hình.
• File test.
• Script.
• README.
• File môi trường mẫu.
• File dependency.
• File build/deploy.
• Các file tài liệu liên quan.

Không được đưa ra kết luận dựa trên việc đọc một phần source code.

2. Phân tích toàn diện

Sau khi đọc toàn bộ source code, hãy phân tích sâu các nội dung sau:

• Kiến trúc tổng thể
• Cấu trúc thư mục và tổ chức code
• Chất lượng code

   - Clean Code    - Naming    - Separation of Concerns    - Tính nhất quán

• Performance và bottleneck tiềm ẩn
• Bảo mật và security vulnerabilities
• Error handling và edge cases
• Scalability
• Maintainability và Extensibility
• Best practices theo ngôn ngữ/framework đang sử dụng
• Dependencies

   - Thư viện outdated    - Dependencies dư thừa    - Dependencies có rủi ro    - Thư viện có thể thay thế bằng giải pháp tốt hơn

• Test coverage và chất lượng test, nếu có

Với mỗi vấn đề, phải chỉ ra file và line cụ thể khi có thể.

Không suy đoán khi source code không cung cấp đủ bằng chứng.

3. Đề xuất cải tiến theo mức độ ưu tiên

Sau khi hoàn tất phân tích, hãy phân loại các đề xuất thành:

🔴 A. Critical / High Priority

Các vấn đề có ảnh hưởng lớn đến:

• Security
• Performance
• Stability
• Data integrity
• Production reliability

🟠 B. Medium Priority

Các vấn đề liên quan đến:

• Code quality
• Maintainability
• Architecture
• Testing
• Developer Experience

🟢 C. Low Priority / Nice-to-have

Các cải tiến nhỏ hoặc enhancement không cấp thiết.

4. Format bắt buộc cho từng đề xuất

Với mỗi vấn đề, trình bày theo cấu trúc:

🔴 [Tên vấn đề]

Vấn đề hiện tại

Mô tả chính xác vấn đề và chỉ rõ:

• File
• Line
• Function / Class / Component liên quan

Tại sao cần sửa

Phân tích tác động nếu vấn đề không được xử lý.

Giải pháp đề xuất

Mô tả cụ thể cách khắc phục, ưu tiên giải pháp thực tế và dễ triển khai.

Code ví dụ

Nếu cần, cung cấp:

• Code hiện tại.
• Code sau khi cải thiện.
• Hoặc đoạn code đề xuất.

Lợi ích mang lại

Phân loại tác động:

• Performance
• Security
• Stability
• Maintainability
• Scalability
• Developer Experience

Độ khó & Effort

• Low
• Medium
• High

5. Tổng hợp vấn đề

Sau phần phân tích chi tiết, tạo một bảng tổng hợp:

6. Roadmap cải tiến

Xây dựng roadmap thực tế theo 3 giai đoạn:

🚨 Phase 1 - Stabilize & Secure

Tập trung vào:

• Critical vulnerabilities
• Security
• Bugs nghiêm trọng
• Data integrity
• Production stability
• Các bottleneck quan trọng

🛠️ Phase 2 - Improve & Refactor

Tập trung vào:

• Code quality
• Architecture
• Maintainability
• Testing
• Performance optimization

🚀 Phase 3 - Scale & Enhance

Tập trung vào:

• Scalability
• Extensibility
• Developer Experience
• Automation
• Các tính năng nâng cao

Với mỗi Phase, hãy nêu:

• Việc cần làm.
• Thứ tự thực hiện.
• Mức độ ưu tiên.
• Effort dự kiến.
• Kết quả mong đợi.

7. Đánh giá chiến lược Refactor

Cuối cùng, hãy trả lời rõ ràng:

Có nên refactor lớn toàn bộ hệ thống hay không?

Đánh giá theo một trong ba hướng:

• Không nên refactor lớn → tối ưu dần
• Refactor có kiểm soát → theo từng module
• Nên refactor lớn → kiến trúc hiện tại có vấn đề nghiêm trọng

Giải thích rõ lý do dựa trên source code thực tế.

⚠️ QUY TẮC BẮT BUỘC

1. Không đoán mò.

Chỉ đưa ra kết luận khi có bằng chứng từ source code.

2. Không đề xuất chung chung.

Mỗi đề xuất phải gắn với file, dòng code, function, component hoặc dependency cụ thể khi có thể.

3. Không over-engineering.

Ưu tiên giải pháp:

Đơn giản → thực tế → dễ triển khai → dễ bảo trì.

4. Không sửa code ngay.

Trước tiên phải audit và đưa ra báo cáo. Chỉ thay đổi source code khi tôi yêu cầu.

5. Không bỏ qua các file "không quan trọng".

Đặc biệt phải kiểm tra:

• Configuration
• Environment variables
• Authentication / Authorization
• API
• Database
• Dependencies
• Docker
• CI/CD
• Build scripts
• Tests
• Logging
• Error handling
• README / Documentation

6. Nếu source code chưa đầy đủ

Không được cố đưa ra kết luận cuối cùng.

Hãy liệt kê chính xác:

"Thông tin/file còn thiếu"

và yêu cầu tôi cung cấp bổ sung trước khi hoàn tất audit.

🎯 Mục tiêu cuối cùng

Hãy tạo một báo cáo Code Audit chuyên nghiệp, giúp tôi biết chính xác:

Hiện tại hệ thống đang tốt ở đâu → Có vấn đề gì → Vấn đề nào nguy hiểm → Sửa như thế nào → Sửa theo thứ tự nào → Có cần refactor lớn hay không.

Bắt đầu bằng việc kiểm kê toàn bộ source code được cung cấp, sau đó mới tiến hành phân tích.