Tạo Kỹ Năng cho AI Agent: Cơ Chế, Thực Tiễn Tốt Nhất và Chuyển Thành Plugin

Tác giả, người phát triển kho lưu trữ rpa-skills, trình bày chi tiết cách tạo kỹ năng (skill) cho các tác tử AI một cách đúng đắn. Một kỹ năng không phải là một tệp markdown đơn lẻ mà là một thư mục chứa tệp SKILL.md bắt buộc, bao gồm tiêu đề YAML (tên, mô tả) và phần thân hướng dẫn, cùng với các thư mục tùy chọn references/, scripts/, assets/ và README.md. Nguyên tắc tiết lộ dần dần (progressive disclosure) chỉ tải mô tả kỹ năng vào hệ thống; phần thân được kéo về khi kỹ năng được kích hoạt, do đó phần thân nên được giữ ở mức 500 dòng, với nội dung nặng được chuyển sang references/. Trong trường mô tả, điều quan trọng là phải chỉ rõ mục đích và điều kiện kích hoạt, tránh các từ chung chung như MUST để ngăn mô hình kích hoạt kỹ năng một cách bừa bãi. Tác giả nhấn mạnh sự khác biệt giữa kỹ năng và quy tắc: quy tắc (với alwaysApply: true) luôn hoạt động và phù hợp cho kiểu mã hoặc xử lý lỗi, trong khi kỹ năng tốt hơn cho các quy trình nhiều bước (triển khai, BDD, phân tích lỗi). Mô tả và phần thân của kỹ năng nên được viết bằng tiếng Anh do vấn đề token hóa: chữ Cyrillic trung bình tốn gấp đôi token so với chữ Latin, tiết kiệm ngữ cảnh. Các thực tiễn từ Anthropic được cung cấp: mức độ tự do (ràng buộc chặt chẽ cho các tác vụ quan trọng, không gian mở cho các tác vụ sáng tạo), các thao tác xác định nên được chuyển sang scripts, một phần bắt buộc cho các lỗi phổ biến (Gotchas), tên ở dạng động từ thêm -ing (ví dụ: processing-pdfs), và tránh sự đa dạng quá mức — tốt hơn là đưa ra một giải pháp chính và một giải pháp dự phòng. Để kiểm tra một kỹ năng, hãy chạy một tác tử phụ với ngữ cảnh sạch và kiểm tra xem kỹ năng có tự động kích hoạt không, nó đã gây ra lỗi ở đâu, và kết quả có khớp với kỳ vọng không. Ít nhất ba lần chạy trên các tác vụ khác nhau và trên các mô hình khác nhau, bao gồm cả các mô hình nhỏ tuân theo hướng dẫn theo nghĩa đen, được khuyến nghị. Một kỹ năng cho thị trường được đóng gói dưới dạng plugin — một thư mục với tệp kê khai plugin.json (đối với Claude Code trong .claude-plugin/, đối với Codex trong .codex-plugin/), chỉ định siêu dữ liệu, với tên khớp với tên từ SKILL.md và phiên bản được đồng bộ. Plugin cũng có thể bao gồm các lệnh gạch chéo, tác tử phụ, hook và máy chủ MCP.