Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

AI Agent Skills

Skill đóng gói kiến thức và quy trình cho một loại công việc để AI Agent có thể dùng lại. Một skill gồm SKILL.md, có thể kèm script, tài liệu và mẫu đầu ra. Cơ chế nạp từng phần giúp agent đọc hướng dẫn chi tiết khi cần. Xem tổng quan Agent Skills.

Ví dụ, yêu cầu “điều tra truy vấn chậm” cần quy trình thu thập bằng chứng, đọc execution plan và kiểm tra sau sửa. Skill giúp giữ quy trình đó nhất quán qua nhiều lần làm việc.

Bắt đầu

Phân biệt các thành phần

Thành phầnVai tròVí dụ
PromptGiao việc cụ thể trong lượt hiện tạiĐiều tra lỗi timeout của API này
SkillQuy trình và kiến thức dùng lại theo loại việcTái hiện lỗi, tìm nguyên nhân, kiểm regression
Quy tắc dự ánRàng buộc áp dụng trong dự ánKhông sửa dữ liệu thật khi chạy test
Tool / MCPKhả năng thực thi hoặc truy cập dữ liệuĐọc file, chạy test, truy vấn tài liệu
HarnessMôi trường điều phối và kiểm soát agentGiới hạn quyền, lưu tiến độ, kiểm điều kiện hoàn tất

Skill mô tả cách làm; quyền thực thi do môi trường cấp. Một hướng dẫn yêu cầu upload dữ liệu không tự tạo quyền upload. Tương tự, cài skill không tự cài database, toolchain hay MCP server mà skill cần.

Chọn skill từ vấn đề

  • Chưa rõ mục tiêu: làm rõ kết quả mong muốn và giới hạn trước.
  • Có lỗi tái hiện được: dùng quy trình chẩn đoán, sau đó chọn chuyên môn phù hợp.
  • Xây chức năng mới: xác định đầu vào, đầu ra và tiêu chí kiểm; dùng skill phát triển theo stack.
  • Công việc qua nhiều phiên: thêm lưu tiến độ và bằng chứng kiểm chứng.
  • Đã có kết quả: review diff, chạy kiểm tra và đối chiếu với yêu cầu ban đầu.

Ví dụ, với PostgreSQL: “truy vấn chạy 8 giây” → chẩn đoán → chuyên môn PostgreSQL → kiểm lại plan và thời gian trong cùng điều kiện. Chưa có số đo thì chưa thể kết luận đã tối ưu.

Phạm vi danh mục

Danh mục là bản chưng cất năng lực và kinh nghiệm sử dụng, không phải gói skill để tải/cài. Tên giữ dạng slug để dễ tra cứu; các quy trình phụ thuộc hạ tầng riêng cần được điều chỉnh trước khi áp dụng vào dự án khác. Nội dung chỉ chọn các skill có thể chia sẻ tổng quát; skill gắn hồ sơ cá nhân hoặc dự án có thương hiệu riêng nằm ngoài phạm vi này.

Nguồn chuẩn về định dạng: Agent Skills specification, với metadata bắt buộc name và description. Cách khám phá, cài đặt và gọi skill cần đối chiếu tài liệu của ứng dụng agent đang dùng.