🧩 פרק 10

סקילז ופקודות מותאמות אישית

סקיל (Skill) ב-Grok CLI הוא חבילת הנחיות ונהלים מובנית המוגדרת בתוך תיקייה ייעודית המכילה קובץ SKILL.md.

סקילז נועדו עבור תהליכי פיתוח שחוזרים על עצמם לעיתים קרובות, מורכבים מכדי להקלידם ידנית בכל פעם מחדש, וספציפיים מכדי להכביד על קובץ הכללים הכללי AGENTS.md (לדוגמה: יצירת Commits לפי תקן Conventional Commits, הכנת Pull Request, יצירת מיגרציות למסד הנתונים או הפקת דוח בדיקות).

#היררכיית גילוי הסקילז במערכת

Grok CLI סורק מספר תיקיות וממזג את הסקילז לפי סדר הקדימויות הבא (מהחזק לחלש):

סקיל בעל שם זהה בתיקייה קרובה יותר דורס ומחליף סקיל ברמה הגלובלית.

[!NOTE] מנגנון גילוי הסקילז אינו מתחשב בקובץ .gitignore. כדי להסתיר סקיל מסוים או לכבותו, משתמשים בהגדרות ignore או disabled בקובץ config.toml.

#פקודות שטוחות בתיקיית commands

קבצי Markdown שטוחים המונחים תחת תיקיית .grok/commands/ (למשל review.md) הופכים אוטומטית לפקודות סלאש ישירות (שם הקובץ ללא הסיומת הופך לפקודה /review), בדומה למנגנון הפקודות ב-Claude Code.

#הגדרת נתיבים בקובץ התצורה

ניתן להוסיף תיקיות סקילז חיצוניות בקובץ ~/.grok/config.toml:

[skills]
paths = ["~/shared-team-skills"]
ignore = ["~/shared-team-skills/experimental"]
disabled = ["wip-feature-skill"]

• ignore: מתעלם מהתיקייה לחלוטין בעת הגילוי.
• disabled: משאיר את הסקיל ברשימה אך משבית את יכולת ההפעלה שלו.

#מבנה קובץ SKILL.md ופרונט-מטר

דוגמה לסקיל מלא ליצירת Git Commits:

נתיב הקובץ: ~/.grok/skills/commit/SKILL.md

---
name: commit
description: יוצר קומיט בפורמט Conventional Commits. יש להשתמש כאשר המשתמש מבקש לבצע קומיט או מריץ /commit.
when-to-use: קומיט, git commit, שמירת שינויים, יצירת commit
user-invocable: true
disable-model-invocation: false
argument-hint: [תיאור אופציונלי של השינוי]
allowed-tools: ["Bash(git diff*)", "Bash(git commit*)", "Bash(git status)"]
model: grok-4.6
effort: medium
---

# נוהל יצירת Git Commit

כאשר מתבקש ביצוע קומיט, בצע את השלבים הבאים בסדר מדויק:

1. הרץ `git status` ו-`git diff --staged` כדי לבחון את השינויים המוכנים לקומיט.
2. נתח את מהות השינוי ונסח הודעת קומיט לפי תקן Conventional Commits:
   - `feat:` עבור תכונה חדשה
   - `fix:` עבור תיקון באג
   - `refactor:` עבור שינוי מבני ללא שינוי התנהגות
   - `test:` עבור הוספה או עדכון בדיקות
3. הצג את ההודעה המנוסחת למשתמש והרץ את הפקודה `git commit -m "..."`.

#פירוט שדות הפרונט-מטר (Frontmatter)

#הפעלת סקילז בסשן

1. הפעלה ידנית על ידי המשתמש:

   העתק

   /commit
   /commit עדכון מנגנון הטיפול בשגיאות

2. הפעלה אוטונומית על ידי המודל: כאשר אתם מבקשים משימה (למשל: "צור קומיט על השינויים שביצענו"), המודל מזהה את התאמת ה-description ומפעיל את הסקיל באופן עצמאי.
3. פתרון התנגשויות שמות:

   העתק

   /local:commit
   /user:commit
   /my-plugin:commit

#יצירת סקיל מודרכת באמצעות /create-skill

בתוך ממשק ה-TUI, הפקודה /create-skill פותחת אשף יצירה אינטראקטיבי: הסוכן שואל לשם הסקיל, רמת ההיקף (פרויקט או משתמש), מייצר את מבנה הקבצים והתיקיות, ובודק שהסקיל נקרא בצורה תקינה.

#בדיקה ואבחון סקילז

כדי לראות אילו סקילז זוהו ונטענו בתיקייה הנוכחית:

grok inspect
grok inspect --json

הפלט מציג את מקור הסקיל (project, user, bundled, config, plugin), סקילז מושבתים ([disabled]), ואת השם המלא להקלדה במקרה של התנגשות.

#הרגלים מומלצים לכתיבת סקילז

1. תיאור ממוקד עם מילות מפתח: הגדירו בבירור מה הסקיל עושה ומתי יש להפעילו, כדי למנוע הפעלות שגויות.
2. שלבים ממוספרים וחד-משמעיים: נסחו הוראות פעולה ברורות צעד-אחר-צעד.
3. בידוד אחריות: סקיל אחד לזרימת עבודה אחת (הימנעו מסקילז ענקיים שמנסים לבצע הכול).
4. ניהול גרסאות בצוות: סקילז של פרויקט יש לשמור תחת .grok/skills/ ולבצע עליהם Commit ל-Git כדי שכל חברי הצוות ייהנו מהם.

בפרק הבא נלמד על סוכני משנה (Subagents), פרסונות ומנוע ה-Workflows.