Đồng bộ cách trả lỗi trong module hoặc repo để lớp gọi phía trên xử lý nhất quán, dễ kiểm tra và dễ bảo trì hơn.
Điền thông tin của bạn
Prompt
Bạn là kỹ sư phần mềm cao cấp. Hãy đọc quy ước lỗi hiện có trong {{pham_vi_ma_nguon}} và các điểm trả lỗi rời rạc được liệt kê trong {{danh_sach_loi}}. Nhiệm vụ của bạn là chuẩn hóa toàn bộ cách trả về lỗi theo một quy ước thống nhất, sao cho cùng loại lỗi luôn có cấu trúc, mã, thông điệp và mức độ rõ ràng giống nhau trong toàn bộ phạm vi được yêu cầu. Ưu tiên giữ tương thích với hành vi cũ ở mức có thể, chỉ thay đổi khi cần để đồng nhất và giảm nhầm lẫn cho lớp gọi phía trên. Hãy đề xuất và áp dụng một mẫu trả lỗi nhất quán cho các trường hợp: lỗi xác thực đầu vào, lỗi nghiệp vụ, lỗi không tìm thấy dữ liệu, lỗi hệ thống và lỗi không mong đợi. Đồng thời tạo một ghi chú tài liệu ngắn giải thích quy tắc mới, cách dùng, và điều kiện nên dùng từng loại lỗi. Nếu có chỗ nào không đủ dữ liệu để kết luận, hãy nêu rõ giả định đang dùng thay vì tự suy diễn quá mức. Trả về kết quả theo cấu trúc: 1) tóm tắt thay đổi, 2) danh sách file/hàm đã chỉnh, 3) quy tắc lỗi mới, 4) lưu ý tương thích ngược, 5) đoạn tài liệu ngắn cho dev.
Phạm vi mã nguồn: src/api, src/services; Danh sách lỗi rời rạc: trả string ở chỗ này, throw Error ở chỗ kia, có nơi return null khi không tìm thấy
Output mẫu
Đã thống nhất các nhánh trả về theo 4 nhóm lỗi: VALIDATION_ERROR, BUSINESS_ERROR, NOT_FOUND, INTERNAL_ERROR. Các hàm trong src/api và src/services cùng dùng một cấu trúc {code, message, details}. Thêm ghi chú ngắn nêu khi nào dùng return lỗi và khi nào throw lỗi nội bộ.
Cách sử dụng
Điền đúng phạm vi mã và các lỗi đang có, rồi dán prompt vào Codex hoặc công cụ tương đương. Sau khi nhận kết quả, kiểm tra lại tính nhất quán của mã lỗi, thông điệp và khả năng tương thích với các lớp gọi hiện tại.
Giải thích cấu trúc
Role: kỹ sư phần mềm phụ trách chuẩn hóa lỗi. Context: một module hoặc repo có nhiều kiểu trả lỗi khác nhau. Task: rà soát, gom nhóm và áp dụng quy ước nhất quán kèm tài liệu ngắn. Constraints: ưu tiên tương thích ngược, không tự bịa quy ước mới nếu chưa có dữ liệu, phải nêu giả định khi thiếu thông tin. Output: tóm tắt thay đổi, danh sách chỉnh sửa, quy tắc lỗi, lưu ý tương thích và tài liệu ngắn.
Mẹo sử dụng
Gửi kèm ví dụ lỗi hiện tại để Codex nhận ra pattern cần chuẩn hóa.
Nếu repo có chuẩn mã lỗi sẵn, nêu rõ để tránh Codex tạo hệ mã mới.
Yêu cầu giữ nguyên payload cũ nếu lớp gọi phía trên đang phụ thuộc vào nó.
Kiểm tra lại các test liên quan đến xử lý lỗi sau khi áp dụng thay đổi.
Nguồn và giấy phép
ONTER biên tập · original
Đánh giá prompt
Chọn số sao theo trải nghiệm của bạn. Bạn có thể sửa đánh giá sau một phút.
