Viết PRD mà các nhà phát triển thực sự đọc, với Claude là người biên tập

PRD đầu tiên của tôi quay lại với câu hỏi 'bạn có thể nói nên xây dựng cái gì không.' Vì vậy, tôi ngừng viết tài liệu và bắt đầu viết các thông số kỹ thuật mà một kỹ sư mệt mỏi có thể chấp nhận được. Công việc của Claude trong việc này là cắt chứ không phải phát minh.

Cấu trúc đầu tiên: một dòng về vấn đề, một dòng về người dùng, một danh sách ngắn về ý nghĩa của 'hoàn thành' và các trường hợp đặc biệt mà các nhà phát triển thực sự gặp phải. Không có tiểu thuyết nền. Nếu nó cần một đoạn ngữ cảnh, nó sẽ thuộc về một chuỗi liên kết.

Hãy soạn thảo đơn giản rồi dán cho Claude với một hướng dẫn: 'xóa mọi câu mà nhà phát triển có thể suy ra và gắn cờ bất kỳ yêu cầu nào không có kiểm tra chấp nhận.' Lời nhắc duy nhất đó sẽ loại bỏ những thứ rườm rà khiến PRD có thể bỏ qua.

Sau đó, tôi thêm các bài kiểm tra chấp nhận mà Claude đánh dấu là thiếu. Một yêu cầu không có bài kiểm tra là một ý kiến. Nhà phát triển đọc thông số kỹ thuật mà họ có thể xác minh; họ lướt qua phần còn lại.

Thói quen đã thay đổi mọi thứ: Tôi viết PRD với suy nghĩ người đọc không có đủ ngữ cảnh và không có kiên nhẫn. Claude giúp tôi giữ vững quan điểm đó bằng cách xóa phần văn xuôi lịch sự.

Claude (claude.ai)

Phù hợp nhất cho: viết bài dài, chỉnh sửa và lý luận thông qua cấu trúc.

Các tính năng chính: chế độ tài liệu, ngữ cảnh dài, tạo tác cho bản nháp, chỉnh sửa cẩn thận.

Gói miễn phí: cấp độ miễn phí với giới hạn hàng ngày.

Giá cả: Pro khoảng $20 một tháng để sử dụng nhiều hơn.

Ưu điểm: mạnh về cắt xén và tái cấu trúc, duy trì thời gian ngắn.

Nhược điểm: nó sẽ làm dịu đi một quan điểm thẳng thừng trừ khi bạn bảo nó không làm vậy.

Phán quyết của tôi: Tôi viết xương, Claude loại bỏ mỡ, tôi thêm lại các trường hợp cạnh. Tài liệu tạo ra kết quả đủ ngắn để đọc và đủ cụ thể để xây dựng.

Các câu hỏi thường gặp:

Hỏi: Claude có nên viết PRD từ đầu không?

A: Tôi viết cấu trúc; Claude chỉnh sửa. Toàn bộ thế hệ đang đi chệch khỏi những gì nhóm thực sự cần.

Q: Ngắn thế nào là ngắn?

Trả lời: Nếu một nhà phát triển có thể xây dựng nó và kiểm tra nó từ tài liệu thì nó đủ dài. Dài hơn thường là phần đệm.

Câu hỏi: Tôi có cần kiểm tra chấp nhận cho từng dòng không?

Đáp: Có, đối với bất kỳ điều gì mà người QA sẽ kiểm tra. Những yêu cầu mơ hồ sau này sẽ trở thành lỗi lầm.