أمثلة
خطّاف أدنى
مثال خطّاف <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)