Dùng Claude viết hướng dẫn sản phẩm để khách hàng tự làm được

Một khách hàng thường mở hướng dẫn khi đang mắc ở một việc cụ thể: kích hoạt tài khoản, tạo dự án đầu tiên hoặc xuất file. Họ cần biết bước tiếp theo, không cần đọc hết mọi tính năng. Tài liệu tốt giúp khách đạt kết quả mà không phải đoán.

Claude có thể giúp sắp xếp và diễn đạt tài liệu nhanh hơn. Đầu vào quan trọng nhất là quy trình sản phẩm đã được xác nhận, ảnh chụp đúng phiên bản và những câu hỏi hỗ trợ thực tế.

🎯 1. Chọn một tác vụ thay vì viết cả cuốn sách

Bắt đầu bằng tác vụ có giá trị rõ ràng, chẳng hạn “xuất video đầu tiên” hoặc “thêm sản phẩm vào danh mục”. Ghi người đọc là ai, họ đang ở trạng thái nào và màn hình nào xác nhận thành công.

Lập danh sách ba đến năm tác vụ đầu tiên từ dữ liệu hỗ trợ. Tách hướng dẫn bắt đầu, hướng dẫn nâng cao và xử lý lỗi để khách tìm đúng phần. Số trang không phải thước đo chất lượng; một bài ngắn giải quyết trọn vẹn một việc có thể hữu ích hơn tài liệu dài.

📸 2. Thu thập bằng chứng từ sản phẩm

Đi hết luồng bằng một tài khoản thử nghiệm và ghi lại tên nút, trường bắt buộc, điều kiện trước khi bắt đầu và kết quả sau mỗi bước. Chụp ảnh những chỗ dễ nhầm, đặc biệt khi có nhiều lựa chọn gần giống nhau.

• Ghi phiên bản ứng dụng, hệ điều hành và loại tài khoản khi chúng ảnh hưởng giao diện.
• Dùng dữ liệu mẫu trong ảnh; cắt phần không liên quan.
• Phân biệt tính năng đang có với tính năng dự kiến.
• Chỉ mô tả lỗi và cách xử lý đã có căn cứ từ sản phẩm hoặc đội hỗ trợ.

Ảnh giao diện là bằng chứng thao tác. Đừng dùng một ảnh UI do AI tưởng tượng để chỉ vị trí nút thật. Nếu cần video ngắn, CYAN CAM, hiện ở beta, có thể hỗ trợ ghi lại quy trình.

✍️ 3. Dùng prompt viết theo hành động

Gửi Claude ghi chú và ảnh đã chuẩn bị. Yêu cầu nêu rõ phần đọc được, phần không nhìn thấy hoặc chưa đủ dữ liệu.

Viết hướng dẫn cho khách hàng mới hoàn thành [tác vụ].
Sản phẩm/phiên bản: [thông tin].
Nguồn đã xác nhận: [ghi chú thao tác, ảnh, câu trả lời hỗ trợ].

Cấu trúc:
1. Kết quả khách sẽ đạt được.
2. Điều kiện cần có trước khi bắt đầu.
3. Các bước theo đúng thứ tự, mỗi bước một hành động chính.
4. Dấu hiệu thành công và việc làm tiếp theo.
5. Lỗi có bằng chứng và cách liên hệ hỗ trợ nếu chưa xử lý được.

Giữ nguyên nhãn nút và tên trường trong nguồn.
Không tạo thêm tính năng, chính sách hoặc cách sửa lỗi.
Chỗ thiếu thông tin đánh dấu [CẦN XÁC MINH].
Đặt mã ảnh phù hợp sau bước cần minh họa.
Dùng câu ngắn, giải thích thuật ngữ khi xuất hiện lần đầu.

Một bước tốt có động từ rõ: “Chọn Xuất, kiểm tra thư mục đích rồi bấm Lưu”. Nếu bước có nhiều nhánh, tách theo điều kiện thay vì nhét tất cả vào một câu dài.

🧭 Viết cho người đang làm, không chỉ người đang đọc

Đặt thông tin cần biết trước hành động liên quan. Ví dụ, nếu thao tác sẽ ghi đè một file, người đọc cần biết điều đó trước khi bấm xác nhận. Đừng để ghi chú quan trọng ở cuối bài, sau khi khách đã làm xong.

🧪 4. Nhờ người mới làm theo

Đưa bản nháp cho một người chưa quen sản phẩm. Yêu cầu họ hoàn thành tác vụ mà không nghe giải thích miệng. Ghi lại nơi họ dừng, hiểu sai hoặc phải quay lại; đó là dữ liệu để sửa tài liệu.

Đây là các điểm người thử bị mắc và ảnh giao diện liên quan.
Hãy sửa đúng những bước gây nhầm.
Giữ nguyên thông tin đã được xác nhận.
Với mỗi sửa đổi, nêu vì sao nó giải quyết điểm mắc.
Không thêm bước nếu chưa có nguồn chứng minh.

Đọc lại toàn bộ luồng sau khi sửa. Nếu câu chữ đổi nhưng người thử vẫn không biết cần bấm gì, vấn đề có thể nằm ở ảnh hoặc chính giao diện, không chỉ ở cách viết.

🌐 5. Xuất bản ở nơi khách dễ tìm

Dùng tiêu đề theo tác vụ, chẳng hạn “Cách xuất file MP4”, thay vì “Khám phá tính năng nâng cao”. Đặt liên kết tại màn hình liên quan hoặc mục trợ giúp. Kiểm tra hiển thị trên điện thoại và khả năng đọc chữ trong ảnh.

Khi dịch sang tiếng Anh, giữ đúng nhãn giao diện của phiên bản ngôn ngữ tương ứng. Nếu nút chỉ có tiếng Anh, đừng tự dịch tên nút khiến người dùng tìm không thấy. Bản web, PDF và video cần có cùng phiên bản nội dung.

🔄 6. Duy trì bằng dữ liệu hỗ trợ

Theo dõi câu hỏi nào vẫn quay lại, bước nào được hỏi nhiều và tỷ lệ hoàn thành tác vụ nếu bạn có cách đo phù hợp. Không mặc định rằng đăng tài liệu sẽ làm yêu cầu hỗ trợ giảm một tỷ lệ cố định.

Mỗi lần sản phẩm đổi giao diện, xem lại các bài bị ảnh hưởng. Nếu bạn cần tài liệu cho lập trình viên thay vì khách hàng cuối, xem thêm quy trình viết tài liệu từ GitHub README.

Hãy dùng Claude để giảm thời gian soạn thảo, rồi dùng thao tác thật để xác nhận hướng dẫn có làm được hay không.