תת-סוכן SQL ב-Claude Code שגם בודק את עצמו

1. התקנה חד-פעמית: גלוש אל claude.ai/download והורד את אפליקציית Claude למחשב (Windows או Mac). הפעל את קובץ ההתקנה והתקן כמו כל תוכנה (Next → Install).

2. פתח את האפליקציה והתחבר עם אותו חשבון claude.ai (נדרש מנוי Pro או Max).

3. באפליקציה בחר לפתוח סשן על תיקייה (Open folder / בחירת תיקיית עבודה): צור תיקייה ייעודית, למשל C:\עבודה\דאטה, ובחר אותה. שמור בתוכה את קובץ תיאור הסכימה בשם schema.md (אותו קובץ מהפתרון הקודם), ואם אפשר — קובץ CSV מדגמי עם נתונים לא רגישים.

4. בפעם הראשונה ש-Claude יבצע פעולה יופיע חלון אישור — לחץ Allow (אפשר "Allow always" לפעולות חוזרות).

5. בתיבת הצ'אט כתוב מילה-במילה: "צור תת-סוכן חדש בשם sql-writer עם ההגדרה הבאה:" והדבק מיד אחריה:

      ---
      name: sql-writer
      description: כותב שאילתות SQL לפי קובץ הסכימה schema.md שבתיקייה
      ---
      אתה כותב שאילתות SQL. קרא תמיד קודם את הקובץ schema.md שבתיקייה. כשמתארים לך בקשה בעברית: כתוב שאילתה בניב [מלא: PostgreSQL / MySQL / BigQuery], השתמש רק בטבלאות ובעמודות שבסכימה, הוסף הערה מעל כל JOIN, והצע LIMIT 100 לבדיקה. אם יש בתיקייה קובץ נתונים מדגמי — בדוק עליו את ההיגיון של השאילתה לפני שאתה מחזיר אותה. שמור כל שאילתה סופית בתיקיית queries/ עם שם תיאורי בעברית ותאריך. אם חסר שדה בסכימה — עצור ושאל.

6. Claude ייצור בעצמו את קובץ הסוכן בתיקייה .claude/agents/ שבתיקיית העבודה — תראה הודעת אישור שהקובץ נוצר (לחץ Allow אם נדרש).

7. שימוש: בצ'אט כותבים "הפעל את הסוכן sql-writer עבור: הכנסה חודשית לפי אזור ב-2025".

8. טריגר: ידני — לכל בקשת שאילתה. סימן הצלחה: שאילתה תקינה + קובץ שמור ב-queries/ שמצטרף לספרייה גדלה.

נתקעת?

• הסוכן לא קורא את הסכימה? ודא ש-schema.md נמצא בתיקיית העבודה של הסשן ושהשם מדויק.
• הפלט לא במבנה הרצוי? אמור ל-Claude "עדכן את הסוכן sql-writer כך ש..." — והוא יתקן את ההגדרה לתמיד.
• חוששים מנתונים רגישים? שים בתיקייה רק קובץ מדגמי מצונזר — הסוכן לא צריך את הדאטה האמיתי כדי לכתוב SQL.