מדריך קלוד קוד למתחילים - חלק 4: מתחת למכסה המנוע

📌 סדרת מדריכי Claude Code למתחילים:

1. חלק 1: מה זה Claude Code?
2. חלק 2: התקנה וחיבור
3. חלק 3: הצעד הראשון שלך
4. חלק 4: מתחת למכסה המנוע (עמוד זה)
5. חלק 5: CLAUDE.md - המוח הקבוע

מטרת המדריך: לפתוח את תיקיית .claude ולהכיר את שני הדברים שמאפשרים לנו לעצב את מה שהאייג'נט (agent) מסוגל לעשות - סקילס (skills) ופקודות (commands). אנחנו לא נכתוב כאן קוד, אלא נעצב התנהגות. האייג'נט הוא זה שיכתוב את הקבצים.

התיקייה הנסתרת שמנהלת את ההצגה

כשעובדים על פרויקט, האייג'נט שומר בשקט תיקייה שנקראת .claude בתוכו.

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

אפשר לחשוב על תיקיית .claude כעל חדר הבקרה של הפרויקט. יש בה שני דברים שחשוב לנו להכיר כרגע:

• סקילס (skills) - יכולות שהאייג'נט טוען רק כשצריך אותן בפועל.
• פקודות (commands) - תהליכי עבודה שמורים שמפעילים לפי השם שלהם.

בואו נעבור עליהם אחד אחד.

4.1 - סקילס: יכולות לפי דרישה

מה זה סקיל

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

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

למה בכלל צריך אותם

שלוש סיבות אמיתיות ליצירת סקיל:

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

תפיסת העולם שגורמת לזה לעבוד

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

איך מייצרים סקיל

אנחנו לא כותבים את זה בקוד ידנית. מתארים את מה שרוצים, והאייג'נט כותב את הקובץ.

אומרים משהו כמו: "Create a skill that does X. It should trigger when I say Y. Save it in my skills folder."

האייג'נט כותב את מסמך הסקיל. אנחנו עוברים עליו ומאשרים. זה הכל.
הארכיטקט מעצב את היכולת, האייג'נט בונה אותה.
חברת אנתרופיק יצרה עבורנו 'סקיל ליצירת סקילס' - הוא נקרא skill-creator ואפשר להוריד אותו מכאן:
https://github.com/anthropics/skills/tree/main/skills/skill-creator

וגם, אפשר לצפות בסרטון הקצרצר הזה בו הסברתי איך סקיל בנוי:
https://youtu.be/JLLm_YeW-7o

4.2 - פקודות: תהליכי עבודה שמורים שמפעילים לפי שם

מה זה פקודה

פקודה (command) היא תהליך עבודה מובנה ושלב-אחר-שלב שנשמר מראש. מפעילים אותה על ידי כתיבת סלאש (/) והשם שלה, למשל /pause-session.

בעוד שסקיל הוא יכולת, פקודה היא פרוצדורה (procedure). סט קבוע של שלבים שהאייג'נט מבצע לפי הסדר, באותה הדרך בכל פעם מחדש.

מה יש בתוך פקודה

• הגדרת מטרה בשורה אחת למעלה.
• שלבים ממוספרים שהאייג'נט מבצע לפי הסדר.
• שערי אישור (gates) - נקודות שבהן האייג'נט עוצר וממתין לאישור שלנו לפני שהוא ממשיך.
• נתיבי קבצים מדויקים, כדי שלא נצטרך לנחש כלום.

השער הזה הוא לא חיסרון, הוא בדיוק צורת העבודה הנכונה. אנחנו קובעים מתי האייג'נט ממשיך. זהו שער האישור (approval gate) שלנו.

למה זה כל כך יעיל

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

איך סקילס ופקודות עובדים יחד

השרשרת הפשוטה שנראה שוב ושוב:

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

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

מה הצעד הבא?

← חזרה למדריך 3: הצעד הראשון שלך | למעבר למדריך 5: CLAUDE.md - המוח הקבוע ←