Skills: ربط الأدوات واستدعاؤها

// مثال على تكوين خادم MCP
{
  "mcpServers": {
    "database": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": {
        "DATABASE_URL": "postgresql://..."
      }
    },
    "browser": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-browser"]
    }
  }
}

تحليل متطلبات المهمة → تحديد الأدوات الضرورية → ربط الأدوات الضرورية فقط

مثال:
┌─────────────────┬──────────────────────┐
│ المهمة          │ الأدوات المربوطة     │
├─────────────────┼──────────────────────┤
│ مراجعة للقراءة فقط│ Read, Grep, Glob     │
│ إصلاح كود        │ Read, Edit, Bash     │
│ إعادة هيكلة مشروع│ Read, Write, Edit, Bash, Grep │
│ نشر تلقائي كامل│ جميع الأدوات + MCP      │
└─────────────────┴──────────────────────┘

## قواعد استخدام Bash

الأوامر المسموح بها:
- git status، git diff، git log
- npm test، pytest، go test
- ruff check، eslint، prettier
- docker ps، kubectl get

الأوامر المحظورة:
- rm -rf / (حذف خطير)
- curl | bash (تنفيذ نص برمجي عن بُعد)
- تصدير متغيرات بيئة تحتوي على أسرار
- أوامر تُعدّل تكوين النظام

# غير فعال: قراءة واحد تلو الآخر
1. Read src/main.py
2. Read src/utils.py
3. Read src/config.py

# فعال: استخدم Glob لتحديد النطاق أولاً، ثم قراءة مُوجّهة
1. Glob "src/**/*.py" → احصل على قائمة الملفات
2. Read الملفات الرئيسية (نقطة الدخول، التكوين، دوال الأدوات)

# غير فعال: قراءة جميع الملفات بشكل أعمى
1. Read جميع ملفات .py (أكثر من 50 ملفًا)

# فعال: بحث للتحديد أولاً
1. Grep "class.*View" → اعثر على جميع أصناف العروض
2. Grep "TODO|FIXME|HACK" → اعثر على الديون التقنية
3. Read فقط الملفات التي تحتاج فحصًا أعمق من نتائج البحث

---
name: tech-debt-scanner
description: "ماسح الديون التقنية، كشف TODO/FIXME/HACK وروائح الكود"
triggers:
  - keyword: "tech-debt"
tools:
  - Grep
  - Glob
  - Read
---

# مهارة ماسح الديون التقنية

## تدفق التنفيذ
1. استخدم Grep للبحث عن تعليقات TODO، FIXME، HACK
2. استخدم Grep للبحث عن أنماط روائح الكود (دوال طويلة جدًا، تعشيش عميق)
3. استخدم Read لفحص المشاكل عالية الأولوية بالتفصيل
4. أخرج قائمة الديون التقنية مرتبة حسب الأولوية

---
name: lint-fix
description: "إصلاح تلقائي لمشاكل أسلوب الكود"
triggers:
  - keyword: "lint-fix|fix style"
tools:
  - Read
  - Bash
  - Edit
---

# مهارة إصلاح أسلوب الكود

## تدفق التنفيذ
1. استخدم Bash لتشغيل أداة الفحص (اختيار تلقائي حسب نوع المشروع)
2. حلّل مخرجات أداة الفحص
3. للمشاكل القابلة للإصلاح التلقائي، شغّل أداة الفحص --fix
4. للمشاكل التي تتطلب إصلاحًا يدويًا، استخدم Edit للإصلاح واحدًا تلو الآخر
5. استخدم Bash لتشغيل أداة الفحص مرة أخرى للتحقق

// .claude/settings.json
{
  "permissions": {
    "allow": [
      "Read(*)",
      "Grep(*)",
      "Glob(*)",
      "Edit(src/**)",
      "Bash(npm test,pytest,git *)"
    ],
    "deny": [
      "Write(.env*)",
      "Bash(rm *)",
      "Bash(curl *)"
    ]
  }
}

# تحديد نطاق استخدام الأدوات في frontmatter المهارة
tools:
  - Read
  - Edit:
      paths: ["src/**", "tests/**"]
  - Bash:
      commands: ["pytest", "ruff check"]