Kỹ năng giúp bạn nâng cao khả năng của Chế độ dành cho nhân viên hỗ trợ bằng kiến thức chuyên môn và quy trình làm việc tuỳ chỉnh. Các chỉ số này dựa trên tiêu chuẩn mở Kỹ năng của nhân viên hỗ trợ.
Không giống như tệp AGENTS.md, kỹ năng thể hiện chuyên môn theo yêu cầu. Cấu trúc này cho phép Chế độ tác nhân duy trì một số lượng lớn các chức năng chuyên biệt (chẳng hạn như di chuyển giữa các phiên bản thư viện cụ thể hoặc điều chỉnh thành phần kết hợp cho phù hợp với nhiều kích thước màn hình) mà không làm lộn xộn cửa sổ ngữ cảnh tức thì của mô hình.
Mô hình sẽ tự động quyết định thời điểm sử dụng một kỹ năng dựa trên yêu cầu của bạn và nội dung mô tả của kỹ năng đó. Khi xác định được một kỹ năng phù hợp, mô hình sẽ tự động lấy toàn bộ hướng dẫn và tài nguyên cần thiết để hoàn thành nhiệm vụ.
Để kích hoạt một kỹ năng theo yêu cầu, hãy yêu cầu tác nhân thực hiện một tác vụ liên quan đến kỹ năng đó. Bạn cũng có thể nhập @ vào ô nhập dữ liệu để kích hoạt một kỹ năng cụ thể.
Lợi ích chính
- Chia sẻ kiến thức chuyên môn: Đóng gói các quy trình làm việc phức tạp (chẳng hạn như quy trình xem xét yêu cầu kéo của một nhóm cụ thể) vào một thư mục chuyên dụng mà mọi người đều có thể sử dụng.
- Quy trình có thể lặp lại: Đảm bảo các tác vụ phức tạp, nhiều bước được thực hiện nhất quán bằng cách cung cấp hướng dẫn tiêu chuẩn.
- Gói tài nguyên: Đưa tập lệnh, mẫu hoặc dữ liệu mẫu vào cùng với hướng dẫn để tác nhân có mọi thứ cần thiết ở cùng một nơi.
- Sử dụng hiệu quả cửa sổ ngữ cảnh: Để lưu mã thông báo ngữ cảnh, ban đầu chỉ tải siêu dữ liệu (tên và nội dung mô tả) của kỹ năng. Tệp
SKILL.mdđầy đủ chỉ được tải khi bạn kích hoạt. Các tệp hỗ trợ trong thư mụcreferences/,scripts/hoặcassets/chỉ tải vào ngữ cảnh khi tác nhân cần chúng một cách cụ thể.
Tạo kỹ năng của riêng bạn
Tác nhân sẽ tìm kiếm các kỹ năng bắt đầu từ thư mục .skills/ hoặc .agent/skills/ nằm ở gốc dự án của bạn. Để tạo một kỹ năng tuỳ chỉnh, hãy làm theo các bước sau:
- Tạo một thư mục cho kỹ năng của bạn (ví dụ:
my-new-skill/). - Tạo một tệp
SKILL.md(phân biệt chữ hoa chữ thường) bên trong thư mục mới.
Các kỹ năng phải tuân thủ những quy tắc sau:
- Mỗi kỹ năng có một thư mục: Mỗi kỹ năng phải có thư mục riêng biệt chứa tệp
SKILL.mdvà mọi tài nguyên bổ sung. - Lồng ghép: Tất cả các kỹ năng phải nằm trong thư mục
.skills/hoặc.agent/skills/ở gốc dự án. Tuy nhiên, bạn có thể sử dụng thư mục con để sắp xếp hiệu quả hơn (ví dụ:skills/ui-flows/<skill name>/SKILL.mdhoặcskills/testing/<skill name>/SKILL.md). - Phạm vi: Hiện tại, chỉ những kỹ năng nằm trong cơ sở mã của dự án mới được hỗ trợ.
Tệp SKILL.md sử dụng một khối YAML cho siêu dữ liệu và Markdown tiêu chuẩn cho hướng dẫn.
name: Giá trị nhận dạng duy nhất cho kỹ năng. Tên này phải khớp với tên thư mục.description: Giải thích rõ ràng về chức năng của kỹ năng và thời điểm mà tác nhân nên sử dụng kỹ năng đó.- Nội dung: Nội dung Markdown bên dưới khối YAML chứa các hướng dẫn định hướng hành vi của tác nhân khi kỹ năng đang hoạt động.
---
name: skill-name
description: A description of what this skill does and when to use it.
metadata:
author: example-org
version: "1.0"
---
Skill content
Nguyên tắc về định dạng
- Tên: Tối đa 64 ký tự (chỉ gồm chữ cái viết thường, số và dấu gạch ngang).
- Nội dung mô tả: Tối đa 1024 ký tự.
- Nội dung chính: Cố gắng viết từ 10.000 đến 20.000 ký tự (khoảng 2.500 đến 5.000 mã thông báo). Nếu hướng dẫn của bạn vượt quá giới hạn này, hãy cân nhắc việc di chuyển tài liệu chi tiết sang một tệp tài nguyên như mô tả trong phần Thư mục kỹ năng không bắt buộc.
Thư mục kỹ năng không bắt buộc
Để giữ cho tệp SKILL.md của bạn ngắn gọn và theo kiểu mô-đun, bạn có thể đưa các tài nguyên bổ sung vào các thư mục không bắt buộc sau đây trong thư mục của kỹ năng:
scripts/: Chứa mã thực thi (ví dụ: Python hoặc Bash) mà tác nhân có thể chạy.references/: Chứa tài liệu kỹ thuật chi tiết, tài liệu tham khảo về API hoặc hướng dẫn dành riêng cho từng miền.assets/: Chứa các tài nguyên tĩnh như mẫu tài liệu, sơ đồ giao diện người dùng hoặc giản đồ JSON.
Khi tham chiếu đến các tệp này trong hướng dẫn SKILL.md, hãy sử dụng đường dẫn tương đối từ thư mục gốc của kỹ năng. Ví dụ: Run the script at scripts/cleanup.py.