פורמט הקובץ
SKILL.md הוא טקסט בקידוד UTF-8. הוא מתחיל בשורה של שלושה מקפים, אחריה frontmatter ב-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 ... שדות frontmatter
רק name ו-description הם חובה. שדה מהסוג הלא נכון מכשיל את כל הקובץ, והכישור לא נטען. מתעלמים ממפתחות שלא מופיעים כאן.
| שדה | סוג | ברירת מחדל | משמעות |
|---|---|---|---|
name | string | חובה | מזהה. [a-z0-9-], בלי מקף בהתחלה, בסוף או כפול, עד 64 בתים. התאם לשם התיקייה. |
description | string | חובה | מה הכישור עושה ומתי להשתמש בו. עד 1,024 בתים. מוצג ברשימת הכישורים של העובד ומדורג על ידי 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 בתים. |
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 תווים, כישורים משותפים מתקצרים קודם; הכישורים של העובד עצמו שומרים על הרשומות המלאות שלהם. |
המגבלות על קבצים שאתה מפרסם בחנות מופיעות בעמוד פרסום.