إنتقل إلى المحتوى الرئيسي

وصفات الخطافات و settings.json

متوسط

وصفات جاهزة للإسقاط لأجل settings.json والأذونات والخطافات. كيّف الأوامر لتناسب بنيتك التقنية.

ملف settings.json أولي للمشروع​

.claude/settings.json (مُلتزَم به، على مستوى الفريق):

{
  "permissions": {
    "allow": [
      "Read",
      "Bash(npm run test:*)",
      "Bash(npm run lint)",
      "Bash(git status)",
      "Bash(git diff:*)"
    ],
    "ask": ["Bash(npm install:*)", "Write"],
    "deny": ["Read(./.env)", "Read(./**/*.pem)", "Bash(git push --force:*)"]
  }
}

ضع التجاوزات الشخصية أو الخاصة بالجهاز في .claude/settings.local.json (المتجاهَل من git).

التنسيق التلقائي بعد التعديلات​

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          { "type": "command", "command": "npx prettier --write \"$CLAUDE_FILE_PATH\" 2>/dev/null || true" }
        ]
      }
    ]
  }
}

بوابة جودة قبل الإنهاء​

امنع حالة "تم" حتى تنجح الاختبارات (مفهومياً — اربطها بحدث Stop/ما قبل الإنهاء وفقاً للمستندات):

{
  "hooks": {
    "Stop": [
      { "hooks": [ { "type": "command", "command": "npm test --silent" } ] }
    ]
  }
}

حراسة أمان (منع تعديل المسارات المحمية)​

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          { "type": "command", "command": "case \"$CLAUDE_FILE_PATH\" in *secrets*|*.env|*/vendor/*) echo 'blocked: protected path'; exit 1;; esac" }
        ]
      }
    ]
  }
}

:::tip اجعل الخطافات سريعة وقابلة للتكرار دون أثر جانبي إنها تعمل باستمرار. اجعلها سريعة وآمنة لإعادة التشغيل وصاخبة فقط عند المشكلات الحقيقية. :::

التالي​