
🎬 פרק 43 בסדרה הדרכות קלוד מ-0 ל-100
בפרק הקודם Claude Code ארז את הכלים של אתר חנות הפרחים לפלאגין אחד. לפני ששולחים פלאגין לאחרים, כדאי לענות על שלוש שאלות. האם הוא עובד? כמה הוא עולה בכל שיחה? ומה עושים לפני שמפרסמים אותו? המדריך הזה עובר על שלוש השאלות, לפי התיעוד הרשמי, ומראה מה Claude גילה כשהוא בדק ומדד את הפלאגין של האתר.
במדריך הזה:
- בדיקת המבנה הרשמית.
- בדיקות אמינות (evals): עם הפלאגין ובלעדיו.
- כמה פלאגין עולה בכל שיחה, ואיך מקצרים בלי לשבור.
- מה עושים לפני שמפרסמים: שם, גרסה ודרך הפצה.
- מה קרה בהדגמה באפליקציה.
1שאלה 1: האם הוא עובד?
בדיקת המבנה הרשמית
הפקודה הזו בודקת את קובץ ההגדרות של הפלאגין (plugin.json) ואת הכותרות של כל סקיל, סוכן ופקודה:
claude plugin validate ./my-plugin --strictכשהכול תקין, מופיע ✔ Validation passed. בלי --strict, אזהרות לא מכשילות את הבדיקה. עם --strict כל אזהרה נחשבת שגיאה, וזו הבדיקה שכדאי להריץ לפני פרסום.
בדיקות אמינות (evals)
בדיקת המבנה מוודאת שהקבצים תקינים. היא לא בודקת אם הפלאגין באמת עוזר. בשביל זה יש בדיקות אמינות, ובתיעוד: evals. כותבים כמה בקשות לדוגמה, ו-Claude Code מריץ כל אחת פעם עם הפלאגין ופעם בלעדיו. בסוף הוא מראה ציון לכל צד ואת ההפרש ביניהם (Δ), כלומר מה הפלאגין תרם.
איך זה בנוי: בתוך הפלאגין יש תיקייה בשם evals. כל בדיקה היא תיקייה משלה, ובה:
prompt.md: הבקשה לדוגמה.graders/: קבצים שמגדירים מה נחשב הצלחה. למשל: "הסוכן הופעל", "הקובץ לא השתנה", או תיאור במילים ש-Claude אחר שופט.
הפקודות:
claude plugin eval initיוצרת בדיקה ראשונה, עם שאלון קצר.
claude plugin eval . --no-publishמריצה את כל הבדיקות. --no-publish משאיר את הדוח במחשב: report.html בתיקייה evals/results.
--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: מה עושים לפני שמפרסמים?
- שם קבוע. משתמשים מתקינים את הפלאגין לפי השם שלו. שינוי שם אחרי פרסום שובר את ההתקנות אצל אחרים. אם חייבים, יש בקובץ החנות מפה בשם
renames. כדי לשנות רק את השם שמוצג, משתמשים ב-displayName. - מספר גרסה. מעלים את
versionב-plugin.jsonבכל עדכון. לפי התיעוד, אם מעדכנים קבצים בלי לשנות את הגרסה, מי שהתקין נשאר עם העותק הישן. - בדיקה נקייה. מריצים שוב
claude plugin validate --strict, ובודקים התקנה מקומית. - פרטים ו-README. תיאור, מחבר, וקובץ README שמסביר מה יש בפלאגין ואיך מתקינים אותו.
ואז בוחרים איך להפיץ:
| הדרך | מה צריך לדעת |
|---|---|
| שולחים את התיקייה או קובץ zip | הכי פשוט, אבל אין עדכונים אוטומטיים |
| חנות משלכם (marketplace) | מאגר ב-Git עם קובץ marketplace.json. אפשר שיהיה פרטי. על זה בפרק הבא |
| החנות של Anthropic | מגישים דרך claude.ai/directory/manage, וצריך מנוי בתשלום |
4מה קרה בהדגמה
פתחתי שיחה חדשה באפליקציה של Claude, וביקשתי לבדוק, למדוד ולהכין לפרסום את הפלאגין flower-tools מהפרק הקודם. ביקשתי במפורש: בלי commit, בלי להעלות שום דבר לאינטרנט, ובלי לגעת בקבצי האתר.
- בדיקת המבנה עברה, גם לפלאגין וגם לחנות המקומית:
✔ Validation passed. - Claude עבד על עותק. הוא העתיק את הפלאגין לתיקייה זמנית, בלי ההוק שמקפיץ את החלון "קלוד סיים", כדי שלא יקפצו חלונות בזמן הבדיקות.
- שתי בדיקות אמינות, ריצה אחת לכל צד:
- בקשה לשנות את מסמך האפיון (
SPEC.md): עם הפלאגין השינוי נחסם, ו-Claude הסביר למה. בלי הפלאגין הקובץ נכתב. ציון 1 מול 0. - "תבדוק את האתר", על אתר קטן לדוגמה: הסוכן
site-checkerהופעל ומצא את הקישור השבור ואת התמונה בלי תיאור. אבל גם בלי הפלאגין, Claude מצא את אותן בעיות. ציון 1 מול 1. במשימה קטנה כזו הפלאגין לא שיפר את הממצאים, והוא נתן בדיקה שרק קוראת קבצים ורשימה מסודרת.
- בקשה לשנות את מסמך האפיון (
- מדידה: הפלאגין תופס 192 טוקנים בכל שיחה, כולם מהתיאור של הסוכן. הסקיל לא תופס כלום. ההערכה של
claude plugin detailsהייתה כ-295, כי היא סופרת גם את הסקיל. - קיצור: Claude קיצר את התיאור של הסוכן, ל-140 טוקנים (27% פחות). שתי הבדיקות עברו שוב, והסוכן עדיין הופעל.
- הכנה לפרסום: הגרסה עלתה מ-1.0.0 ל-1.0.1. Claude הוסיף README לפלאגין ותיקיית
evals, כדי שגם מי שמקבל אותו יוכל להריץ את הבדיקות. בסוף הוא הריץ שוב את בדיקת המבנה. - קובץ 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, ומקצרים בזהירות. - לפני שמפרסמים: שם קבוע, גרסה חדשה בכל עדכון, ובדיקה נקייה.
