בודקים ומודדים פלאגין: בדיקות, טוקנים וגרסה לפני שמפרסמים

📘 מדריך מעשי🎬 פרק 43⏱️ 7 דקות קריאה🗓️ עודכן 13.11.2026
מדריכים מעשיים · הדרכות קלוד מ-0 ל-100
בודקים ומודדים פלאגין: בדיקות, טוקנים וגרסה לפני שמפרסמים

🎬 פרק 43 בסדרה הדרכות קלוד מ-0 ל-100

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

במדריך הזה:

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

1שאלה 1: האם הוא עובד?

בדיקת המבנה הרשמית

הפקודה הזו בודקת את קובץ ההגדרות של הפלאגין (plugin.json) ואת הכותרות של כל סקיל, סוכן ופקודה:

claude plugin validate ./my-plugin --strict

כשהכול תקין, מופיע ✔ Validation passed. בלי --strict, אזהרות לא מכשילות את הבדיקה. עם --strict כל אזהרה נחשבת שגיאה, וזו הבדיקה שכדאי להריץ לפני פרסום.

טיפ: אפשר לבדוק גם את קובץ החנות (marketplace), באותה פקודה, על התיקייה של החנות.

בדיקות אמינות (evals)

בדיקת המבנה מוודאת שהקבצים תקינים. היא לא בודקת אם הפלאגין באמת עוזר. בשביל זה יש בדיקות אמינות, ובתיעוד: evals. כותבים כמה בקשות לדוגמה, ו-Claude Code מריץ כל אחת פעם עם הפלאגין ופעם בלעדיו. בסוף הוא מראה ציון לכל צד ואת ההפרש ביניהם (Δ), כלומר מה הפלאגין תרם.

איך זה בנוי: בתוך הפלאגין יש תיקייה בשם evals. כל בדיקה היא תיקייה משלה, ובה:

  • prompt.md: הבקשה לדוגמה.
  • graders/: קבצים שמגדירים מה נחשב הצלחה. למשל: "הסוכן הופעל", "הקובץ לא השתנה", או תיאור במילים ש-Claude אחר שופט.

הפקודות:

claude plugin eval init

יוצרת בדיקה ראשונה, עם שאלון קצר.

claude plugin eval . --no-publish

מריצה את כל הבדיקות. --no-publish משאיר את הדוח במחשב: report.html בתיקייה evals/results.

שימו לב: כל ריצה היא שיחה אמיתית עם Claude, והיא נספרת בשימוש שלכם. ברירת המחדל היא שלוש ריצות לכל צד. לכן מתחילים עם מעט בקשות, ואפשר להוריד לריצה אחת עם --runs 1.

2שאלה 2: כמה הוא עולה?

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

איך מודדים:

מהאיפהמה רואים
claude plugin details <שם>בטרמינלכמה טוקנים הפלאגין תופס בכל הודעה (Always-on), ופירוט לפי רכיב
/contextבתוך שיחהכמה תופסים בפועל הסקילים, הסוכנים והחיבורים
/pluginבתוך שיחהפלאגין שלא השתמשתם בו 14 יום ו-10 שיחות עובר לרשימה "Not used recently"
/usageבתוך שיחה, במנויים בתשלוםאיזה חלק מהשימוש הלך לסקילים, לסוכנים ולפלאגינים

לפי התיעוד, כשהפלאגין תופס 2,000 טוקנים ומעלה בכל הודעה, מסך הפלאגינים מסמן את זה.

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

טיפ: סקיל שמסומן disable-model-invocation: true (כזה שמפעילים רק ביד, עם /) לא תופס כלום בהודעה רגילה. אצלנו זה הסקיל check-order.

3שאלה 3: מה עושים לפני שמפרסמים?

  1. שם קבוע. משתמשים מתקינים את הפלאגין לפי השם שלו. שינוי שם אחרי פרסום שובר את ההתקנות אצל אחרים. אם חייבים, יש בקובץ החנות מפה בשם renames. כדי לשנות רק את השם שמוצג, משתמשים ב-displayName.
  2. מספר גרסה. מעלים את version ב-plugin.json בכל עדכון. לפי התיעוד, אם מעדכנים קבצים בלי לשנות את הגרסה, מי שהתקין נשאר עם העותק הישן.
  3. בדיקה נקייה. מריצים שוב claude plugin validate --strict, ובודקים התקנה מקומית.
  4. פרטים ו-README. תיאור, מחבר, וקובץ README שמסביר מה יש בפלאגין ואיך מתקינים אותו.

ואז בוחרים איך להפיץ:

הדרךמה צריך לדעת
שולחים את התיקייה או קובץ zipהכי פשוט, אבל אין עדכונים אוטומטיים
חנות משלכם (marketplace)מאגר ב-Git עם קובץ marketplace.json. אפשר שיהיה פרטי. על זה בפרק הבא
החנות של Anthropicמגישים דרך claude.ai/directory/manage, וצריך מנוי בתשלום

4מה קרה בהדגמה

