Hooks — גבולות דטרמיניסטיים

מה זה Hook?

Hook הוא סקריפט בכל שפה (Python, TypeScript, Bash ועוד) שמוגדר לרוץ על אירוע מסוים. לדוגמה: לפני שClaude משתמש בכלי כלשהו, Hook יכול לבדוק את הקלט ולחסום גישה לקבצים רגישים.

האירועים הנתמכים

אירועי סשן:

אירועי כלים:

אירועי context:

אירועי agents:

אירועי worktree ואחרים:

הגדרת Hook — קובץ JSON

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Read",
        "hooks": [
          {
            "type": "command",
            "command": "python /path/to/block-env.py"
          }
        ]
      }
    ]
  }
}

דוגמה: חסימת גישה לקובץ .env

# block-env.py
import json
import sys
 
input_data = json.load(sys.stdin)
file_path = input_data.get('tool_input', {}).get('file_path', '')
 
if '.env' in file_path:
    print(json.dumps({
        "decision": "block",
        "reason": "גישה לקובץ .env חסומה מטעמי אבטחה"
    }))
    sys.exit(0)
 
print(json.dumps({"decision": "approve"}))

AI סטטיסטי (לא בטוח שיקרה) vs Hooks דטרמיניסטיים

מקרי שימוש נפוצים

• חסימת .env — מניעת חשיפת secrets
• בדיקת לוגינג — רישום כל פעולה לביקורת
• גיבוי אוטומטי — snapshot לפני שינויים גדולים
• הודעות Slack — התראה כאשר Claude מסיים משימה
• בדיקת תאימות — וידוא שקוד עוקב אחרי conventions

עיקרון המפתח

צפייה ב-hooks מוגדרים — /hooks

הפקודה /hooks מציגה רשימה של כל ה-hooks בפרויקט — פעילים ולא פעילים. לכל hook מוצג האירוע שהוא מאזין לו, ה-matcher, ומאיזה קובץ הגדרות הוא נטען. שימושי לדיבוג כשhook לא מתנהג כמצופה.