/ الدليل / الملعب / Claude Code Best Practice
← كل الخوادم ↗ GitHub
● مجتمع shanraisshan ⚡ فوري

Claude Code Best Practice

بواسطة shanraisshan · shanraisshan/claude-code-best-practice

دليل عملي للانتقال من prompts مرتجلة إلى استخدام Claude على مستوى هندسي — خطط وتحقق وخطافات وتقارير ما بعد الحوادث.

claude-code-best-practice مجموعة منتقاة من الممارسات والقوالب لجعل Claude Code موثوقًا في العمل الحقيقي. نمذجة التخطيط-ثم-التنفيذ وخطافات التحقق وصيغ تقارير ما بعد الحوادث وقوائم تحقق إعادة الهيكلة. أقل كـ 'مهارة سحرية تلقائية' وأكثر كحزمة انضباط — سجّل الاشتراك، اتبع الخطوات، ثق بالمخرج.

▶ شاهد العرض 📦 التثبيت 💡 حالات الاستخدام

لماذا تستخدمه

الميزات الأساسية

عرض مباشر

كيف يبدو في الممارسة

جاهز

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "claude-best-practice-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/shanraisshan/claude-code-best-practice",
        "~/.claude/skills/claude-best-practice"
      ],
      "_inferred": true
    }
  }
}

افتح Claude Desktop → Settings → Developer → Edit Config. أعد التشغيل بعد الحفظ.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "claude-best-practice-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/shanraisshan/claude-code-best-practice",
        "~/.claude/skills/claude-best-practice"
      ],
      "_inferred": true
    }
  }
}

يستخدم Cursor نفس مخطط mcpServers مثل Claude Desktop. إعدادات المشروع أولى من الإعدادات العامة.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "claude-best-practice-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/shanraisshan/claude-code-best-practice",
        "~/.claude/skills/claude-best-practice"
      ],
      "_inferred": true
    }
  }
}

انقر على أيقونة MCP Servers في شريط Cline الجانبي، ثم "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "claude-best-practice-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/shanraisshan/claude-code-best-practice",
        "~/.claude/skills/claude-best-practice"
      ],
      "_inferred": true
    }
  }
}

نفس الصيغة مثل Claude Desktop. أعد تشغيل Windsurf لتطبيق التغييرات.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "claude-best-practice-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/shanraisshan/claude-code-best-practice",
        "~/.claude/skills/claude-best-practice"
      ]
    }
  ]
}

يستخدم Continue مصفوفة من كائنات الخادم بدلاً من خريطة.

~/.config/zed/settings.json
{
  "context_servers": {
    "claude-best-practice-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/shanraisshan/claude-code-best-practice",
          "~/.claude/skills/claude-best-practice"
        ]
      }
    }
  }
}

أضف إلى context_servers. يعيد Zed التحميل تلقائيًا عند الحفظ.

claude mcp add claude-best-practice-skill -- git clone https://github.com/shanraisshan/claude-code-best-practice ~/.claude/skills/claude-best-practice

أمر من سطر واحد. تحقق باستخدام claude mcp list. احذف باستخدام claude mcp remove.

حالات الاستخدام

استخدامات عملية: Claude Code Best Practice

إجبار تدفق تخطيط-ثم-تنفيذ على تغيير غير تافه

👤 المطورون المتعبون من agents تقتحم دون تفكير ⏱ ~30 min intermediate

متى تستخدمه: التغيير يمس أكثر من 3 ملفات أو نطاقه غير واضح.

الخطوات
  1. التخطيط
    Use claude-best-practice. Write a plan for refactoring auth: scope, sequence, risks, rollback. Do not write code yet.✓ تم النسخ
    → وثيقة خطة؛ لا كود
  2. النقد
    Critique your own plan as if you were the senior reviewer. What's missing?✓ تم النسخ
    → نقد مع إصلاحات محددة
  3. التنفيذ
    Now execute step 1 of the revised plan. Stop after that step.✓ تم النسخ
    → الخطوة 1 منجزة؛ بانتظار الموافقة

النتيجة: إعادة هيكلة تُنجَز بسلاسة لأنها فُكّرت فيها مسبقًا.