פתחתי שיחה חדשה באפליקציה של Claude, וביקשתי לבדוק, למדוד ולהכין לפרסום את הפלאגין flower-tools מהפרק הקודם. ביקשתי במפורש: בלי commit, בלי להעלות שום דבר לאינטרנט, ובלי לגעת בקבצי האתר.

  1. בדיקת המבנה עברה, גם לפלאגין וגם לחנות המקומית: ✔ Validation passed.
  2. Claude עבד על עותק. הוא העתיק את הפלאגין לתיקייה זמנית, בלי ההוק שמקפיץ את החלון "קלוד סיים", כדי שלא יקפצו חלונות בזמן הבדיקות.
  3. שתי בדיקות אמינות, ריצה אחת לכל צד:
    • בקשה לשנות את מסמך האפיון (SPEC.md): עם הפלאגין השינוי נחסם, ו-Claude הסביר למה. בלי הפלאגין הקובץ נכתב. ציון 1 מול 0.
    • "תבדוק את האתר", על אתר קטן לדוגמה: הסוכן site-checker הופעל ומצא את הקישור השבור ואת התמונה בלי תיאור. אבל גם בלי הפלאגין, Claude מצא את אותן בעיות. ציון 1 מול 1. במשימה קטנה כזו הפלאגין לא שיפר את הממצאים, והוא נתן בדיקה שרק קוראת קבצים ורשימה מסודרת.
  4. מדידה: הפלאגין תופס 192 טוקנים בכל שיחה, כולם מהתיאור של הסוכן. הסקיל לא תופס כלום. ההערכה של claude plugin details הייתה כ-295, כי היא סופרת גם את הסקיל.
  5. קיצור: Claude קיצר את התיאור של הסוכן, ל-140 טוקנים (27% פחות). שתי הבדיקות עברו שוב, והסוכן עדיין הופעל.
  6. הכנה לפרסום: הגרסה עלתה מ-1.0.0 ל-1.0.1. Claude הוסיף README לפלאגין ותיקיית evals, כדי שגם מי שמקבל אותו יוכל להריץ את הבדיקות. בסוף הוא הריץ שוב את בדיקת המבנה.
  7. קובץ zip מוכן לשליחה: flower-marketplace-v1.0.1.zip, עם 20 קבצים ובגודל 19KB.

הכול לקח 13 דקות, וכל הבדיקות יחד עלו בערך 1.1 דולר לפי ההערכה של הכלי. קבצי האתר לא השתנו, ולא נעשה commit.

5חשוב לדעת

  • הבדיקות מריצות את ההוקים של הפלאגין. אם יש בו הוק שמקפיץ חלון או שולח הודעה, כדאי להריץ את הבדיקות על עותק בלי ההוק הזה, כמו בהדגמה.
  • בדיקה שמכינה קבצים: בדיקה יכולה להריץ סקריפט שמכין קבצים לדוגמה, אבל רק עם הדגל --scaffold. הסקריפט רץ בהרשאות שלכם, אז משתמשים בזה רק עם בדיקות שאתם כתבתם.
  • ציון 1 מול 1 הוא לא כישלון. הוא אומר שבבקשה הזו Claude מסתדר גם בלי הפלאגין. זה מידע חשוב: אולי הפלאגין שווה יותר במשימות גדולות, או שאפשר לוותר על חלק ממנו.
  • ההערכה והמדידה שונות. claude plugin details נותן הערכה, ו-/context מראה מה באמת נכנס לשיחה.

בקשות להעתקה

תבדוק את הפלאגין שבתיקייה הזאת לפני שאני שולח אותו לאחרים. תריץ את הבדיקה הרשמית במצב קפדני, ותכתוב שתי בדיקות אמינות קטנות (evals) שבודקות אם הכלים שלו נכנסים לפעולה כשצריך. תריץ אותן פעם עם הפלאגין ופעם בלעדיו, עם --no-publish, ותסביר לי במילים פשוטות מה הפלאגין תורם. אל תעשה commit ואל תעלה שום דבר לאינטרנט.

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

תכין את הפלאגין שלי לפרסום: תעלה את מספר הגרסה, תוודא שיש תיאור, מחבר ו-README מסודרים, תריץ שוב את הבדיקה הרשמית, ותכין קובץ zip שאפשר לשלוח. בסוף תגיד לי מה השתנה.

בקצרה

  • בודקים את המבנה עם claude plugin validate --strict.
  • בודקים אם הפלאגין באמת עוזר עם claude plugin eval: כל בקשה רצה עם הפלאגין ובלעדיו. כל ריצה נספרת בשימוש, אז מתחילים בקטן.
  • השמות והתיאורים של הסקילים והסוכנים נכנסים לכל שיחה. מודדים עם claude plugin details ו-/context, ומקצרים בזהירות.
  • לפני שמפרסמים: שם קבוע, גרסה חדשה בכל עדכון, ובדיקה נקייה.
הדמות של Claude Code לעצלנים נחה על פוף עם לפטופ וקפה

עצרו שנייה ✋

כבד עליכם? מורכב לכם? יש דרך עצלה יותר.

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

  • אתרים
  • מערכות CRM
  • סרטונים
  • מותגים
  • אפליקציות

קודם יוצרים. אחר כך לומדים.