Viết cho người đọc tương lai

Ý chính

Bạn không viết file cho chính bạn lúc vừa chat xong. Bạn viết cho người đọc tương lai, khi họ không còn nhớ bối cảnh. Người đọc tương lai có thể là bạn tuần sau, một teammate hoặc một agent mới cold-start.

Chuẩn cold-start

Một file bền cần đủ để người đọc mới hiểu trong 30 giây:

• mục đích của file;
• khi nào dùng;
• điều kiện trước khi dùng;
• bước đầu tiên;
• điều cần tránh;
• link tới nơi liên quan.

Luật viết

• Viết title theo thứ người đọc sẽ tìm.
• Mở đầu bằng kết luận, không mở đầu bằng lịch sử dài.
• Tách quyết định khỏi lý do.
• Tách cách làm khỏi ví dụ.
• Xóa nhánh brainstorm đã bỏ.
• Giữ link nguồn nếu cần kiểm chứng, nhưng đừng bắt người đọc mở nguồn mới hiểu.

Before / after

Before:

Hôm qua nói với agent vụ docs bị trôi, đại khái nên audit lại rồi nhớ link index.

After:

Chat-To-File Field Checklist: dùng sau một phiên chat hữu ích; file chỉ qua cổng nếu có type, location, title, index link, cold-start block và freshness marker.

Bài tập

Viết lại một đoạn note nháp thành file mà một người chưa đọc chat vẫn dùng được.