Kỹ năng là gì
Kỹ năng là một thư mục có tên trùng với name của kỹ năng. Thư mục chứa một tệp SKILL.md và, nếu cần, bất kỳ tệp nào khác mà chỉ dẫn nhắc tới: tài liệu tham khảo, mẫu hoặc script.
SKILL.md có hai phần. Phần frontmatter YAML nằm giữa các dòng --- chứa tên và mô tả. Phần thân Markdown phía sau chứa các chỉ dẫn.
Cách nhân viên dùng kỹ năng
Nhân viên làm việc với một kỹ năng qua ba bước.
- Chọn. Ở mỗi lượt, nhân viên thấy danh sách các kỹ năng có sẵn cho mình: tên, mô tả và tối đa ba trình kích hoạt của mỗi kỹ năng. Mô tả là thứ nhân viên đọc để quyết định, nên hãy viết nó để nói kỹ năng làm gì và khi nào nên dùng.
- Nạp. Nhân viên gọi công cụ
use_skillvới tên kỹ năng. Công cụ trả về các chỉ dẫn, đường dẫn tới thư mục của kỹ năng và tên các tệp của nó. Đây là cách duy nhất để nhân viên đọc một kỹ năng. - Làm việc. Nhân viên làm theo các chỉ dẫn. Nhân viên đọc các tệp hỗ trợ bằng
read_skill_filevà chạy các script đi kèm bằngexecute.
Trình kích hoạt không bao giờ tự nạp một kỹ năng. Nhân viên luôn là người quyết định. Khi danh sách dài ra, nhân viên có thể tìm kiếm trong đó bằng find_skills.
Viết kỹ năng đầu tiên của bạn
Tạo một thư mục đặt tên theo kỹ năng, chứa một tệp.
meeting-notes/ └── SKILL.md
--- name: meeting-notes description: Turn a meeting transcript into decisions, action items with owners, and open questions. Use when someone shares meeting notes or a transcript. --- # Meeting notes 1. List the decisions that were made. 2. List action items as "owner — task — due date". 3. List open questions that need a follow-up. Keep each list short. If the transcript names no owner for an item, write "unassigned".
Đặt thư mục vào thư mục kỹ năng của người dùng trên một bot (xem Nơi lưu kỹ năng). Nebo nhận ra thư mục mới trong khoảng một giây, và mọi nhân viên trên bot đó đều có thể dùng kỹ năng.
Nhân viên cũng có thể viết kỹ năng giúp bạn. Hãy yêu cầu nhân viên lưu một kỹ năng, nhân viên sẽ gọi save_skill để ghi thư mục vào chính thư mục kỹ năng của người dùng đó.
Các quy tắc trình nạp áp dụng
Kỹ năng vi phạm một trong các quy tắc này sẽ không được nạp. Nebo ghi cảnh báo vào nhật ký và bỏ qua nó.
| Quy tắc | Chi tiết |
|---|---|
Tệp bắt đầu bằng --- | Frontmatter phải là phần đầu tiên của tệp. Tệp phải được mã hóa UTF-8. |
name là bắt buộc | Chỉ gồm chữ thường, chữ số và dấu gạch nối; không có dấu gạch nối ở đầu hoặc cuối; không có hai dấu gạch nối liền nhau; tối đa 64 byte. |
description là bắt buộc | Tối đa 1.024 byte. |
| Các trường đúng kiểu | Một trường sai kiểu YAML sẽ làm hỏng toàn bộ tệp. Đặt phiên bản trong dấu ngoặc kép, chẳng hạn "1.0.0". |
platform khớp | Nếu có, kỹ năng chỉ được nạp trên các hệ điều hành được liệt kê. |
Các khóa frontmatter mà Nebo không nhận diện được sẽ bị bỏ qua. Phần thân không giới hạn kích thước, nhưng chỉ dẫn càng ngắn thì càng chừa nhiều chỗ cho công việc. Hãy chuyển tài liệu dài vào các tệp mà nhân viên đọc khi cần.
Thêm tệp
Mọi tệp trong thư mục ngoài SKILL.md và các tệp ẩn đều có sẵn cho nhân viên. Bạn tự chọn tên thư mục; Nebo không gán ý nghĩa đặc biệt nào cho references/ hay assets/. Các tệp trong scripts/ hoặc bin/ có thể được chạy.
invoice-check/
├── SKILL.md # required
├── references/
│ └── policy.md # read with read_skill_file
└── scripts/
└── totals.py # run with execute Nhắc tới tệp bằng đường dẫn bên trong thư mục, chẳng hạn references/policy.md. Nhân viên đọc chúng bằng read_skill_file, công cụ này từ chối mọi đường dẫn đi ra ngoài thư mục. Script chạy bằng công cụ execute trong môi trường hộp cát. Tài liệu tham khảo SKILL.md trình bày về môi trường chạy, biến môi trường, thông tin bí mật và quyền truy cập mạng.
Nơi lưu kỹ năng
Một bot thu thập kỹ năng từ nhiều nơi. Khi hai nguồn cung cấp kỹ năng cùng tên, nguồn đứng sau trong danh sách này được ưu tiên.
| Nguồn | Vị trí | Ai có thể dùng |
|---|---|---|
| Tích hợp sẵn | Được biên dịch sẵn trong Nebo | Mọi nhân viên |
| Chợ ứng dụng | <data>/nebo/skills/<slug>/<version>/ | Mọi nhân viên |
| Plugin | Thư mục skills/ của một plugin đã cài | Mọi nhân viên |
| Người dùng | <data>/user/skills/<name>/ | Mọi nhân viên |
| Gói nhân viên | skills/ bên trong một gói nhân viên đã cài | Chỉ nhân viên đó |
| Đã học | <data>/learned/skills/<employee>/<name>/ | Chỉ nhân viên đó |
<data> là ~/Library/Application Support/Nebo trên macOS, %APPDATA%\Nebo trên Windows và ~/.local/share/nebo trên Linux. Biến môi trường NEBO_HOME sẽ ghi đè giá trị này. Khi một nhân viên có kỹ năng riêng và một kỹ năng dùng chung trùng tên, kỹ năng riêng được ưu tiên.
Nebo theo dõi các thư mục này và nạp lại kỹ năng đã thay đổi sau một giây. Để tắt một kỹ năng mà không xóa, hãy đổi tên tệp của nó thành SKILL.md.disabled.
Kỹ năng mô tả công việc, không phải công cụ. Hãy viết kỹ năng xoay quanh một trách nhiệm, chẳng hạn đối chiếu biên lai, và để nhân viên dùng bất kỳ kết nối nào chủ sở hữu đã cung cấp. Khi một kỹ năng thực sự cần một plugin, hãy khai báo nó bằng trường plugins.
Tiếp theo
- Tài liệu tham khảo SKILL.md: mọi trường, công cụ và biến.
- Ví dụ: các kỹ năng hoàn chỉnh để sao chép.
- Phát hành: đưa kỹ năng lên chợ ứng dụng.