WTFM: Plugin mã nguồn mở tự viết tài liệu hướng dẫn cho app
Nếu bạn đang làm tool, bot hay shop online và thường xuyên phải trả lời những câu hỏi hỗ trợ lặp đi lặp lại, việc thiếu tài liệu hướng dẫn cuối cùng sẽ ngốn hết thời gian của bạn. WTFM (Write the F***ing Manual) là một plugin mã nguồn mở, miễn phí, thiết kế để chạy cùng Claude Code hoặc Codex nhằm giải quyết vấn đề này.
Mục lục
WTFM hoạt động như thế nào
WTFM không yêu cầu bạn khởi chạy ứng dụng thật. Khi bạn ra lệnh cho agent tạo tài liệu, plugin sẽ thực hiện tuần tự các bước sau:
- Đọc trực tiếp routes, templates và controllers trong mã nguồn để nắm được luồng thao tác thực tế cũng như nhãn của các nút bấm.
- Dựng lại từng màn hình từ chính markup và CSS của dự án, sau đó xuất ra file ảnh PNG. Ứng dụng không cần phải chạy ở bất kỳ môi trường nào.
- Đối chiếu lại các bước và ảnh chụp với mã nguồn gốc để kiểm tra tính chính xác.
- Lưu kết quả thành một file Markdown thuần tuý, đặt các ảnh ngay bên cạnh trong thư mục repo của bạn.
Vì sao ảnh chụp màn hình là điểm mấu chốt
Tác giả của dự án chia sẻ rằng phần chữ viết chưa bao giờ là rào cản lớn khi làm tài liệu. Khâu tốn công nhất là chạy ứng dụng, đổ dữ liệu mẫu, click qua từng bước rồi cắt ghép ảnh. Đó chính là lý do nhiều người bỏ qua việc viết bài hướng dẫn cho người dùng cuối. WTFM tập trung loại bỏ đúng khâu này bằng cách render ảnh tĩnh từ mã nguồn.
Cách viết câu lệnh (prompt) cho chủ shop không chuyên code
Bạn không cần biết lập trình sâu để dùng plugin này. Nếu bạn đang quản lý một web bán hàng và muốn tạo trang hướng dẫn khách mua, hãy soạn câu lệnh theo cấu trúc đơn giản sau rồi gửi cho agent:
"Hãy dùng WTFM để viết hướng dẫn từng bước cho chức năng [tên chức năng, ví dụ: đặt hàng / đổi mật khẩu / tải hoá đơn]. Liệt kê rõ các nút cần bấm và tạo ảnh minh hoạ tương ứng."
Agent sẽ tự tìm đến đúng phần mã nguồn xử lý chức năng đó để trích xuất thông tin. Bạn chỉ cần thay thế tên chức năng phù hợp với nhu cầu của mình.
Cộng đồng nói gì
Trên Reddit, một số bình luận tỏ ra hào hứng muốn thử ngay nhưng lo ngại về lượng token tiêu thụ và thắc mắc vì sao không có ví dụ thực tế. Một ý kiến nhấn mạnh cần xác định rõ vai trò của người đọc để hướng dẫn không chỉ nhầm nút dành cho quản trị viên sang người dùng thường. Một bình luận khác cho rằng chi phí thực sự nằm ở việc trả lời email hỗ trợ và đặt vấn đề liệu công cụ có tự cập nhật tài liệu khi giao diện thay đổi hay không.
Dùng thử thế nào
Bạn có thể cài đặt WTFM từ kho lưu trữ GitHub tại địa chỉ github.com/SupportPages-io/wtfm và sử dụng trực tiếp trong môi trường Claude Code hoặc Codex.
Điều cần lưu ý
- Ảnh chụp màn hình do WTFM tạo ra là bản dựng từ CSS, không phải ảnh chụp từ ứng dụng đang chạy thực tế nên sẽ không hiển thị dữ liệu thật.
- Plugin chỉ viết tài liệu hướng dẫn cho người dùng cuối, không dùng để sinh tài liệu kỹ thuật API.
- WTFM hoạt động trên macOS và Linux (dùng WSL nếu bạn chạy Windows), tiêu thụ token từ agent của bạn, không yêu cầu tạo tài khoản và có thể tắt tính năng thống kê ẩn danh.
Nên làm gì tiếp
Hãy truy cập wtfm.sh để xem chi tiết về plugin và thử tạo một bài hướng dẫn ngắn cho dự án cá nhân của bạn. Kiểm tra kỹ xem ảnh PNG dựng từ CSS đã khớp với giao diện thực tế chưa, vì đây là giai đoạn đầu phát triển nên tác giả vẫn đang ghi nhận các trường hợp sai lệch để cải thiện.