הרחבת Agent Mode באמצעות מיומנויות

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

בניגוד לקובצי AGENTS.md, מיומנויות מייצגות מומחיות על פי דרישה. המבנה הזה מאפשר ל-Agent Mode לשמור על מספר גדול של יכולות מיוחדות – כמו מיגרציה בין גרסאות ספציפיות של ספריות או התאמה של רכיב קומפוזבילי לגדלים שונים של מסכים – בלי להעמיס על חלון ההקשר המיידי של המודל.

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

כדי להפעיל מיומנות לפי דרישה, מבקשים מהסוכן לבצע משימה שרלוונטית למיומנות. אפשר גם להזין @ בתיבת הקלט כדי להפעיל מיומנות ספציפית.

יתרונות מרכזיים

  • מומחיות משותפת: אפשר לארוז תהליכי עבודה מורכבים (כמו תהליך ספציפי של צוות לבדיקת בקשות משיכה) בתיקייה ייעודית שכל אחד יכול להשתמש בה.
  • תהליכי עבודה שניתן לחזור עליהם: אפשר לספק הוראות סטנדרטיות כדי לוודא שמשימות מורכבות עם כמה שלבים מתבצעות באופן עקבי.
  • איגוד משאבים: כדאי לכלול סקריפטים, תבניות או נתונים לדוגמה לצד ההוראות, כדי שהסוכן יקבל את כל מה שהוא צריך במקום אחד.
  • שימוש יעיל בחלון ההקשר: כדי לחסוך בטוקנים של הקשר, רק המטא-נתונים של המיומנות (שם ותיאור) נטענים בהתחלה. הקובץ המלא של SKILL.md נטען רק אחרי ההפעלה. קבצים תומכים בספריות references/,‏ scripts/ או assets/ נטענים להקשר רק כשהסוכן צריך אותם באופן ספציפי.

יצירת מיומנויות משלכם

הסוכן מחפש מיומנויות החל מהספריות .skills/ או .agent/skills/ שנמצאות בתיקיית הבסיס של הפרויקט. כדי ליצור מיומנות בהתאמה אישית, פועלים לפי השלבים הבאים:

  1. יוצרים ספרייה למיומנות (לדוגמה, my-new-skill/).
  2. יוצרים קובץ SKILL.md (רגיש לאותיות רישיות) בתוך הספרייה החדשה.

הכישורים צריכים לעמוד בכללים הבאים:

  • ספרייה אחת לכל מיומנות: לכל מיומנות צריכה להיות ספרייה ייחודית משלה שכוללת קובץ SKILL.md ומשאבים נוספים.
  • קינון: כל הכישורים צריכים להיות בספרייה .skills/ או .agent/skills/ בספריית הבסיס של הפרויקט. עם זאת, אפשר להשתמש בספריות משנה כדי לארגן את האתר בצורה טובה יותר (לדוגמה, skills/ui-flows/<skill name>/SKILL.md או skills/testing/<skill name>/SKILL.md).
  • היקף: נכון לעכשיו, המערכת תומכת רק במיומנויות שנמצאות בבסיס הקוד של הפרויקט.

בקובץ SKILL.md נעשה שימוש בבלוק YAML למטא-נתונים וב-Markdown רגיל להוראות.

  • ‫name: מזהה ייחודי של המיומנות. השם צריך להיות זהה לשם הספרייה.
  • description: הסבר ברור על מה שהמיומנות עושה ומתי הסוכן צריך להשתמש בה.
  • גוף: גוף ה-Markdown שמתחת לבלוק ה-YAML מכיל את ההוראות שמנחות את התנהגות הסוכן כשהמיומנות פעילה.
---
name: skill-name
description: A description of what this skill does and when to use it.
metadata:
  author: example-org
  version: "1.0"
---

Skill content

הנחיות לגבי פורמטים

  • שם: עד 64 תווים (רק אותיות קטנות, מספרים ומקפים).
  • תיאור: עד 1,024 תווים.
  • תוכן הגוף: מומלץ להשתמש ב-10,000 עד 20,000 תווים (כ-2,500 עד 5,000 טוקנים). אם ההוראות חורגות מהמגבלה הזו, כדאי להעביר את התיעוד המפורט לקובץ משאבים, כמו שמתואר בקטע ספריות אופציונליות של מיומנויות.

ספריות מיומנויות אופציונליות

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

  • ‫scripts/: מכיל קוד שניתן להרצה (לדוגמה, Python או Bash) שהסוכן יכול להריץ.
  • ‫references/: מכיל תיעוד טכני מפורט, הפניות ל-API או מדריכים ספציפיים לתחום.
  • ‫assets/: מכיל משאבים סטטיים כמו תבניות מסמכים, דיאגרמות של ממשק המשתמש או סכימות JSON.

כשמתייחסים לקבצים האלה בהוראות של SKILL.md, צריך להשתמש בנתיבים יחסיים מהרמה הבסיסית (root) של המיומנות. לדוגמה: Run the script at scripts/cleanup.py.