/ الدليل / الملعب / CCPM (Claude Code Project Mgmt)
← كل الخوادم ↗ GitHub
● مجتمع automazeio ⚡ فوري

CCPM (Claude Code Project Mgmt)

بواسطة automazeio · automazeio/ccpm

استخدم GitHub Issues + Git worktrees كطبقة إدارة مشروع لـ Claude Code — كل issue يصبح branch، كل وكيل يعمل معزولاً، لا تلوث متبادل.

CCPM (Claude Code Project Management) يعامل GitHub Issues كوحدة عمل لوكلاء AI البرمجية. كل issue يحصل على Git worktree خاص (branch + checkout معزول)، حتى تتمكن جلسات Claude المتعددة من العمل بالتوازي بدون تدخّل. المهارة توفر أوامر لإنشاء issues من prompts والمطالبة بها وشحنها كـ PRs والتنظيف. مُصمَّم للمطورين المنفردين الذين يشغّلون عدة تبويبات Claude في آنٍ واحد.

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

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

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

عرض مباشر

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

جاهز

التثبيت

اختر العميل

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

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

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

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

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

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

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

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

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

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

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

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

claude mcp add ccpm-skill -- git clone https://github.com/automazeio/ccpm ~/.claude/skills/ccpm

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

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

استخدامات عملية: CCPM (Claude Code Project Mgmt)

تشغيل 3 جلسات Claude على 3 issues مختلفة في آنٍ واحد

👤 المؤسسون المنفردون، المطورون المستقلون ⏱ ~60 min intermediate

متى تستخدمه: لديك 5 issues صغيرة؛ فعلها بالتسلسل بطيء لكن تبديل الـ branches يكسر الحالة.

المتطلبات الأساسية
  • gh CLI مُصادَق عليه — gh auth login — تحقق بـ gh repo view
  • المهارة مثبّتة — git clone https://github.com/automazeio/ccpm ~/.claude/skills/ccpm
الخطوات
  1. اختيار الـ issues
    Use ccpm. List open issues; recommend 3 small ones I can do in parallel today.✓ تم النسخ
    → 3 issues مع تقدير تقريبي، لا عوائق بينها
  2. بدؤها
    Start issue #42, #43, #45 each in its own worktree. Open 3 Claude Code sessions ready.✓ تم النسخ
    → 3 worktrees منشأة في ../wt-42 وما شابه؛ كل جلسة تعرف أي issue تمتلكه
  3. شحنها
    (In each session) When done — /ship — push branch and open PR linked to the issue.✓ تم النسخ
    → PR منشأ ومرتبط بالـ issue، CI يبدأ

النتيجة: ثلاثة issues مُغلَقة بنهاية اليوم بدون ألم تبديل الـ branches.

المزالق
  • الـ issues تلمس ملفات متداخلة → تعارضات دمج — المهارة تُحذّر عند تداخل ملفات الـ issues المختارة؛ اختر غير المتداخلة للتوازي
اجمعها مع: github

تحويل فكرة عشوائية إلى issue محدد النطاق

👤 أي شخص مع فيض من الأفكار ⏱ ~5 min beginner

متى تستخدمه: تستمر في كتابة 'أوه وأيضاً يجب أن...' في المحادثة. التقطها كـ issues مناسبة.

الخطوات
  1. الالتقاط
    Use ccpm. I want to add JSON export to the dashboard. Create an issue with rationale, acceptance criteria, and a rough plan.✓ تم النسخ
    → issue منسّق بشكل جيد منشأ على GitHub
  2. الربط
    Link to related issues if any.✓ تم النسخ
    → الارتباطات مضافة

النتيجة: الأفكار تصبح issues يمكنك فرزها لاحقاً.

المزالق
  • الـ issues تصبح طويلة جداً — المهارة تفرض حداً أقصى 200 كلمة لنص الـ issue
اجمعها مع: github

التخلي عن issue بدأت فيه بدون ترك branches رائدة

👤 أي شخص جرّب شيئاً وأعاد التفكير ⏱ ~2 min beginner

متى تستخدمه: بعد 30 دقيقة على issue تدرك أن النهج خاطئ؛ تريد الانسحاب بنظافة.

الخطوات
  1. التخلي
    /abandon. Remove the worktree, delete the branch, close the issue with a comment explaining why.✓ تم النسخ
    → worktree محذوف، branch محذوف، issue مُغلَق مع شرح

النتيجة: لا branches يتيمة تطارد المستودع.

المزالق
  • أردت في الواقع الاحتفاظ ببعض العمل — المهارة تحفظ patch تحت /tmp/ccpm-stashes قبل الحذف — قابل للاسترداد لـ ~7 أيام
اجمعها مع: github

التركيبات

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

ccpm-skill + github

التأكد من أن CCPM وGitHub MCP متوافقان على حالة الـ issue

Sync issue state after every /ship to ensure project boards reflect.✓ تم النسخ
ccpm-skill + memorix-mcp

نقل السياق عبر worktrees

When starting an issue, recall any memorix entries tagged with this issue's component.✓ تم النسخ

الأدوات

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

الأداةالمدخلاتمتى تستدعيهاالتكلفة
list filters إيجاد عمل 0
start issue_number بدء العمل على issue 0
ship issue_number? انتهيت؛ جاهز لـ PR 0
abandon issue_number, reason الانسحاب بنظافة 0

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

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

حصة API
مرتبط بحدود GitHub API (5000/ساعة مع مصادقة)
الرموز لكل استدعاء
خفيف — معظم العمليات git + gh CLI
التكلفة المالية
مجاني
نصيحة
لا تُفرط في إنشاء الـ issues — المهارة تشجع على التقاط الأفكار لكن ليس كل فكرة صغيرة

الأمان

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

الحد الأدنى من الصلاحيات: repo (for issue + PR write)
تخزين بيانات الاعتماد: عبر gh auth
نقل البيانات الخارجي: GitHub API
لا تمنح أبدًا: admin:org

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

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

git worktree add يفشل: مستخدم بالفعل

worktree سابق لا يزال موجوداً؛ نظّف بـ git worktree prune

تحقق: `git worktree list`
gh PR create يُخطئ بـ 'no commits between'

أنشئ التزاماً واحداً على الأقل على branch الـ worktree قبل /ship

جلستان تدّعيان نفس الـ issue

المهارة تكتب lockfile لكل issue — البدء الثاني يفشل برسالة واضحة

البدائل

CCPM (Claude Code Project Mgmt) مقابل البدائل

البديلمتى تستخدمهاالمقايضة
Linear MCPأنت على Linear لا GitHub IssuesCCPM لـ GitHub فقط؛ Linear MCP له نظام بيئي خاص
`git worktree` عادي + قائمة تحققتشغّل وكيلاً واحداً فقط في آنٍ واحديدوي؛ CCPM يُؤتمت دورة الحياة

المزيد

الموارد

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

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

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