Chương 1 của tài liệu có tiêu đề "Fundamentals" (Nguyên tắc cơ bản), tập trung giải thích cấu trúc định dạng của một skill, các nguyên tắc thiết kế nền tảng và cách skill kết hợp với giao thức MCP để tạo ra các quy trình làm việc hiệu quả. Dưới đây là các nội dung chi tiết:
1. Cấu trúc của một Skill (What is a skill?) Skill thực chất là một thư mục được đóng gói, bao gồm các thành phần sau:
SKILL.md (Bắt buộc): Tệp chính chứa các hướng dẫn cho AI được viết bằng Markdown, đi kèm với phần cấu hình YAML (YAML frontmatter).
scripts/ (Tùy chọn): Thư mục chứa các đoạn mã có thể thực thi được như Python, Bash.
references/ (Tùy chọn): Chứa các tài liệu hướng dẫn sẽ được AI tải lên và đọc khi cần thiết.
assets/ (Tùy chọn): Nơi lưu trữ các tài nguyên dùng cho đầu ra như biểu mẫu (templates), font chữ, hoặc biểu tượng (icons).
2. Các nguyên tắc thiết kế cốt lõi (Core design principles) Chương này đề ra 3 nguyên tắc quan trọng nhất khi xây dựng skill:
Tiết lộ lũy tiến (Progressive Disclosure): Đây là nguyên tắc quan trọng giúp tối ưu hóa việc sử dụng token mà vẫn duy trì được chuyên môn sâu của AI. Skill được chia làm hệ thống 3 cấp độ:
Cấp độ 1 (YAML frontmatter): Luôn được tải sẵn vào bộ nhớ (system prompt) của Claude. Nó cung cấp lượng thông tin ngắn gọn, vừa đủ để Claude nhận biết được khi nào thì nên kích hoạt skill này.
Cấp độ 2 (Nội dung của SKILL.md): Chỉ được tải đầy đủ khi Claude đánh giá rằng skill này thực sự liên quan đến yêu cầu của người dùng, chứa toàn bộ hướng dẫn định hướng.
Cấp độ 3 (Các tệp liên kết): Các tệp đính kèm trong thư mục skill mà Claude có thể chủ động tìm đến để đọc thêm thông tin chỉ khi nào thật sự cần.
Khả năng kết hợp (Composability): Claude có thể tải nhiều skill cùng lúc, do đó bạn nên thiết kế skill của mình để hoạt động tốt, hài hòa với các skill khác thay vì giả định nó là tính năng duy nhất có sẵn.
Tính di động (Portability): Skill được thiết kế để hoạt động nhất quán trên mọi nền tảng như Claude.ai, Claude Code và API. Bạn chỉ cần tạo ra nó một lần và nó có thể hoạt động ở bất cứ đâu mà không cần chỉnh sửa (miễn là môi trường đó có hỗ trợ các yêu cầu mà skill cần).
3. Tương tác giữa Skill và MCP (Dành cho nhà phát triển hệ thống) Nếu bạn đã xây dựng máy chủ MCP, skill chính là lớp "kiến thức" phủ lên trên, giúp đóng gói các quy trình làm việc tốt nhất để Claude áp dụng một cách nhất quán. Tài liệu sử dụng "ví dụ về nhà bếp" (The kitchen analogy) để làm rõ mối quan hệ này:
MCP (Đại diện cho sự kết nối): Giống như một nhà bếp chuyên nghiệp, cung cấp cho bạn quyền truy cập vào các công cụ, dữ liệu và thiết bị theo thời gian thực (như kết nối với Notion, Asana). Nó xác định những gì Claude có thể làm.
Skill (Đại diện cho kiến thức): Giống như các công thức nấu ăn, cung cấp hướng dẫn từng bước để tạo ra thành phẩm. Nó chỉ dạy cách Claude nên làm những công việc đó sao cho hiệu quả.
Tài liệu cũng chỉ ra lý do tại sao bộ đôi này lại quan trọng đối với người dùng:
Nếu không có skill: Người dùng dù kết nối được MCP nhưng lại không biết phải làm gì tiếp theo, dẫn đến việc họ phải gửi nhiều yêu cầu hỗ trợ. Kết quả đầu ra cũng không đồng nhất vì mỗi lần trò chuyện người dùng lại phải viết yêu cầu từ đầu.
Khi tích hợp skill: Các quy trình làm việc được thiết lập sẵn sẽ tự động kích hoạt khi cần, công cụ được sử dụng một cách nhất quán, đáng tin cậy và giúp người dùng nhanh chóng nắm bắt được cách sử dụng hệ thống tích hợp của bạn
Bình luận (0)
Đang tải bình luận...