Tôi hiểu hướng dẫn của mình, nhưng người mới thì sao?

Có một câu hỏi tôi thường muốn tự đặt ra khi viết hướng dẫn với A.I: “Nếu đưa tài liệu này cho một người chưa từng làm cùng mình, họ có biết phải bắt đầu từ đâu không?” Nghe đơn giản, nhưng câu hỏi ấy khiến cách tôi nhìn tài liệu thay đổi khá nhiều.

Người viết thường biết sẵn tài liệu nguồn nằm ở đâu, vì sao phải chọn cột này và kết quả nào được xem là phù hợp. Chính vì biết quá rõ, chúng ta dễ bỏ qua những chi tiết mà người mới thật sự cần. Một dòng “nạp dữ liệu và chạy kiểm thử” có thể rõ với người tạo, nhưng chưa chắc đủ với người mới dùng ChatGPT.

Khoảng trống thường nằm giữa hai bước

Khi xây dựng tài liệu hướng dẫn chatbot rà soát hồ sơ công việc, tôi nghĩ đến cả người học lần đầu và người tiếp nhận vận hành. Hai người ấy cần những chỉ dẫn khác nhau. Người học cần thấy các thao tác từ đầu đến cuối. Người tiếp nhận cần biết nguồn nào đang dùng, ghi lỗi ở đâu và ai có quyền cập nhật.

Tôi không muốn tài liệu chỉ có những chữ nghe rất chuyên nghiệp như “chuẩn hóa”, “kiểm thử”, “nghiệm thu” mà lại thiếu một ví dụ cụ thể để người dùng nhìn vào làm theo. Vì thế, tôi xem trọng việc tách rõ đầu vào, các bước làm, kết quả mong đợi, lỗi thường gặp và cách xử lý khi thiếu thông tin.

Cũng từ đó, tôi thích những câu trả lời có tiêu chí kiểm tra hơn là những lời khẳng định chung chung. Chẳng hạn, thay vì viết “Skill hoạt động tốt”, cần chỉ ra người dùng có thể nạp đúng tài liệu, nhận đúng mẫu kết quả, kiểm tra lại căn cứ và biết khi nào không nên tin câu trả lời của A.I.

Bài kiểm tra quan trọng nhất không nằm ở người viết

Tôi có thể đọc lại một Skill và thấy mọi điều đều hợp lý. Nhưng điều đó mới cho biết tôi hiểu chính tài liệu mình viết. Nếu muốn chia sẻ rộng hơn, cần một người khác dùng thử, ghi những chỗ vướng và phản hồi lại. Chỗ họ phải hỏi chính là chỗ hướng dẫn cần rõ hơn.

Có những bước có thể đơn giản hóa. Có những nội dung cần giữ nguyên vì liên quan trách nhiệm chuyên môn. Và có những dữ liệu nội bộ không được đưa vào bản hướng dẫn công khai; khi ấy phải dùng ví dụ mô phỏng thay thế.

Tài liệu tốt không phải tài liệu khiến người viết thấy mình giỏi. Nó phải khiến người mới biết mình cần làm gì tiếp theo.

Nếu bạn đang chuẩn bị chia sẻ một quy trình A.I, hãy thử nhờ người chưa biết quy trình đọc và làm theo. Đừng giải thích thêm ngay. Hãy ghi lại các câu hỏi họ đặt ra. Đó là cách rất thực tế để biến một Skill “của tôi” thành một phương pháp “người khác cũng dùng được”.