NeboAI
NeboAI
להתחלה

כישורים

כישור מלמד עובד איך לעשות היטב סוג אחד של עבודה. אתה כותב אותו כתיקייה עם קובץ SKILL.md: תיאור קצר שהעובד משתמש בו כדי לבחור את הכישור, והוראות שהוא ממלא אחרי שהכישור נטען. כישורים לא דורשים קוד, וכל עובד בבוט יכול להשתמש בהם.

מה זה כישור

כישור הוא תיקייה ששמה תואם ל-name של הכישור. בתיקייה יש קובץ SKILL.md ואם רוצים, כל קובץ אחר שההוראות מפנות אליו: מסמכי עיון, תבניות או סקריפטים.

ל-SKILL.md יש שני חלקים. ה-frontmatter ב-YAML בין שורות --- נושא את השם ותיאור. גוף ה-Markdown שאחריו נושא את ההוראות.

איך עובדים משתמשים בכישורים

עובד עובד עם כישור בשלושה שלבים.

  1. בחירה. בכל תור העובד רואה רשימה של הכישורים שזמינים לו: השם של כל כישור, התיאור שלו ועד שלושה מהטריגרים שלו. העובד מחליט לפי התיאור, אז כתוב אותו כך שיאמר מה הכישור עושה ומתי להשתמש בו.
  2. טעינה. העובד קורא לכלי use_skill עם שם הכישור. הכלי מחזיר את ההוראות, את הנתיב של תיקיית הכישור ואת שמות הקבצים שלו. זו הדרך היחידה שבה עובד קורא כישור.
  3. עבודה. העובד ממלא את ההוראות. הוא קורא קבצים נלווים עם read_skill_file ומריץ סקריפטים כלולים עם execute.

טריגרים אף פעם לא טוענים כישור בעצמם. ההחלטה תמיד של העובד. כשהרשימה מתארכת, העובד יכול לחפש בה עם find_skills.

כתוב את הכישור הראשון שלך

צור תיקייה בשם הכישור, ובתוכה קובץ אחד.

meeting-notes/
└── SKILL.md
---
name: meeting-notes
description: Turn a meeting transcript into decisions, action items with owners, and open questions. Use when someone shares meeting notes or a transcript.
---

# Meeting notes

1. List the decisions that were made.
2. List action items as "owner — task — due date".
3. List open questions that need a follow-up.

Keep each list short. If the transcript names no owner for an item, write "unassigned".

שים את התיקייה בתיקיית הכישורים של המשתמש בבוט (ראה איפה נמצאים כישורים). Nebo מבחין בתיקייה החדשה תוך כשנייה, וכל עובד בבוט הזה יכול להשתמש בכישור.

עובד יכול גם לכתוב בשבילך כישור. בקש ממנו לשמור כישור, והוא יקרא ל-save_skill, שכותב את התיקייה לאותה תיקיית כישורים של המשתמש.

כללים שהטוען אוכף

כישור שמפר אחד מהכללים האלה לא נטען. Nebo רושם אזהרה ביומן ומדלג עליו.

כללפרטים
הקובץ מתחיל ב----ה-frontmatter חייב להיות הדבר הראשון בקובץ. הקובץ חייב להיות בקידוד UTF-8.
name הוא חובהרק אותיות קטנות, ספרות ומקפים; בלי מקף בהתחלה או בסוף; בלי מקף כפול; עד 64 בתים.
description הוא חובהעד 1,024 בתים.
לשדות יש את הסוג הנכוןשדה עם סוג YAML שגוי מכשיל את כל הקובץ. שים גרסאות במירכאות, כמו "1.0.0".
platform תואםאם השדה קיים, הכישור נטען רק במערכות ההפעלה שברשימה.

מפתחות frontmatter ש-Nebo לא מכיר מתעלמים מהם. לגוף אין מגבלת גודל, אבל הוראות קצרות יותר משאירות יותר מקום לעבודה. העבר חומר ארוך לקבצים שהעובד קורא כשהוא צריך אותם.

הוספת קבצים

כל קובץ בתיקייה מלבד SKILL.md וקבצים שמתחילים בנקודה זמין לעובד. את שמות התיקיות אתה בוחר; Nebo לא מייחס משמעות מיוחדת ל-references/ או ל-assets/. אפשר להריץ קבצים שתחת scripts/ או bin/.

invoice-check/
├── SKILL.md              # required
├── references/
│   └── policy.md         # read with read_skill_file
└── scripts/
    └── totals.py         # run with execute

הפנה לקבצים לפי הנתיב שלהם בתוך התיקייה, כמו references/policy.md. העובד קורא אותם עם read_skill_file, שדוחה כל נתיב שיוצא מהתיקייה. סקריפטים רצים עם הכלי execute בארגז חול. מדריך העיון ל-SKILL.md מסביר על סביבות ריצה, משתני סביבה, סודות וגישה לרשת.

איפה נמצאים כישורים

בוט אוסף כישורים מכמה מקומות. כששני מקורות מספקים כישור עם אותו שם, המקור שמופיע מאוחר יותר ברשימה הזו גובר.

מקורמיקוםמי יכול להשתמש בו
מובנהמהודר לתוך Neboכל עובד
חנות<data>/nebo/skills/<slug>/<version>/כל עובד
תוסףהתיקייה skills/ של תוסף מותקןכל עובד
משתמש<data>/user/skills/<name>/כל עובד
חבילת עובדskills/ בתוך חבילת עובד מותקנתרק העובד הזה
נלמד<data>/learned/skills/<employee>/<name>/רק העובד הזה

<data> הוא ~/Library/Application Support/Nebo ב-macOS, %APPDATA%\Nebo ב-Windows ו-~/.local/share/nebo ב-Linux. משתנה הסביבה NEBO_HOME גובר עליו. כשלעובד יש כישור משלו וכישור משותף עם אותו שם, הכישור שלו גובר.

Nebo עוקב אחרי התיקיות האלה וטוען מחדש כישור ששונה אחרי שנייה. כדי לכבות כישור בלי למחוק אותו, שנה את שם הקובץ שלו ל-SKILL.md.disabled.

כישורים מתארים עבודה, לא כלים. כתוב כישור סביב תחום אחריות, כמו התאמת קבלות, ותן לעובד להשתמש בכל חיבור שהבעלים סיפק. כשכישור באמת צריך תוסף, הצהר עליו בשדה plugins.

הבא