Μορφή αρχείου
Το 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 είναι υποχρεωτικά. Ένα πεδίο με λάθος τύπο αποτυγχάνει ολόκληρο το αρχείο, οπότε η δεξιότητα δεν φορτώνεται. Τα κλειδιά που δεν αναφέρονται εδώ αγνοούνται.
| Πεδίο | Τύπος | Προεπιλογή | Σημασία |
|---|---|---|---|
name | string | υποχρεωτικό | Αναγνωριστικό. [a-z0-9-], χωρίς παύλα στην αρχή, στο τέλος ή διπλή, έως 64 byte. Πρέπει να ταιριάζει με το όνομα του φακέλου. |
description | string | υποχρεωτικό | Τι κάνει η δεξιότητα και πότε χρησιμοποιείται. Έως 1.024 byte. Εμφανίζεται στη λίστα δεξιοτήτων του υπαλλήλου και βαθμολογείται από το find_skills. |
version | string | "1.0.0" | Σημασιολογική έκδοση. Ελέγχεται από τα εύρη 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 byte. |
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 εκτελείται σε απομονωμένο περιβάλλον του λειτουργικού συστήματος:
- Δεν μπορεί να διαβάσει αποθήκες διαπιστευτηρίων, δεδομένα προγράμματος περιήγησης και 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 χαρακτήρες, συντομεύονται πρώτα οι κοινόχρηστες δεξιότητες· οι δικές του δεξιότητες ενός υπαλλήλου κρατούν ολόκληρες τις καταχωρίσεις τους. |
Τα όρια για τα αρχεία που δημοσιεύετε στην αγορά βρίσκονται στη σελίδα Δημοσίευση.