Kỹ năng Agent trong các gói npm: Cung cấp kiến thức thư viện cho Agent

Bài viết này bàn về việc phân phối Agent Skills — một định dạng mở dành cho hướng dẫn của các agent AI — thông qua các gói npm. Khi một agent gặp một thư viện mới, việc khám phá mã nguồn tuy hiệu quả nhưng lại không tối ưu về thời gian; tác giả gói (author) hiểu rõ những điều cốt lõi và có thể mã hóa chúng vào một tệp SKILL.md nằm trong thư mục skills/ bên trong gói. Tệp này chứa metadata dạng YAML cùng các hướng dẫn, và có thể đi kèm thư mục references/ tùy chọn để cung cấp thêm chi tiết. Ví dụ, gói @teqfw/db có kèm theo một skill như vậy, hướng dẫn agent cách sử dụng gói này đúng cách, tránh gọi vào các API riêng tư (private API), tôn trọng ranh giới giao dịch (transaction), và không đưa ra giả định trong quá trình tái tạo cơ sở dữ liệu (DB rebuild). Việc đóng gói skill cùng với gói npm đảm bảo rằng agent luôn nhận được hướng dẫn khớp đúng phiên bản, được cập nhật mỗi khi cài đặt hoặc khôi phục (rollback). Tuy nhiên, việc chỉ đơn thuần có một skill nằm trong node_modules không có nghĩa là nó sẽ tự động được kích hoạt; các dự án phải liên kết nó một cách tường minh, chẳng hạn như thông qua symlink trong thư mục .agents/skills, nhằm kiểm soát những dependency nào được phép ảnh hưởng đến hành vi của agent. Tác giả đã triển khai cách làm này trong các gói TeqFW như @teqfw/di, cfg, cli, log, db, và @flancer32/teq-web. Một số hạn chế bao gồm khả năng agent hiểu sai hướng dẫn, skill bị lỗi thời, và tình trạng phình to ngữ cảnh (context bloat); do đó, các skill nên được viết ngắn gọn và chỉ đóng vai trò bổ sung cho mã nguồn, kiểu dữ liệu (types) và tệp README, chứ không thay thế chúng. Các công trình liên quan bao gồm bản RFC (Request for Comments) trong kho lưu trữ Agent Skills và dự án skills-npm. Tác giả gọi mô hình này là “Dependency-bound Agent Skills” — tạm dịch là “Agent Skills gắn liền với dependency”.