Một AI Skill có thể chứa quy trình rất tốt nhưng vẫn bị bỏ qua hoặc kích hoạt nhầm nếu phần description viết chưa rõ. Đây là tín hiệu quan trọng giúp AI nhận diện khi nào nên dùng Skill, khi nào không nên dùng và người dùng cần cung cấp ngữ cảnh gì. Nếu bạn đang xây dựng Skill đầu tiên, hãy đọc bài AI Skill là gì? và bài Cách kiểm thử AI Skill trước khi đóng gói.
Description trong SKILL.md có vai trò gì?
Description là phần mô tả ngắn cho biết Skill làm gì, phù hợp với tình huống nào và tín hiệu nào cho thấy Skill nên được dùng. Nó không phải lời quảng cáo và cũng không phải bản sao của toàn bộ hướng dẫn vận hành. Một description tốt giúp trả lời ba câu hỏi: Skill giải quyết loại công việc nào, người dùng thường diễn đạt nhu cầu ra sao và ranh giới nào cho biết Skill không nên được kích hoạt.
Công thức viết description rõ và dễ kích hoạt
Bạn có thể bắt đầu bằng công thức: [đối tượng công việc] + [kết quả cần đạt] + [tình huống kích hoạt] + [giới hạn quan trọng]. Ví dụ: Dùng khi người dùng muốn cắt video dài thành nhiều video ngắn dọc 9:16, chọn đoạn có ý rõ và giữ chủ thể trong khung; không dùng cho dựng TVC nhiều cảnh hoặc chỉnh màu chuyên sâu.
Bốn thành phần nên có trong description
Một description rõ nên có bốn lớp thông tin: công việc chính dùng động từ cụ thể; kết quả đầu ra như bài SEO, video dọc hoặc file ZIP; cách người dùng thường mô tả nhu cầu; và điều kiện không nên dùng. Hãy kết hợp thuật ngữ chuyên môn với cách nói tự nhiên thay vì nhồi từ khóa.
Những lỗi thường gặp khi viết description
Các lỗi phổ biến là mô tả quá ngắn và mơ hồ, phạm vi quá rộng, nhồi quá nhiều quy trình hoặc chỉ dùng thuật ngữ nội bộ. Description không nên chứa toàn bộ từng bước vận hành; hãy để phần hướng dẫn chính của SKILL.md đảm nhiệm việc đó.
Checklist kiểm tra trước khi đóng gói
Hãy tạo bộ test gồm: gọi đúng tên Skill; mô tả đúng nhu cầu nhưng không gọi tên; yêu cầu có thêm ngữ cảnh; negative control không nên kích hoạt; và đầu vào thiếu hoặc sai. Nếu Skill bị bỏ qua ở hai nhóm đầu, description có thể quá hẹp. Nếu kích hoạt ở negative control, description đang quá rộng. Mỗi lỗi phát hiện nên được thêm vào bộ kiểm thử hồi quy.
Description trong SKILL.md nên dài bao nhiêu?
Không có một con số bắt buộc. Hãy viết đủ để nêu chức năng, đầu ra, tín hiệu kích hoạt và ranh giới, nhưng bỏ các chi tiết chỉ dùng trong một bước vận hành.
Có nên cập nhật description sau khi phát hành không?
Có. Khi phát hiện Skill bị bỏ qua hoặc kích hoạt nhầm, hãy sửa description, thêm tình huống đó vào bộ kiểm thử hồi quy và chạy lại các ca cốt lõi trước khi đóng gói phiên bản mới.