חזרה לבלוג

skillify: הסקיל שבונה סקילים

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

claude-code skills ai workflow tdd

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

מאז הוא חלק קבוע מהעבודה שלי.

מה זה עושה

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

למה הגישה האינטואיטיבית לא עובדת

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

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

הראיון

הניואנס היפה ב-skillify הוא הראיון, דרך AskUserQuestion. נקודת הפתיחה היא: “אני כבר יודע מה עשית עכשיו, בוא נעגן את זה”.

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

ארבעה סבבים:

  1. סבב 1 — שם, תיאור, מטרה.
  2. סבב 2 — הסטפים, ארגומנטים, אופן ההרצה, מיקום השמירה.
  3. סבב 3 — מעבר סטפ-סטפ: מה כל סטפ מייצר, מה מוכיח שהוא הצליח, האם לעצור לאישור, מה הכללים הקשיחים.
  4. סבב 4 — מעגן את הטריגרים שיפעילו את הסקיל בפעם הבאה.

סבב 3 הוא העיקר

השדה החובה שם הוא Success criteria. לכל שלב חייבת להיות הוכחה שהוא נגמר.

“להריץ את הטסטים” — זה שלב. “כל הטסטים ירוקים, אפס skipped” — זה success criterion. הניסוח הראשון משאיר למודל מרחב להכריז ניצחון על pass רעוע. השני מחייב ארטיפקט מוחשי.

הפלט

קובץ SKILL.md מסודר. שלבים ממוספרים, שורת Success criteria בכל אחד, אנוטציות אופציונליות לאופן הרצה, ארטיפקטים, נקודות אישור אנושי, ו-hard rules. רשימת ה-allowed-tools נגזרת אוטומטית מהטולים שבאמת השתמשתי בהם בסשן — ההרשאות תפורות בדיוק לעבודה.

שלמות החוזה

Memory לוכד עובדות. סקילים לוכדים workflows. Hooks אוכפים.

אז מה ש-skillify באמת נותן, מעבר ל”לבקש מקלוד לכתוב את הסקיל באותו הסשן”? שלמות של החוזה. ספציפית: שדה ה-Success criteria חובה בכל סטפ. בלי skillify, שום דבר לא מונע מקלוד-באותו-סשן להפיק SKILL.md שאומר “להריץ את הטסטים” בלי שום קריטריון קבלה. ה-runtime פשוט יכריז ניצחון על כל פלט שנראה סביר. skillify לא נותן לקובץ כזה לצאת מהראיון — הוא אוכף את שדה הקריטריון מבנית.

אותו עיקרון של TDD. skillify מכריח אותך לכתוב את הטסט.

קוד פתוח — Nitzan94/claude-code-skills/skills/skillify.