Hướng dẫn tạo skill nhanh dành cho người mới

Trong hướng dẫn này, bạn sẽ học cách tạo một skill cho phép agent chọn ngẫu nhiên bằng cách sử dụng bộ tạo số ngẫu nhiên.

Hãy tạo Agent Skill đầu tiên của bạn và xem nó hoạt động như thế nào trong VS Code!

Điều kiện tiên quyết

• VS Code và GitHub Copilot

​Tạo skill

Skill là một thư mục chứa file SKILL.md. VS Code mặc định tìm kiếm các skill trong .agents/skills/. Tạo file .agents/skills/roll-dice/SKILL.md trong dự án của bạn:

---
name: roll-dice
description: Tung xúc xắc bằng trình tạo số ngẫu nhiên. Sử dụng khi được yêu cầu chọn ngẫu nhiên (d6, d20, v.v...), tung xúc xắc hoặc tạo kết quả tung xúc xắc ngẫu nhiên.
---

Để tung xúc xắc, hãy sử dụng lệnh sau để tạo ra một số ngẫu nhiên từ 1
đến số mặt đã cho:

```bash
echo $((RANDOM % <sides> + 1))
```

```powershell
Get-Random -Minimum 1 -Maximum (<sides> + 1)
```

Thay thế `<sides>` bằng số mặt của xúc xắc (ví dụ: 6 cho xúc xắc tiêu chuẩn, 20 cho xúc xắc 20 mặt).

Vậy là xong - một file, dưới 20 dòng. Đây là chức năng của từng phần:

• name - Một định danh ngắn gọn cho skill. Phải trùng khớp với tên thư mục.
• description - Cho biết khi nào nên sử dụng skill này. Đây là cách agent quyết định có kích hoạt nó hay không.
• Phần thân - Hướng dẫn mà agent sẽ tuân theo khi skill được kích hoạt. Ở đây, agent được hướng dẫn tạo một số ngẫu nhiên bằng lệnh terminal, thay thế số mặt từ yêu cầu của người dùng.

Cách thực hiện

1. Mở dự án của bạn trong VS Code.
2. Mở bảng Copilot Chat.
3. Chọn chế độ Agent từ menu drop-down chế độ ở cuối bảng trò chuyện.
4. Gõ /skills để xác nhận rằng roll-dice xuất hiện trong danh sách. Nếu không, hãy kiểm tra xem file có nằm ở .agents/skills/roll-dice/SKILL.md so với thư mục gốc của dự án hay không.
5. Yêu cầu: "Roll a d20" (Lăn xúc xắc 20 mặt)

Agent sẽ kích hoạt skill roll-dice. Nó có thể yêu cầu quyền chạy lệnh terminal - hãy cho phép. Nó sẽ chạy lệnh và trả về một số ngẫu nhiên từ 1 đến 20.

Cách thức hoạt động

Đây là những gì đã xảy ra ở hậu trường:

1. Khám phá - Khi phiên trò chuyện bắt đầu, agent đã quét các thư mục skill mặc định và tìm thấy skill của bạn. Nó chỉ đọc tên và mô tả, vừa đủ để biết khi nào skill đó có thể liên quan.
2. Kích hoạt - Khi bạn hỏi về việc tung xúc xắc, agent đã khớp yêu cầu của bạn với mô tả của skill và load toàn bộ nội dung SKILL.md vào ngữ cảnh.
3. Thực thi - Agent đã làm theo các hướng dẫn trong nội dung, điều chỉnh lệnh terminal cho phù hợp với số mặt trong yêu cầu của bạn.

Quá trình này sử dụng tiết lộ dần dần để cho phép agent truy cập nhiều skill mà không cần load tất cả các hướng dẫn của chúng ngay từ đầu.