รูปแบบไฟล์
SKILL.md เป็นข้อความ UTF-8 ขึ้นต้นด้วยบรรทัดขีดกลางสามตัว ตามด้วยส่วนหน้า YAML แล้วปิดด้วยบรรทัดขีดกลางสามตัว ทุกอย่างหลังจากนั้นคือเนื้อหา ซึ่งเป็นคำแนะนำ Markdown ที่พนักงานได้รับเมื่อโหลดทักษะ Nebo ค้นหาไฟล์ตามชื่อโดยไม่สนใจตัวพิมพ์เล็กหรือใหญ่
---
name: expense-review
description: Check submitted expenses against the company policy and flag anything that needs a receipt or an approval. Use when someone asks to review expenses or a reimbursement request.
version: "1.2.0"
author: Example Co
license: MIT
tags: [finance, expenses]
triggers: [reimbursement, expense report]
platform: [macos, linux, windows]
capabilities: [network]
metadata:
allowed_domains: [api.example.com]
secrets:
- key: EXAMPLE_API_KEY
label: Example API key
hint: Create one at https://example.com/settings/keys
required: true
requires:
- name: receipt-capture
version: ">=1.0.0"
plugins:
- name: example-ledger
version: ">=2.0.0"
optional: true
---
# Expense review
Follow the policy in references/policy.md ... ฟิลด์ในส่วนหน้า
มีเพียง name และ description ที่จำเป็น ฟิลด์ที่มีชนิดผิดจะทำให้ทั้งไฟล์ล้มเหลว ทักษะจึงไม่ถูกโหลด คีย์ที่ไม่ได้ระบุไว้ที่นี่จะถูกละเว้น
| ฟิลด์ | ชนิด | ค่าเริ่มต้น | ความหมาย |
|---|---|---|---|
name | string | จำเป็น | ตัวระบุ [a-z0-9-] ห้ามขึ้นต้นหรือลงท้ายด้วยขีดกลาง ห้ามมีขีดกลางซ้อนกัน ไม่เกิน 64 ไบต์ ให้ตรงกับชื่อโฟลเดอร์ |
description | string | จำเป็น | ทักษะทำอะไรและควรใช้เมื่อใด ไม่เกิน 1,024 ไบต์ แสดงในรายการทักษะของพนักงานและใช้ให้คะแนนโดย find_skills |
version | string | "1.0.0" | เวอร์ชันแบบ Semantic ตรวจสอบด้วยช่วง requires ของทักษะอื่น ให้ใส่เครื่องหมายคำพูดไว้ |
triggers | รายการของสตริง | [] | คำและวลีที่อธิบายว่าทักษะใช้ได้เมื่อใด แสดงได้ไม่เกินสามรายการในรายการทักษะ และทุกรายการนับใน find_skills คำเหล่านี้ไม่เคยโหลดทักษะได้เอง |
platform | รายการของสตริง | ทั้งหมด | macos, linux, windows ทักษะจะโหลดเฉพาะที่ที่ตรงกับค่าใดค่าหนึ่ง |
capabilities | รายการของสตริง | [] | network และ storage ขยายขอบเขตแซนด์บ็อกซ์ของสคริปต์ ดูที่แซนด์บ็อกซ์ของสคริปต์ |
metadata | map | {} | เก็บ secrets และ allowed_domains ดูด้านล่าง |
requires | รายการของ {name, version} | [] | ทักษะอื่นที่ทักษะนี้ต่อยอด name คือชื่อสั้นของทักษะ version คือช่วง semver ค่าเริ่มต้นคือ "*" |
plugins | รายการของ {name, version, optional} | [] | ปลั๊กอินที่ทักษะนี้ใช้ version มีค่าเริ่มต้นเป็น "*" และ optional มีค่าเริ่มต้นเป็น false |
dependencies | รายการของสตริง | [] | ชื่อสั้นของทักษะที่ต้องมีอยู่ |
priority | integer | 0 | ใช้เรียงลำดับทักษะในรายการจัดการ ไม่มีผลต่อการที่พนักงานเลือกทักษะใด |
author | string | "" | จัดเก็บไว้เพื่อแสดงผล |
license | string | "" | จัดเก็บไว้เพื่อแสดงผล |
compatibility | string | "" | บันทึกข้อความอิสระ ไม่เกิน 500 ไบต์ |
tags | รายการของสตริง | [] | จัดเก็บไว้เพื่อแสดงผล |
allowed-tools | string | "" | สตริงที่คั่นด้วยช่องว่าง จัดเก็บไว้แต่ไม่มีการบังคับใช้ |
เมื่อทักษะที่ระบุใน requires หรือ dependencies ขาดหายไปหรืออยู่นอกช่วง หรือไม่ได้ติดตั้งปลั๊กอินที่จำเป็น ทักษะจะยังโหลดได้และถูกทำเครื่องหมายว่าทำงานไม่เต็มที่ เจ้าของจะเห็นว่าขาดอะไร
ข้อมูลลับ
ประกาศข้อมูลรับรองที่สคริปต์ของทักษะต้องใช้ไว้ใน metadata.secrets เจ้าของเป็นผู้ให้ค่า และ Nebo จัดเก็บค่าเหล่านั้นแบบเข้ารหัสไว้สำหรับทักษะนั้น
metadata:
secrets:
- key: EXAMPLE_API_KEY
label: Example API key
hint: Create one at https://example.com/settings/keys
required: true | คีย์ | ความหมาย |
|---|---|
key | ชื่อตัวแปรสภาพแวดล้อมที่สคริปต์ได้รับ จำเป็น |
label | ชื่อที่แสดงให้เจ้าของเห็น |
hint | แหล่งที่ได้มาซึ่งค่า |
required | เมื่อเป็น true execute จะไม่ยอมเรียกใช้สคริปต์ของทักษะจนกว่าจะตั้งค่า ค่าเริ่มต้นคือ false |
พนักงานตั้งค่าได้ด้วย configure_skill คุณอ้างอิงความลับในเนื้อหาได้เป็น ${secret.KEY} แต่สคริปต์ควรอ่านจากตัวแปรสภาพแวดล้อมแทน
ตัวแปรเทมเพลต
Nebo แทนที่ตัวแปรเหล่านี้ในเนื้อหาเมื่อพนักงานโหลดทักษะ ตัวแปรจะไม่ถูกแทนที่ภายในไฟล์อื่น สคริปต์อ่านตัวแปรสภาพแวดล้อมแทน
| ตัวแปร | ค่า |
|---|---|
${NEBO_SKILL_DIR} | พาธสัมบูรณ์ของโฟลเดอร์ทักษะ |
${NEBO_DATA_DIR} | โฟลเดอร์ที่เขียนได้สำหรับทักษะนี้ <data>/appdata/skills/<name> สร้างขึ้นเมื่อใช้งานครั้งแรก |
${NEBO_USER_NAME} | ชื่อของเจ้าของ |
${NEBO_OS} | ระบบปฏิบัติการ |
${NEBO_ARCH} | สถาปัตยกรรมของหน่วยประมวลผล |
${plugin.SLUG_BIN} | พาธของไบนารีของปลั๊กอินที่ประกาศไว้ slug จะเป็นตัวพิมพ์ใหญ่และเปลี่ยนขีดกลางเป็นขีดล่าง เช่น example-ledger จะกลายเป็น ${plugin.EXAMPLE_LEDGER_BIN} |
${secret.KEY} | ค่าของข้อมูลลับที่ประกาศไว้ |
$ARGUMENTS | args ที่ส่งให้ use_skill เมื่อเนื้อหาไม่มี $ARGUMENTS อาร์กิวเมนต์จะถูกต่อท้ายเนื้อหา |
เครื่องมือทักษะ
พนักงานทำงานกับทักษะผ่านเครื่องมือเหล่านี้ use_skill พร้อมใช้งานเสมอ ส่วนเครื่องมืออื่นจะโหลดเมื่อพนักงานต้องการ
| เครื่องมือ | พารามิเตอร์ | หน้าที่ |
|---|---|---|
use_skill | name, args | โหลดทักษะ ส่งคืนเนื้อหาที่ขยายแล้ว พาธโฟลเดอร์ และชื่อไฟล์ 20 ไฟล์แรก และเปิดใช้งานทักษะที่ปิดไว้อีกครั้ง |
find_skills | query | ส่งคืนทักษะได้สูงสุด 10 รายการ เรียงตามความตรงกันของชื่อ ทริกเกอร์ และคำอธิบาย |
read_skill_file | name, path | อ่านไฟล์ในโฟลเดอร์ของทักษะ หากไม่มี path จะแสดงรายการไฟล์และขนาด |
save_skill | name, content | เขียน SKILL.md ฉบับสมบูรณ์ลงในโฟลเดอร์ทักษะของผู้ใช้ ทักษะจากมาร์เก็ตเพลสไม่สามารถเขียนทับได้ |
delete_skill | name | ลบทักษะของผู้ใช้ |
install_skill | code | ติดตั้งทักษะจากมาร์เก็ตเพลสด้วยรหัสติดตั้ง SKIL- |
configure_skill | name, key, value | ตั้งค่าข้อมูลลับ หากไม่มี key จะแสดงสิ่งที่ทักษะต้องการ |
rate_skill | name, rating, review | ให้คะแนนทักษะในมาร์เก็ตเพลสตั้งแต่ 1 ถึง 5 |
read_skill_reviews | name | อ่านรีวิวของทักษะในมาร์เก็ตเพลส |
execute | skill, script, args, timeout | เรียกใช้สคริปต์จากโฟลเดอร์ของทักษะ ดูที่แซนด์บ็อกซ์ของสคริปต์ |
แซนด์บ็อกซ์ของสคริปต์
เครื่องมือ execute เรียกใช้สคริปต์หนึ่งไฟล์จากโฟลเดอร์ของทักษะ โดยเลือกรันไทม์ตามไฟล์
| สคริปต์ | รันไทม์ |
|---|---|
.py | Python ผ่าน uv ที่รวมมากับ Nebo หากมี มิฉะนั้นใช้ python3 |
.ts, .js | Bun ที่รวมมากับ Nebo หากมี มิฉะนั้นใช้ node |
bin/<file> หรือ binary | เรียกใช้โดยตรง |
.sh | ไม่รองรับ |
การเรียกใช้แต่ละครั้งเริ่มต้นด้วยสภาพแวดล้อมว่างเปล่าและตัวแปรเหล่านี้
| ตัวแปร | ค่า |
|---|---|
SKILL_ARGS | ออบเจกต์ args ในรูปแบบ JSON |
key ของข้อมูลลับแต่ละรายการ | ค่าข้อมูลลับที่ถอดรหัสแล้ว |
<PLUGIN>_BIN | พาธของไบนารีของปลั๊กอินแต่ละตัวที่ประกาศไว้ โฟลเดอร์ปลั๊กอินจะถูกเพิ่มลงใน PATH ด้วย |
import json, os
args = json.loads(os.environ.get("SKILL_ARGS", "{}"))
api_key = os.environ["EXAMPLE_API_KEY"]
print(json.dumps({"checked": len(args.get("items", []))})) สคริปต์ทำงานในสำเนาชั่วคราวของโฟลเดอร์ทักษะ โดยมีเวลาหมดเวลาเริ่มต้น 30 วินาที บน macOS และ Linux สคริปต์ทำงานในแซนด์บ็อกซ์ของระบบปฏิบัติการ
- สคริปต์อ่านที่เก็บข้อมูลรับรอง ข้อมูลเบราว์เซอร์และพวงกุญแจ หรือการตั้งค่าและฐานข้อมูลของ Nebo เองไม่ได้
- สคริปต์เขียนได้เฉพาะในโฟลเดอร์ทำงานของตัวเองและ
/tmp/neboความสามารถstorageจะเพิ่มโฟลเดอร์ข้อมูลของ Nebo - สคริปต์ไม่มีการเข้าถึงเครือข่าย ความสามารถ
networkจะอนุญาตรีจิสทรีของแพ็กเกจและโดเมนที่ระบุในmetadata.allowed_domains
ไฟล์และขีดจำกัด
| รายการ | กฎ |
|---|---|
| ทรัพยากร | ทุกไฟล์ยกเว้น SKILL.md, manifest.json, signatures.json และไฟล์ที่ขึ้นต้นด้วยจุด |
| โปรแกรมที่เรียกใช้ได้ | ไฟล์ใน scripts/ หรือ bin/ และไฟล์ที่ระดับรากชื่อ binary |
| พาธ | อิงจากโฟลเดอร์ทักษะ พาธที่มี .. หรือที่ออกนอกโฟลเดอร์จะถูกปฏิเสธ |
| ทักษะที่ปิดไว้ | โฟลเดอร์ที่มี SKILL.md.disabled แทน SKILL.md |
| รายการทักษะ | แต่ละรายการจะถูกตัดที่ 250 อักขระ เมื่อทั้งรายการยาวเกิน 8,000 อักขระ ทักษะที่ใช้ร่วมกันจะถูกย่อก่อน ส่วนทักษะของพนักงานเองจะคงรายการไว้เต็ม |
ขีดจำกัดของไฟล์ที่คุณเผยแพร่ขึ้นมาร์เก็ตเพลสอยู่ในหน้า การเผยแพร่