Skip to content
Apothem
أمثلة

خطّاف أدنى

مثال خطّاف <bdi>Apothem</bdi> أدنى — إطلاق فحص عند كل كتابة ملف.

يُظهِر هذا المثال أصغر خطّاف Apothem ممكن: خطّاف PreToolUse يُطلَق قبل كل استدعاء لأداة Write ويُسجِّل المسار الهدف.

نص الخطّاف

# src/apothem/hooks/log_writes.py
import json, sys

data = json.load(sys.stdin)
path = data.get("tool_input", {}).get("file_path", "unknown")
print(f"[apothem] Writing to: {path}", file=sys.stderr)
sys.exit(0)  # exit 0 = proceed; non-zero = block

التسجيل في settings.json

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Write",
        "hooks": [
          {
            "type": "command",
            "command": "python src/apothem/hooks/log_writes.py"
          }
        ]
      }
    ]
  }
}

اختبار الخطّاف

أجرِ أي كتابة ملف في Claude Code وراقب خرج stderr في لوحة تتبّع الخطّاف.

حجب الكتابات

غيِّر sys.exit(0) إلى sys.exit(1) واطبع كتلة JSON للحجب إلى stdout:

print(json.dumps({"decision": "block", "reason": "blocked by log_writes"}))
sys.exit(1)

On this page