Tạo tài liệu yêu cầu cho Claude: cách tránh việc AI làm thiếu module

Một trong những thất vọng lớn nhất khi dùng AI là sản phẩm 'gần đúng nhưng thiếu' — thiếu một màn hình, quên một luồng xử lý, bỏ sót một vai trò. Hầu hết những thiếu sót này không phải lỗi của AI mà do yêu cầu chưa đầy đủ. Bài viết hướng dẫn cách viết tài liệu yêu cầu để Claude làm đủ và đúng, một kỹ năng nền tảng của khóa học lập trình bằng AI.

Vì sao AI hay làm thiếu

Claude làm theo những gì bạn nói, không theo những gì bạn nghĩ trong đầu. Nếu một tính năng tồn tại trong tưởng tượng của bạn nhưng không được viết ra, AI không thể đoán. Thiếu sót trong sản phẩm thường phản ánh thiếu sót trong mô tả. Vì vậy, một tài liệu yêu cầu rõ ràng là cách hiệu quả nhất để tránh việc AI làm thiếu.

Tài liệu yêu cầu là gì, đơn giản hóa

Đừng để cụm từ 'tài liệu yêu cầu' làm bạn e ngại. Nó chỉ là một bản viết rõ ràng về sản phẩm cần làm gì. Không cần ngôn ngữ kỹ thuật hay định dạng phức tạp — chỉ cần đầy đủ và mạch lạc. Một danh sách có tổ chức về các tính năng, dữ liệu và vai trò đã là một tài liệu yêu cầu hữu ích.

Liệt kê đầy đủ các tính năng

Hãy viết ra mọi tính năng sản phẩm cần, kể cả những thứ tưởng như hiển nhiên. 'Người dùng đăng nhập' — nhưng còn quên mật khẩu thì sao? 'Hiển thị danh sách' — nhưng khi danh sách rỗng thì hiện gì? Những chi tiết dễ bỏ quên này chính là nơi sản phẩm hay thiếu sót. Viết đầy đủ giúp AI không bỏ sót.

Mô tả dữ liệu và mối quan hệ

Hãy nêu rõ dữ liệu cần lưu và chúng liên hệ với nhau ra sao: một khách hàng có nhiều đơn hàng, một đơn hàng thuộc về một khách. Khi AI hiểu rõ cấu trúc dữ liệu mong muốn, nó dựng nền tảng đúng ngay từ đầu, tránh việc phải sửa lớn về sau khi phát hiện thiếu một mối liên hệ quan trọng.

Xác định vai trò và quyền hạn

Một nguồn thiếu sót phổ biến là quên các vai trò khác nhau. Hãy liệt kê ai sẽ dùng sản phẩm và mỗi người làm được gì: admin, nhân viên, khách hàng. Nếu không nói rõ, AI có thể chỉ làm cho một loại người dùng và bỏ qua các vai trò khác. Mô tả vai trò đầy đủ đảm bảo sản phẩm phục vụ đúng mọi đối tượng.

Mô tả luồng xử lý từ đầu đến cuối

Tính năng riêng lẻ chưa đủ; chúng phải nối thành luồng hoàn chỉnh. Hãy mô tả các bước theo trình tự: khách đặt hàng → nhận xác nhận → admin xử lý → cập nhật trạng thái → khách được thông báo. Khi AI thấy toàn bộ luồng, nó không bỏ sót các bước trung gian — nơi sản phẩm thường bị đứt gãy.

Dùng tài liệu để kiểm tra kết quả

Tài liệu yêu cầu còn có công dụng thứ hai quý giá: làm checklist nghiệm thu. Sau khi AI làm xong, bạn đối chiếu sản phẩm với từng mục trong tài liệu để phát hiện cái gì thiếu, cái gì sai. Tài liệu vừa là bản giao việc đầu vào, vừa là thước đo đầu ra. Đây là một trong những thói quen giá trị nhất bạn rèn được trong khóa học.