Buộc Model Hoàn Thiện Thiết Kế Trước Khi Viết Code

Dự án code theo cảm hứng thường hỏng ở hai chỗ. code bị ghép chặt, nên một thay đổi làm vỡ ba thứ bạn không đụng tới. Và giao diện không có trạng thái, nên nhìn ổn cho tới lúc nó trống, chậm, hoặc sai.

Hai cách cũ giải quyết phần lớn cả hai lỗi này. Thiết kế tiên đề của Nam Suh, 1990, cho lỗi đầu. Tiêu chí thiết kế của Don Norman cho lỗi thứ hai. Cả hai đều không mới và không nói về AI. Đó là điểm chính.

Prompt

Trước khi bạn viết bất kỳ code nào, hãy làm như sau:

- Liệt kê các yêu cầu chức năng. Nói hệ thống phải làm gì như một kết quả, không phải như cách triển khai. Đánh số là FR1, FR2, và tiếp tục.

- Liệt kê các tham số thiết kế. Nêu các khối, hàm, hoặc cấu trúc dữ liệu cụ thể đáp ứng từng FR. Đánh số là DP1, DP2, và tiếp tục.

- Lập ma trận thiết kế. Với mỗi cặp FR và DP, đánh dấu X nếu thay đổi DP đó làm thay đổi FR đó. Cho tôi xem ma trận.

- Nếu ma trận không chéo hoặc tam giác, sửa các DP cho đến khi nó như vậy. Nói rõ bạn đã đổi gì và vì sao. Đừng tiếp tục với một thiết kế ghép chặt.

- Chọn bộ DP có lượng thông tin ít nhất. Nếu hai thiết kế thỏa cùng FR, lấy cái có ít phần phải thay đổi hơn và ít giả định hơn. Nói vì sao cái bạn chọn là cái đơn giản hơn.

- Với mỗi thành phần tương tác, nêu khả năng gợi tác vụ, dấu hiệu nhận biết, phản hồi khi thành công, phản hồi khi thất bại, và đường quay lại. Bao gồm trạng thái trống, trạng thái đang tải, và trạng thái một phần.

- Dừng ở đây. Cho tôi xem toàn bộ những gì ở trên. Đừng viết code cho đến khi tôi chấp thuận.

Dùng sao cho hiệu quả

Bước 1 đến bước 5 là thiết kế tiên đề. Bước 6 là Norman. Bước 7 là phần nhiều người bỏ qua, và cũng là phần quan trọng nhất.

Cái model hay làm là viết một ma trận để hợp thức hóa code nó đã định viết. Ma trận tự báo cáo không phải là phép kiểm. Hãy tự đọc ma trận. Chọn một DP và hỏi nếu xóa nó thì FR nào hỏng. Nếu hơn một FR bị ảnh hưởng, ma trận sai.

Cách này không sửa được API bịa đặt và hàm thư viện bịa đặt. Nó cũng không đụng tới bảo mật, xác thực, và toàn vẹn dữ liệu. Với đoạn code ngắn, dưới khoảng 50 dòng, đây chỉ là phần nghi thức, nên bỏ qua.