المزالق
  • الخطة مجردة جدًا — أصر على تفصيل على مستوى الملفات في الخطة

إجراء تقرير ما بعد حادث بمساعدة الـ agent

👤 فرق المناوبة / SREs ⏱ ~45 min intermediate

متى تستخدمه: حدث خطأ ما ويجب كتابة تقرير.

الخطوات
  1. الجمع
    Use the postmortem template. Pull the timeline from /logs and recent commits.✓ تم النسخ
    → الجدول الزمني مبني تلقائيًا
  2. الأسباب الخمسة
    Walk through five-whys on the root cause. Distinguish proximate from contributing.✓ تم النسخ
    → أسباب متدرجة
  3. بنود العمل
    Generate action items with owners and due dates.✓ تم النسخ
    → قائمة بنود عمل مع المسؤولين للمراجعة

النتيجة: وثيقة تقرير تساعد المرة القادمة، لا إلقاء اللوم.

المزالق
  • المسؤولون المُسنَدون تلقائيًا خاطئون — راجع دائمًا تعيينات المسؤولية قبل النشر
اجمعها مع: filesystem

استخدام قائمة تحقق الترحيل لترقية framework

👤 المطورون في ترقية رئيسية (مثلاً React 18 → 19) ⏱ ~60 min intermediate

متى تستخدمه: الترحيل يمتد على ملفات كثيرة؛ تريد عدم تفويت خطوات.

الخطوات
  1. التبني
    Apply the migration template to React 18→19. Customize for our codebase.✓ تم النسخ
    → قائمة تحقق مخصصة
  2. التتبع
    Walk through the checklist, marking done/blocked for each item.✓ تم النسخ
    → سجل تقدم

النتيجة: لا مفاجآت 'نسينا تحديث X' بعد الترحيل.

المزالق
  • قائمة التحقق تصبح قديمة — حدّثها لكل إصدار رئيسي؛ المهارة توفر الهيكل

التركيبات

اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10

claude-best-practice-skill + everything-claude-code-skill

دمج حزمتَي مهارات موجَّهتَين — prompting بأفضل الممارسات + افتراضيات بالبحث أولًا

Use claude-best-practice for plan-then-execute; everything-claude-code for research-first.✓ تم النسخ
claude-best-practice-skill + filesystem

حفظ الخطط وتقارير ما بعد الحوادث جانب الكود

Save the plan to /docs/plans/auth-refactor.md before executing.✓ تم النسخ

الأدوات

ما يوفره هذا الـ MCP

الأداةالمدخلاتمتى تستدعيهاالتكلفة
make_plan task description قبل أي تغيير غير تافه tokens
critique_plan plan بعد الخطة، قبل التنفيذ tokens
postmortem_draft logs, commits, summary بعد الحوادث tokens

التكلفة والحدود

تكلفة التشغيل

حصة API
N/A
الرموز لكل استدعاء
يضيف تكلفة مسبقة (التخطيط) لكن يقلل حلقات الإعادة
التكلفة المالية
مجاني
نصيحة
تخطَّ خطوة التخطيط في التغييرات التافهة حقًا

الأمان

الصلاحيات والأسرار ونطاق الأثر

الحد الأدنى من الصلاحيات: Read access to logs/commits for postmortems
تخزين بيانات الاعتماد: لا شيء
نقل البيانات الخارجي: لا شيء

استكشاف الأخطاء

الأخطاء الشائعة وحلولها

Plans are too generic

قدّم سياق مستودع محدد؛ المهارة ترتكز على ما تعطيها

Conflicts with team's existing process

تبنَّ بشكل انتقائي — قالب تقرير ما بعد الحادث وحده عالي القيمة

البدائل

Claude Code Best Practice مقابل البدائل

البديلمتى تستخدمهاالمقايضة
everything-claude-code-skillتريد حزمة أكمل (ذاكرة، أمان، غرائز)سطح أكبر للتعلم
Hand-rolled CLAUDE.md rulesسير عمل مخصص للغايةصيانة أكثر

المزيد

الموارد

📖 اقرأ ملف README الرسمي على GitHub

🐙 تصفح القضايا المفتوحة

🔍 تصفح أكثر من 400 خادم MCP و Skills