NeboAI
NeboAI
เริ่มต้นใช้งาน

ข้อมูลอ้างอิง SKILL.md

หน้านี้แสดงทุกส่วนของทักษะที่ Nebo อ่าน ได้แก่ ฟิลด์ในส่วนหน้า ตัวแปรที่ขยาย เครื่องมือที่พนักงานใช้ทำงานกับทักษะ และสภาพแวดล้อมที่สคริปต์ทำงาน

รูปแบบไฟล์

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 ที่จำเป็น ฟิลด์ที่มีชนิดผิดจะทำให้ทั้งไฟล์ล้มเหลว ทักษะจึงไม่ถูกโหลด คีย์ที่ไม่ได้ระบุไว้ที่นี่จะถูกละเว้น

ฟิลด์ชนิดค่าเริ่มต้นความหมาย
namestringจำเป็นตัวระบุ [a-z0-9-] ห้ามขึ้นต้นหรือลงท้ายด้วยขีดกลาง ห้ามมีขีดกลางซ้อนกัน ไม่เกิน 64 ไบต์ ให้ตรงกับชื่อโฟลเดอร์
descriptionstringจำเป็นทักษะทำอะไรและควรใช้เมื่อใด ไม่เกิน 1,024 ไบต์ แสดงในรายการทักษะของพนักงานและใช้ให้คะแนนโดย find_skills
versionstring"1.0.0"เวอร์ชันแบบ Semantic ตรวจสอบด้วยช่วง requires ของทักษะอื่น ให้ใส่เครื่องหมายคำพูดไว้
triggersรายการของสตริง[]คำและวลีที่อธิบายว่าทักษะใช้ได้เมื่อใด แสดงได้ไม่เกินสามรายการในรายการทักษะ และทุกรายการนับใน find_skills คำเหล่านี้ไม่เคยโหลดทักษะได้เอง
platformรายการของสตริงทั้งหมดmacos, linux, windows ทักษะจะโหลดเฉพาะที่ที่ตรงกับค่าใดค่าหนึ่ง
capabilitiesรายการของสตริง[]network และ storage ขยายขอบเขตแซนด์บ็อกซ์ของสคริปต์ ดูที่แซนด์บ็อกซ์ของสคริปต์
metadatamap{}เก็บ secrets และ allowed_domains ดูด้านล่าง
requiresรายการของ {name, version}[]ทักษะอื่นที่ทักษะนี้ต่อยอด name คือชื่อสั้นของทักษะ version คือช่วง semver ค่าเริ่มต้นคือ "*"
pluginsรายการของ {name, version, optional}[]ปลั๊กอินที่ทักษะนี้ใช้ version มีค่าเริ่มต้นเป็น "*" และ optional มีค่าเริ่มต้นเป็น false
dependenciesรายการของสตริง[]ชื่อสั้นของทักษะที่ต้องมีอยู่
priorityinteger0ใช้เรียงลำดับทักษะในรายการจัดการ ไม่มีผลต่อการที่พนักงานเลือกทักษะใด
authorstring""จัดเก็บไว้เพื่อแสดงผล
licensestring""จัดเก็บไว้เพื่อแสดงผล
compatibilitystring""บันทึกข้อความอิสระ ไม่เกิน 500 ไบต์
tagsรายการของสตริง[]จัดเก็บไว้เพื่อแสดงผล
allowed-toolsstring""สตริงที่คั่นด้วยช่องว่าง จัดเก็บไว้แต่ไม่มีการบังคับใช้

เมื่อทักษะที่ระบุใน 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}ค่าของข้อมูลลับที่ประกาศไว้
$ARGUMENTSargs ที่ส่งให้ use_skill เมื่อเนื้อหาไม่มี $ARGUMENTS อาร์กิวเมนต์จะถูกต่อท้ายเนื้อหา

เครื่องมือทักษะ

พนักงานทำงานกับทักษะผ่านเครื่องมือเหล่านี้ use_skill พร้อมใช้งานเสมอ ส่วนเครื่องมืออื่นจะโหลดเมื่อพนักงานต้องการ

เครื่องมือพารามิเตอร์หน้าที่
use_skillname, argsโหลดทักษะ ส่งคืนเนื้อหาที่ขยายแล้ว พาธโฟลเดอร์ และชื่อไฟล์ 20 ไฟล์แรก และเปิดใช้งานทักษะที่ปิดไว้อีกครั้ง
find_skillsqueryส่งคืนทักษะได้สูงสุด 10 รายการ เรียงตามความตรงกันของชื่อ ทริกเกอร์ และคำอธิบาย
read_skill_filename, pathอ่านไฟล์ในโฟลเดอร์ของทักษะ หากไม่มี path จะแสดงรายการไฟล์และขนาด
save_skillname, contentเขียน SKILL.md ฉบับสมบูรณ์ลงในโฟลเดอร์ทักษะของผู้ใช้ ทักษะจากมาร์เก็ตเพลสไม่สามารถเขียนทับได้
delete_skillnameลบทักษะของผู้ใช้
install_skillcodeติดตั้งทักษะจากมาร์เก็ตเพลสด้วยรหัสติดตั้ง SKIL-
configure_skillname, key, valueตั้งค่าข้อมูลลับ หากไม่มี key จะแสดงสิ่งที่ทักษะต้องการ
rate_skillname, rating, reviewให้คะแนนทักษะในมาร์เก็ตเพลสตั้งแต่ 1 ถึง 5
read_skill_reviewsnameอ่านรีวิวของทักษะในมาร์เก็ตเพลส
executeskill, script, args, timeoutเรียกใช้สคริปต์จากโฟลเดอร์ของทักษะ ดูที่แซนด์บ็อกซ์ของสคริปต์

แซนด์บ็อกซ์ของสคริปต์

เครื่องมือ execute เรียกใช้สคริปต์หนึ่งไฟล์จากโฟลเดอร์ของทักษะ โดยเลือกรันไทม์ตามไฟล์

สคริปต์รันไทม์
.pyPython ผ่าน uv ที่รวมมากับ Nebo หากมี มิฉะนั้นใช้ python3
.ts, .jsBun ที่รวมมากับ 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 อักขระ ทักษะที่ใช้ร่วมกันจะถูกย่อก่อน ส่วนทักษะของพนักงานเองจะคงรายการไว้เต็ม

ขีดจำกัดของไฟล์ที่คุณเผยแพร่ขึ้นมาร์เก็ตเพลสอยู่ในหน้า การเผยแพร่