𝗧𝗵𝗲 𝗩𝗮𝗹𝗶𝗱𝗮𝘁𝗶𝗼𝗻 𝗦𝘁𝗲𝗽: 𝗛𝗼𝘄 𝘁𝗼 𝗧𝗲𝘀𝘁 𝗮𝗻𝗱 𝗩𝗲𝗿𝗶𝗳𝘆 𝗔𝗜-𝗚𝗲𝗻𝗲𝗿𝗮𝘁𝗲𝗱 𝗖𝗼𝗱𝗲 𝗪𝗶𝘁𝗵𝗼𝘂𝘁 𝗕𝗲𝗶𝗻𝗴 𝗮 𝗗𝗲𝘃𝗲𝗹𝗼𝗽𝗲𝗿 (Bước Kiểm chứng: Cách Kiểm tra và Xác minh Mã nguồn do AI tạo ra mà không cần là một Lập trình viên)

Những người viết tài liệu kỹ thuật tự do thường sử dụng AI để soạn thảo các đoạn mã (code snippets). Việc phụ thuộc hoàn toàn vào kết quả thô sẽ dẫn đến các ví dụ bị lỗi và khiến người đọc cảm thấy thất vọng. Một bước kiểm chứng nhẹ nhàng sẽ giúp bạn phát hiện sớm các lỗi cú pháp. Điều này giúp tài liệu của bạn luôn đáng tin cậy mà không cần có nền tảng lập trình chuyên sâu.

Ý tưởng cốt lõi: Các rào chắn tự động (Automated Guardrails)

Hãy coi mã nguồn do AI tạo ra như một bản nháp. Nó phải vượt qua các bước kiểm tra sức khỏe cơ bản trước khi xuất hiện trong tài liệu của bạn. Bạn có thể sử dụng các công cụ tự động như linter, formatter hoặc các bài kiểm tra sandbox đơn giản để tạo ra một mạng lưới an toàn. Cách tiếp cận này giúp đánh dấu các lỗi hiển nhiên và bảo vệ uy tín của bạn.

Tiêu điểm công cụ: ESLint

Đối với các đoạn mã JavaScript, ESLint quét mã để tìm lỗi cú pháp và các vi phạm về phong cách lập trình. Nó sử dụng cấu hình tối giản để tìm lỗi. Việc đưa nó vào quy trình làm việc sẽ cung cấp phản hồi tức thì về việc liệu một đoạn mã có tuân thủ các quy ước chung hay không.

Kịch bản nhỏ

Bạn yêu cầu AI cung cấp một ví dụ về yêu cầu fetch. ESLint đánh dấu một dấu chấm phẩy bị thiếu và một biến không được sử dụng. Bạn quay lại câu lệnh (prompt) để sửa lỗi và xóa biến đó. Đoạn mã đã chỉnh sửa vượt qua bước kiểm tra lint.

Các bước thực hiện

  • Trích xuất và Cô lập: Sao chép đoạn mã do AI tạo ra vào một tệp tạm thời. Đảm bảo không có khóa (keys) hoặc dữ liệu production nào hiện diện.

  • Chạy kiểm tra tự động: Thực thi một linter như ESLint hoặc sử dụng một bài kiểm tra sandbox trực tuyến nhanh chóng. Ghi lại bất kỳ lỗi hoặc cảnh báo nào.

  • Lặp lại với AI: Gửi các vấn đề đã báo cáo lại cho AI kèm theo một yêu cầu chỉnh sửa rõ ràng. Tạo lại đoạn mã và lặp lại việc kiểm tra cho đến khi các công cụ báo cáo trạng thái sạch (không lỗi).

Kết luận

Một vòng lặp kiểm chứng đơn giản giúp những người viết tài liệu kỹ thuật đảm bảo các đoạn mã là chính xác và tuân thủ các thông số kỹ thuật. Bằng cách biến các bước kiểm tra này thành thói quen, bạn sẽ cải thiện chất lượng tài liệu và duy trì sự tin tưởng của người đọc.

Source: https://dev.to/ken_deng_ai/the-validation-step-how-to-test-and-verify-ai-generated-code-without-being-a-developer-49am

Optional learning community: https://t.me/GyaanSetuAi