בפרויקט האתר שלי יש CLAUDE.md עם מפה של המסמכים, כדי שקלוד יפתח רק את הקובץ שהוא צריך. ויש אצלי hook שאומר לו אילו סקילים וכללים לטעון לפני שהוא מתחיל.
שני הדברים האלה חיים בסביבה שמסביב למודל, ובשביל זה בניתי אודיט שבודק אותה.
מה זה Harness Engineering?
זו הסביבה שמסביב למודל: הקבצים שהוא קורא, הבדיקות שיכולות להיכשל וההרשאות שחוסמות פעולות. הפרומפט הוא ההוראה של הרגע. הסביבה נשארת בין שיחה לשיחה, ותופסת טעויות לפני שהן מגיעות אליכם.
אם הסוכן שוכח אותה הוראה שוב ושוב, או אומר "סיימתי" על קוד שלא עובד, כנראה אין בפרויקט מקום שמחזיק את ההוראה, ואין בדיקה שיכולה להיכשל.
איך מתקינים ומריצים?
מורידים את הסקיל, מתקינים פעם אחת, ומבקשים מקלוד "תעשה אודיט לסביבה של הסוכן".
הסקיל להורדה (harness-audit.zip)
מעלים כמו שהוא, בלי לפתוח ובלי לשנות את השם.
ב-Claude Code: כותבים לקלוד בתוך הפרויקט את ההוראה הזו. הוא מחלץ ומתקין לבד, והסקיל נשאר מותקן לפעמים הבאות.
תחלץ את הקובץ harness-audit.zip שהורדתי אל התיקייה skills של Claude, ואז תעשה אודיט לסביבה של הסוכן בפרויקט הזה.
אם הוא לא מוצא את הקובץ, התיקייה היא ~/.claude/skills/ (ב-Windows: %USERPROFILE%\.claude\skills\).
באתר או באפליקציה של Claude: בהגדרות, תחת Capabilities, מפעילים הרצת קוד (Code execution and file creation). אחר כך נכנסים אל Customize, ואז Skills, לוחצים על הפלוס ובוחרים Upload a skill, ומעלים את קובץ ה-ZIP כמו שהוא. לא מפרקים אותו ולא משנים את שם התיקייה שבתוכו. אחר כך מעלים לשיחה את קבצי ההוראות של הפרויקט (למשל CLAUDE.md) וכותבים "תעשה אודיט".
מה חמשת הכללים שהסקיל בודק?
הסקיל בודק חמישה כללים, וכל אחד מקבל ציון מ-0 עד 2. ביחד יוצא ציון מ-10.
- להגדיר את המשימה. לכל משימה כותבים מה רוצים לקבל, מה אסור לגעת בו ומתי היא נחשבת גמורה. בלי זה המודל מחליט לבד מתי הוא סיים, ולפעמים הוא פותר גרסה קלה יותר ואומר שהצליח.
- מפה קצרה של הפרויקט. קובץ קצר אחד אומר איפה כל דבר נמצא, והסוכן פותח רק מה שהוא צריך. מפה ארוכה, או כזו שמצביעה על קבצים שנמחקו, גורמת לו לפספס את הכלל החשוב.
- זיכרון בקובץ. החלטות, העדפות ובאגים פתוחים נכתבים בקובץ, וכל שיחה חדשה ממשיכה משם. בלי זה הסוכן שואל שוב את אותן שאלות.
- בדיקות שיכולות להיכשל. בדיקות, lint או בנייה נותנים לסוכן שגיאה אמיתית לתקן, וההוראות אומרות מתי להריץ אותן. בלי זה הוא לא יודע שהעבודה שלו שבורה.
- כלל כתוב וגם חסום. כלל חשוב כתוב בטקסט, וגם חסום בהרשאות או ב-hook. כלל שרק כתוב מדלגים עליו כשהשיחה עמוסה.
אצלי כלל 2 הוא מפת המסמכים שב-CLAUDE.md של פרויקט האתר.
מה הסקיל עושה, ומה הוא לא עושה?
הוא סורק את הפרויקט, קורא בעצמו את קבצי ההוראות ומחזיר דוח: ציון מ-10, ועד חמישה תיקונים לפי חשיבות, עם הטקסט המדויק להוספה. הוא משנה משהו רק אחרי שאישרתם, או אם ביקשתם במפורש להחיל את התיקונים. אפשר גם לבקש ממנו קובץ HARNESS.md שנבנה מהנתיבים והפקודות האמיתיים של הפרויקט שלכם.
- הוא לא מריץ את הפרויקט. הוא לא מריץ את הבדיקות, הבנייה וה-hooks, ולא קורא קבצי .env, מפתחות או .mcp.json.
- הסריקה יכולה לטעות. היא מסתכלת רק על ניסוח ושמות קבצים. בגלל זה המודל מאשר כל ציון בקריאה, וכדאי גם לכם לקרוא את מה שהוא מצא.
- ציון גבוה לא מוכיח שהסוכן מתנהג טוב. הוא אומר שהסביבה בנויה נכון.
אחרי התיקונים, בחרו משימה אחת שהכללים החדשים אמורים להגן עליה, והריצו אותה. אם אתם לא יודעים במה להתחיל, כתבו ב-CLAUDE.md שורה אחת שאומרת מתי משימה נחשבת גמורה. אם אין לכם עדיין קובץ כזה, המדריך על CLAUDE.md מסביר איך מתחילים. אם יש כזה והוא התארך עם השנים, האודיט ל-CLAUDE.md מנקה ממנו שורות שכבר לא מתאימות.
שאלות נפוצות
מה צריך כדי להריץ את הסקיל?
באתר ובאפליקציה של Claude צריך להפעיל הרצת קוד בהגדרות כדי שהסריקה תרוץ. אפשר להריץ אותו גם ב-Claude Code. איזה חשבון כולל את היכולות האלה, כדאי לבדוק בדף התמחור של Claude.
האם האודיט משנה את הפרויקט שלי?
רק אחרי שאישרתם, או אם ביקשתם במפורש להחיל את התיקונים. את קובץ HARNESS.md הוא יוצר רק אם ביקשתם.
האם האודיט קורא קבצי env, סיסמאות ו-mcp.json?
לא. קבצי env, מפתחות ו-mcp.json נשארים בלי קריאה. מקבצי ההגדרות של Claude הוא סופר רק כמה כללי deny יש ואילו hooks מוגדרים.
