Description là phần mô tả giúp AI nhận biết một Skill dùng cho ai, xử lý yêu cầu nào và tạo ra kết quả gì. Một description tốt giúp phân biệt Skill với các Skill gần nghĩa và giảm lỗi kích hoạt nhầm.
Description của AI Skill là gì?
Description là bản mô tả giúp AI nhận biết Skill dùng cho ai, xử lý yêu cầu nào và tạo ra kết quả gì. Nó là tín hiệu định tuyến ngắn, không phải phần hướng dẫn chi tiết trong SKILL.md.
Checklist nhanh: description nêu rõ đối tượng, tác vụ, đầu ra, tín hiệu độc quyền và negative control; không nhồi quy trình dài; có positive, negative và conflict case; luôn chạy hồi quy sau khi chỉnh sửa.
Vì sao description viết chung chung dễ gây lỗi?
Các mô tả như “viết nội dung” hoặc “dùng AI” quá rộng nên nhiều Skill cùng khớp. Khi thiếu đối tượng, đầu ra và giới hạn, AI dễ kích hoạt nhầm Skill tổng quát hoặc gọi nhiều Skill cùng lúc.
Công thức viết description có thể phân biệt Skill
Hãy nêu đối tượng, tác vụ cụ thể, đầu ra chính, điều kiện kích hoạt và giới hạn. Description nên giống một hợp đồng phạm vi ngắn: đọc là biết Skill nhận việc gì và không nhận việc gì.
Năm thành phần cần có trong description
Một description tốt cần có đối tượng và bối cảnh, động từ tác vụ cụ thể, đầu ra có tiêu chí kiểm tra, tín hiệu kích hoạt độc quyền và giới hạn hoặc negative control. Thiếu một trong các thành phần này, vùng chồng lấn với Skill khác sẽ tăng.
Cách phân biệt description với instructions trong SKILL.md
Description chỉ định tuyến; instructions mới hướng dẫn từng bước thực hiện. Không nên nhồi toàn bộ quy trình, tiêu chuẩn định dạng và danh sách công cụ vào description vì tín hiệu định tuyến sẽ bị loãng.
Quy trình kiểm tra description trước khi đóng gói
Viết một positive case chắc chắn phải kích hoạt, hai negative control không được kích hoạt, một conflict case có tín hiệu kép, sau đó so sánh với Skill gần nhất và chạy lại bộ test hồi quy.
Ví dụ description trước và sau khi sửa
Bản yếu: “Tạo nội dung bằng AI”. Bản rõ: “Dùng khi chủ kênh cần viết bài Facebook hoàn chỉnh có hook, CTA và hashtag; không dùng cho kịch bản video hoặc email.” Bản sau có tác vụ, đầu ra và giới hạn cụ thể.
Description nên dài bao nhiêu?
Không có độ dài bắt buộc. Hãy viết đủ để phân biệt phạm vi, đầu ra và giới hạn; quy trình chi tiết nên chuyển sang SKILL.md.
Description tốt cần có negative control không?
Có. Negative control là yêu cầu gần giống nhưng nằm ngoài phạm vi, giúp kiểm tra Skill có tự loại mình khi không phù hợp hay không. Đây là phần quan trọng để giảm kích hoạt nhầm.
Đọc thêm cách thiết kế trigger và negative control, cách xử lý xung đột khi nhiều AI Skill và cách xây dựng bộ test hồi quy.