ทักษะคืออะไร
ทักษะคือโฟลเดอร์ที่มีชื่อตรงกับ name ของทักษะ โฟลเดอร์มีไฟล์ SKILL.md และจะมีไฟล์อื่นที่คำแนะนำอ้างถึงด้วยก็ได้ เช่น เอกสารอ้างอิง เทมเพลต หรือสคริปต์
SKILL.md มีสองส่วน ส่วนหน้า YAML ระหว่างบรรทัด --- มีชื่อและคำอธิบาย ส่วนเนื้อหา Markdown ที่ตามมามีคำแนะนำ
พนักงานใช้ทักษะอย่างไร
พนักงานทำงานกับทักษะในสามขั้นตอน
- เลือก ในแต่ละรอบ พนักงานจะเห็นรายการทักษะที่ใช้ได้ ได้แก่ ชื่อ คำอธิบาย และทริกเกอร์ไม่เกินสามรายการของแต่ละทักษะ คำอธิบายคือสิ่งที่พนักงานอ่านเพื่อตัดสินใจ จึงควรเขียนให้บอกว่าทักษะทำอะไรและควรใช้เมื่อใด
- โหลด พนักงานเรียกเครื่องมือ
use_skillพร้อมชื่อทักษะ เครื่องมือจะส่งคำแนะนำ พาธของโฟลเดอร์ทักษะ และชื่อไฟล์ต่าง ๆ กลับมา นี่คือวิธีเดียวที่พนักงานอ่านทักษะ - ทำงาน พนักงานทำตามคำแนะนำ อ่านไฟล์ประกอบด้วย
read_skill_fileและเรียกใช้สคริปต์ที่รวมมาด้วยexecute
ทริกเกอร์ไม่เคยโหลดทักษะได้เอง พนักงานเป็นผู้เลือกเสมอ เมื่อรายการยาวขึ้น พนักงานค้นหาในรายการได้ด้วย find_skills
เขียนทักษะแรกของคุณ
สร้างโฟลเดอร์ที่ตั้งชื่อตามทักษะ โดยมีไฟล์หนึ่งไฟล์อยู่ข้างใน
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".
วางโฟลเดอร์ไว้ในไดเรกทอรีทักษะของผู้ใช้บนบอท (ดูที่ ทักษะอยู่ที่ไหน) Nebo จะเห็นโฟลเดอร์ใหม่ภายในประมาณหนึ่งวินาที และพนักงานทุกคนบนบอทนั้นจะใช้ทักษะได้
พนักงานเขียนทักษะให้คุณได้ด้วย ขอให้พนักงานบันทึกทักษะ แล้วพนักงานจะเรียก save_skill ซึ่งเขียนโฟลเดอร์ลงในไดเรกทอรีทักษะของผู้ใช้เดียวกันนั้น
กฎที่ตัวโหลดบังคับใช้
ทักษะที่ละเมิดกฎข้อใดข้อหนึ่งเหล่านี้จะไม่ถูกโหลด Nebo จะบันทึกคำเตือนและข้ามทักษะนั้นไป
| กฎ | รายละเอียด |
|---|---|
ไฟล์ขึ้นต้นด้วย --- | ส่วนหน้าต้องอยู่เป็นสิ่งแรกในไฟล์ และไฟล์ต้องเป็น UTF-8 |
name เป็นฟิลด์ที่จำเป็น | ตัวอักษรพิมพ์เล็ก ตัวเลข และขีดกลางเท่านั้น ห้ามขึ้นต้นหรือลงท้ายด้วยขีดกลาง ห้ามมีขีดกลางซ้อนกัน ไม่เกิน 64 ไบต์ |
description เป็นฟิลด์ที่จำเป็น | ไม่เกิน 1,024 ไบต์ |
| ฟิลด์มีชนิดถูกต้อง | ฟิลด์ที่มีชนิด YAML ผิดจะทำให้ทั้งไฟล์ล้มเหลว ให้ใส่เครื่องหมายคำพูดรอบเวอร์ชัน เช่น "1.0.0" |
platform ตรงกัน | หากมีฟิลด์นี้ ทักษะจะโหลดเฉพาะบนระบบปฏิบัติการที่ระบุไว้ |
คีย์ในส่วนหน้าที่ Nebo ไม่รู้จักจะถูกละเว้น เนื้อหาไม่มีการจำกัดขนาด แต่คำแนะนำที่สั้นกว่าจะเหลือพื้นที่ให้งานมากกว่า ย้ายเนื้อหายาว ๆ ไปไว้ในไฟล์ที่พนักงานอ่านเมื่อจำเป็น
เพิ่มไฟล์
ไฟล์ใดก็ได้ในโฟลเดอร์ ยกเว้น SKILL.md และไฟล์ที่ขึ้นต้นด้วยจุด จะพร้อมให้พนักงานใช้ คุณตั้งชื่อโฟลเดอร์ได้เอง Nebo ไม่ได้ให้ความหมายพิเศษกับ references/ หรือ assets/ ไฟล์ใน scripts/ หรือ bin/ เรียกใช้ได้
invoice-check/
├── SKILL.md # required
├── references/
│ └── policy.md # read with read_skill_file
└── scripts/
└── totals.py # run with execute อ้างถึงไฟล์ด้วยพาธภายในโฟลเดอร์ เช่น references/policy.md พนักงานอ่านไฟล์ด้วย read_skill_file ซึ่งจะปฏิเสธพาธที่ออกนอกโฟลเดอร์ สคริปต์ทำงานด้วยเครื่องมือ execute ในแซนด์บ็อกซ์ ข้อมูลอ้างอิง SKILL.md อธิบายรันไทม์ ตัวแปรสภาพแวดล้อม ข้อมูลลับ และการเข้าถึงเครือข่าย
ทักษะอยู่ที่ไหน
บอทรวบรวมทักษะจากหลายแหล่ง เมื่อสองแหล่งมีทักษะชื่อเดียวกัน แหล่งที่อยู่ถัดลงไปในรายการนี้จะมีผลเหนือกว่า
| แหล่งที่มา | ตำแหน่ง | ใครใช้ได้ |
|---|---|---|
| มีในตัว | คอมไพล์รวมอยู่ใน Nebo | พนักงานทุกคน |
| มาร์เก็ตเพลส | <data>/nebo/skills/<slug>/<version>/ | พนักงานทุกคน |
| ปลั๊กอิน | โฟลเดอร์ skills/ ของปลั๊กอินที่ติดตั้งไว้ | พนักงานทุกคน |
| ผู้ใช้ | <data>/user/skills/<name>/ | พนักงานทุกคน |
| แพ็กเกจพนักงาน | skills/ ภายในแพ็กเกจพนักงานที่ติดตั้งไว้ | เฉพาะพนักงานคนนั้น |
| เรียนรู้เอง | <data>/learned/skills/<employee>/<name>/ | เฉพาะพนักงานคนนั้น |
<data> คือ ~/Library/Application Support/Nebo บน macOS, %APPDATA%\Nebo บน Windows และ ~/.local/share/nebo บน Linux ตัวแปรสภาพแวดล้อม NEBO_HOME ใช้แทนค่านี้ได้ เมื่อพนักงานมีทักษะของตัวเองและทักษะที่ใช้ร่วมกันซึ่งมีชื่อเดียวกัน ทักษะของตัวเองจะมีผลเหนือกว่า
Nebo เฝ้าดูโฟลเดอร์เหล่านี้และโหลดทักษะที่เปลี่ยนแปลงใหม่หลังจากหนึ่งวินาที หากต้องการปิดทักษะโดยไม่ลบ ให้เปลี่ยนชื่อไฟล์เป็น SKILL.md.disabled
ทักษะอธิบายงาน ไม่ใช่เครื่องมือ เขียนทักษะโดยยึดหน้าที่ความรับผิดชอบ เช่น การกระทบยอดใบเสร็จ แล้วให้พนักงานใช้การเชื่อมต่อใดก็ได้ที่เจ้าของจัดไว้ให้ เมื่อทักษะจำเป็นต้องใช้ปลั๊กอินจริง ๆ ให้ประกาศด้วยฟิลด์ plugins
ถัดไป
- ข้อมูลอ้างอิง SKILL.md ทุกฟิลด์ เครื่องมือ และตัวแปร
- ตัวอย่าง ทักษะสมบูรณ์ที่คัดลอกไปใช้ได้
- การเผยแพร่ นำทักษะขึ้นมาร์เก็ตเพลส