Slash Command: בניית מערכת פקודות לשימוש חוזר ב-Claude Code

Claude Code מגיע עם כמה slash commands מובנות — /help, /clear, /compact. אבל אלו שבאמת מאיצות את זרימת העבודה הן אלו שאתה כותב בעצמך.

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

מה זה Slash Command מותאם אישית

ב-Claude Code, slash command מותאם אישית הוא פשוט קובץ Markdown. הנח אותו בתיקייה הנכונה, Claude Code מזהה אותו בעת ההפעלה, והקלדת /שם-הקובץ מפעילה אותו.

תוכן הקובץ הוא ה-prompt שנשלח ל-Claude. זה הכול.

אין תחביר מיוחד, אין פורמט הגדרות — קובץ .md אחד הוא פקודה אחת.

היכן לשמור את הקבצים

שני מיקומים, שתי מטרות:

מיקום	נתיב	תחום
פרויקט	.claude/commands/	רק הפרויקט הנוכחי, ניתן לעשות commit ל-git
משתמש	~/.claude/commands/	כל הפרויקטים, אישי

רמת הפרויקט היא ליבת השיתוף בצוות. עשה commit ל-.claude/commands/ ב-git, וכל מי שמשכפל את המאגר יקבל אוטומטית את מערך הפקודות המלא.

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

יצירת ה-Command הראשון

מתיקיית השורש של הפרויקט:

mkdir -p .claude/commands

צור .claude/commands/review.md:

סקור את איכות הקוד של השינויים הנוכחיים. התמקד ב:

1. שגיאות לוגיות ומקרי קצה
2. האם השמות ברורים
3. קוד כפול שכדאי לחלץ
4. בעיות אבטחה (SQL injection, XSS, סודות חשופים)

תן הצעות ספציפיות וניתנות לביצוע — לא עצות כלליות.

הפעל מחדש את Claude Code והקלד /review כדי להפעיל אותו.

שימוש ב-$ARGUMENTS לקבלת קלט

פקודות בעלות תוכן קבוע מוגבלות בשימוש. $ARGUMENTS הופך אותן לגמישות — מה שהמשתמש מקליד אחרי /פקודה מוכנס ל-prompt.

דוגמה .claude/commands/test.md:

כתוב בדיקות עבור: $ARGUMENTS

דרישות:
- כסה את המסלול הרגיל ומקרי קצה
- שמות הבדיקות צריכים להיות מסבירים את עצמם
- השתמש בנתונים אמיתיים במקום mocks היכן שאפשר

שימוש:

/test מתודת login של הקלאס UserAuthentication

Claude מקבל:

כתוב בדיקות עבור: מתודת login של הקלאס UserAuthentication

דרישות:
...

$ARGUMENTS יכול להופיע בכל מקום ב-prompt ולשמש מספר פעמים.

עקרונות עיצוב

פקודה אחת, אחריות אחת

אל תכתוב פקודת "הכול-באחד". /review לסקירת קוד, /test לכתיבת בדיקות, /pr לתיאורי PR. פקודות ממוקדות קל יותר לזכור ולעשות בהן שימוש חוזר.

כתוב prompts קונקרטיים, לא מופשטים

רע:

עזור לי לאופטימיזציה של הקוד הזה


טוב:
```
אופטימיזציה של הקוד הזה לביצועים. עדיפויות:
1. הפחתת שאילתות מיותרות לבסיס הנתונים (בעיות N+1)
2. הימנעות מחישובים חוזרים בתוך לולאות
3. החלפת חיפושים ליניאריים במבני נתונים יעילים יותר

השאר את הממשק ללא שינוי — שנה רק את המימוש.
```

הגבלות קונקרטיות מובילות לתוצאות ממוקדות.

הוסף frontmatter לפקודות

שדה ה-description מופיע ברשימת הפקודות של Claude Code, כך שחברי הצוות מבינים מיד מה כל פקודה עושה:

---
description: סוקר את השינויים הנוכחיים ומספק משוב על איכות הקוד
---

סקור את איכות הקוד של השינויים הנוכחיים...

מפתח לאימוץ בצוות: commit ל-git

הערך האמיתי של פקודות מותאמות אישית אינו פרודוקטיביות אישית — אלא מתן שפה משותפת לצוות.

עשה commit ל-.claude/commands/ במאגר ותעד את הפקודות הזמינות ב-README או CLAUDE.md. חברים חדשים מקבלים את ספריית ה-prompts שהצוות צבר ברגע שהם משכפלים את המאגר.

ככל שהפרויקט מתפתח, גם הפקודות מתפתחות. אם prompt לא עובד טוב, תקן שורה אחת ודחוף — כל הצוות מקבל את העדכון.

מבנה תיקיות לדוגמה

.claude/
├── commands/
│   ├── review.md
│   ├── test.md
│   ├── pr.md
│   └── explain.md
└── settings.json