סקירה כללית של מיומנויות Android

יכולות Android הן הוראות שעברו אופטימיזציה ל-AI, כדי לעזור לכלים ולסוכנים מבוססי-AI להבין ולבצע דפוסים ספציפיים שפועלים בהתאם לשיטות המומלצות ולהנחיות לפיתוח ל-Android. הן נמצאות במאגר ב-GitHub בנושא מיומנויות ב-Android.

אתם יכולים להשתמש במיומנות Android כדי לבצע משימות כמו:

• מעבר מ-XML ל-Compose
• שדרוג ל-AGP 9
• הגדרה של מסגרות חדשות יותר כמו Navigation 3
• איך משנים את ממשק המשתמש של האפליקציה כך שיוצג מקצה לקצה
• שיפור הביצועים באמצעות בדיקה של הגדרות R8

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

היכולות של Android מבוססות על התקן הפתוח agent skills, ולכן הן תואמות לכל כלי AI שתומך ביכולות. בדף הזה מוסבר איך להשתמש במיומנויות ב-Android Studio ואיך להשתמש ב-Android CLI כדי להתקין מיומנויות לשימוש עם כל סוכן וכל כלי שתבחרו.

היתרונות העיקריים של מיומנויות Android

השימוש בכישורי Android מספק מספר יתרונות מרכזיים שמטרתם להאיץ את תהליך העבודה שלכם כדי ליצור קוד Android איכותי בצורה יעילה יותר:

• ‫Grounding עם ידע של מומחים: מספקים לסוכנים הקשר ספציפי יותר ל-Android, ומבצעים grounding לפי דרישה כדי להרחיב את הידע והמומחיות שלהם מעבר למחזור האימונים הרגיל של המודל.
• תהליכי עבודה שניתן לחזור עליהם: מספקות הוראות סטנדרטיות כדי לוודא שמשימות מרובות שלבים בפיתוח ל-Android מבוצעות באופן עקבי.
• חבילת משאבים: אפשר לכלול סקריפטים, תבניות או מסמכים נוספים לצד ההוראות הראשיות בקובץ SKILL.md, כדי שהסוכן יקבל את כל מה שהוא צריך במקום אחד, וכך לא יהיה צורך לצרף קבצים באופן ידני להנחיה.
• מומחיות משותפת: אפשר לארוז את דפוסי הפיתוח של הצוות ב-Android בתיקיות משותפות כדי לאפשר גישה ועבודה משותפת.

שימוש במיומנויות ב-Android

היכולות של Android משולבות ב-Android CLI, כך שאפשר להשתמש בהן עם כל סוכן שתבחרו.

Android CLI

מומלץ להתקין מיומנות ל-Android באמצעות Android CLI, שמקל על גילוי, הורדה וניהול של מיומנויות לכל סוכן שתבחרו.

• כדי לראות את רשימת המיומנויות הזמינות, מריצים את הפקודה android skills list.
• כדי להתקין מיומנות, מריצים את הפקודה android skills add --skill skill-name. אם כבר התקנתם את ה-skill, ‏ skills add יעודכן לגרסה העדכנית.

Android Studio

אפשר להוריד מיומנות ממאגר ה-GitHub של מיומנויות ל-Android ולייבא אותה לפרויקט ב-Android Studio.

הפעלת מיומנות

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

ב-Android Studio, אפשר גם להפעיל מיומנות באופן ידני ישירות על ידי הקלדת @skill-name בחלון הצ'אט.

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

אתם יכולים ליצור מיומנויות משלכם כדי לארוז ולשתף את תהליכי העבודה של הצוות. מידע נוסף על הדרישות לגבי כישורי נציגים

הנציג מחפש מיומנויות החל מהספריות .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, צריך להשתמש בנתיבים יחסיים מתיקיית הבסיס של המיומנות. לדוגמה: Run the script at scripts/cleanup.py.

איך פועלות המיומנויות

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

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