NeboAI
NeboAI
להתחלה

מדריך SKILL.md

בעמוד הזה מופיע כל חלק של כישור ש-Nebo קורא: שדות ה-frontmatter, המשתנים שהוא מרחיב, הכלים שעובדים משתמשים בהם כדי לעבוד עם כישורים, והסביבה שבה סקריפטים רצים.

פורמט הקובץ

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 הם חובה. שדה מהסוג הלא נכון מכשיל את כל הקובץ, והכישור לא נטען. מתעלמים ממפתחות שלא מופיעים כאן.

שדהסוגברירת מחדלמשמעות
namestringחובהמזהה. [a-z0-9-], בלי מקף בהתחלה, בסוף או כפול, עד 64 בתים. התאם לשם התיקייה.
descriptionstringחובהמה הכישור עושה ומתי להשתמש בו. עד 1,024 בתים. מוצג ברשימת הכישורים של העובד ומדורג על ידי 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 בתים.
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 הוא רץ בארגז חול של מערכת ההפעלה:

  • הוא לא יכול לקרוא מאגרי פרטי גישה, נתוני דפדפן ומחזיק מפתחות, או את ההגדרות ומסד הנתונים של 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 תווים, כישורים משותפים מתקצרים קודם; הכישורים של העובד עצמו שומרים על הרשומות המלאות שלהם.

המגבלות על קבצים שאתה מפרסם בחנות מופיעות בעמוד פרסום.