Mục tiêu

Prompt này được thiết kế để giúp bạn đánh giá chất lượng code Python một cách hệ thống và nhận các đề xuất refactor an toàn, có kiểm soát. Thay vì chỉ chỉ ra lỗi chung chung, AI sẽ tập trung vào khả năng đọc hiểu, tính nhất quán, cấu trúc hàm và lớp, xử lý ngoại lệ, hiệu năng, testability, độ bảo trì và các rủi ro có thể ảnh hưởng đến hành vi hiện tại của chương trình.

Khi nào nên dùng

• Khi bạn cần review nhanh một đoạn code Python trước khi merge.
• Khi muốn cải thiện code legacy nhưng ngại thay đổi lớn làm phát sinh bug.
• Khi cần chuẩn hóa phong cách viết code giữa các thành viên trong nhóm.
• Khi muốn xác định các điểm refactor ưu tiên cao, ưu tiên trung bình và ưu tiên thấp.
• Khi cần AI giải thích rõ vì sao một thay đổi là an toàn hoặc có rủi ro.

Hướng dẫn tùy biến

1. Bổ sung ngữ cảnh dự án

Hãy thêm mô tả ngắn về loại dự án như API, ETL, automation script, data pipeline hay ứng dụng CLI. Nếu có framework liên quan như Django, FastAPI, Flask, Pandas hoặc asyncio, nên nêu rõ để AI đánh giá chính xác hơn.

2. Xác định mục tiêu review

Bạn có thể yêu cầu AI tập trung vào một hay nhiều khía cạnh: readability, maintainability, performance, bug risk, security, typing, logging, exception handling hoặc test coverage.

3. Chọn mức độ refactor

• Refactor tối thiểu: chỉ sửa các vấn đề rõ ràng, ít rủi ro.
• Refactor vừa phải: cải thiện cấu trúc nhưng vẫn giữ nguyên thiết kế tổng thể.
• Refactor mạnh: đề xuất tái cấu trúc lớn hơn, kèm phân tích rủi ro và lộ trình áp dụng.

4. Yêu cầu định dạng đầu ra

Nếu muốn dễ áp dụng trong công việc, bạn có thể yêu cầu kết quả theo bảng ưu tiên, checklist hành động, danh sách issue, hoặc bản refactor từng bước trước khi đưa ra code sửa.

Lưu ý

• Nên cung cấp đủ đoạn code, hoặc ít nhất là hàm/lớp hoàn chỉnh để AI không đánh giá sai do thiếu ngữ cảnh.
• Nếu code liên quan tới logic nghiệp vụ quan trọng, hãy yêu cầu AI giữ nguyên hành vi đầu ra và nêu rõ các giả định.
• Với hệ thống production, nên yêu cầu AI đề xuất thêm test case hồi quy trước khi refactor.
• Không nên áp dụng toàn bộ đề xuất một cách tự động nếu code có phụ thuộc ngầm, side effect hoặc ràng buộc hiệu năng đặc thù.