NeboAI
NeboAI
Ξεκινήστε

Αναφορά SKILL.md

Αυτή η σελίδα παραθέτει κάθε μέρος μιας δεξιότητας που διαβάζει το Nebo: τα πεδία frontmatter, τις μεταβλητές που αναπτύσσει, τα εργαλεία με τα οποία δουλεύουν οι υπάλληλοι με τις δεξιότητες και το περιβάλλον στο οποίο εκτελούνται τα σενάρια.

Μορφή αρχείου

Το SKILL.md είναι κείμενο UTF-8. Ξεκινά με μια γραμμή τριών παυλών, ακολουθεί το YAML frontmatter και μετά μια γραμμή κλεισίματος τριών παυλών. Ό,τι ακολουθεί είναι το σώμα: οδηγίες 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 ...

Πεδία frontmatter

Μόνο τα name και description είναι υποχρεωτικά. Ένα πεδίο με λάθος τύπο αποτυγχάνει ολόκληρο το αρχείο, οπότε η δεξιότητα δεν φορτώνεται. Τα κλειδιά που δεν αναφέρονται εδώ αγνοούνται.

ΠεδίοΤύποςΠροεπιλογήΣημασία
namestringυποχρεωτικόΑναγνωριστικό. [a-z0-9-], χωρίς παύλα στην αρχή, στο τέλος ή διπλή, έως 64 byte. Πρέπει να ταιριάζει με το όνομα του φακέλου.
descriptionstringυποχρεωτικόΤι κάνει η δεξιότητα και πότε χρησιμοποιείται. Έως 1.024 byte. Εμφανίζεται στη λίστα δεξιοτήτων του υπαλλήλου και βαθμολογείται από το find_skills.
versionstring"1.0.0"Σημασιολογική έκδοση. Ελέγχεται από τα εύρη 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 byte.
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}Η τιμή ενός δηλωμένου μυστικού.
$ARGUMENTSΤα args που περνιούνται στο 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, .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 εκτελείται σε απομονωμένο περιβάλλον του λειτουργικού συστήματος:

  • Δεν μπορεί να διαβάσει αποθήκες διαπιστευτηρίων, δεδομένα προγράμματος περιήγησης και keychain, ούτε τις ρυθμίσεις και τη βάση δεδομένων του ίδιου του 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 χαρακτήρες, συντομεύονται πρώτα οι κοινόχρηστες δεξιότητες· οι δικές του δεξιότητες ενός υπαλλήλου κρατούν ολόκληρες τις καταχωρίσεις τους.

Τα όρια για τα αρχεία που δημοσιεύετε στην αγορά βρίσκονται στη σελίδα Δημοσίευση.