/ الدليل / الملعب / planning-with-files
← كل الخوادم ↗ GitHub
● مجتمع OthmanAdi ⚡ فوري

planning-with-files

بواسطة OthmanAdi · OthmanAdi/planning-with-files

يجبر هذا الحل Claude على استخدام ملفات markdown على القرص الصلب كذاكرة دائمة — task_plan.md و findings.md و progress.md — بدلاً من فقدان الحالة عند إعادة تعيين السياق.

أداة Claude Code تطبق نمط التخطيط ثلاثي الملفات من Manus AI. عند تثبيتها، يكتب Claude تلقائياً task_plan.md قبل بدء العمل متعدد الخطوات، ويسجل الاكتشافات في findings.md، ويحدث progress.md طوال الجلسة. تظهر المعايير معدل نجاح 96.7٪ مقابل 6.7٪ بدونها في المهام متعددة الخطوات. الأفضل للعمل الذي يمتد إلى 3 خطوات أو أكثر أو العديد من استدعاءات الأدوات.

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

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

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

عرض مباشر

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

planning-with-files-skill.replay ▶ جاهز
0/0

التثبيت

اختر العميل

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

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

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

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

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

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

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

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

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

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

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

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

claude mcp add planning-with-files-skill -- git clone https://github.com/OthmanAdi/planning-with-files ~/.claude/skills/planning-with-files

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

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

استخدامات عملية: planning-with-files

تشغيل إعادة هيكلة متعددة الأيام دون فقدان خط التفكير

👤 المهندسون الذين يقومون بالترحيل أو إعادة الهيكلة الكبيرة باستخدام Claude Code ⏱ ~30 min intermediate

متى تستخدمه: عندما تقوم بتقسيم أحادي الكتل، أو ترحيل إطار عمل، أو القيام بأي شيء يستغرق أكثر من جلسة واحدة.

المتطلبات الأساسية
  • أداة مستنسخة إلى ~/.claude/skills/planning-with-files — git clone https://github.com/OthmanAdi/planning-with-files ~/.claude/skills/planning-with-files
الخطوات
  1. ابدأ العمل باستخدام الأداة بشكل صريح
    نحن نرحل وحدة المصادقة من JWT إلى ملفات تعريف الجلسة. استخدم أداة planning-with-files لتخطيط هذا قبل أن تبدأ.✓ تم النسخ
    → يكتب Claude task_plan.md بالمراحل قبل لمس الكود
  2. اترك Claude يعمل؛ توقف واستأنف على مدار الأيام
    استئنف من حيث توقفنا — اقرأ progress.md واستمر.✓ تم النسخ
    → يعيد Claude قراءة الخطة ويعرف بالضبط ما هي المرحلة التالية
  3. راجع findings.md للمفاجآت
    لخص findings.md — هل هناك شيء غير الخطة الأصلية؟✓ تم النسخ
    → قائمة بالاكتشافات التي كانت ستُفقد بخلاف ذلك

النتيجة: إعادة هيكلة تتحمل إعادة تعيين السياق مع مسار تدقيق يمكنك فعلاً مراجعته.

المزالق
  • تطبيق الأداة على تعديلات تافهة بسطر واحد، مما يضيف عبئاً إضافياً — أخبر Claude 'تجاوز planning-with-files، هذا إصلاح لمرة واحدة'
اجمعها مع: filesystem · git

إجراء تحقيق بحثي بوثيقة نتائج دائمة

👤 أي شخص يستخدم Claude للبحث متعدد المصادر ⏱ ~45 min beginner

متى تستخدمه: عندما ستطلب من Claude جمع المعلومات من مصادر متعددة وتركيبها.

الخطوات
  1. ابدأ بسؤال بحثي
    ابحث عن كيف تتعامل محددات المعدل الحديثة مع حركة المرور المفاجئة. استخدم planning-with-files — أريد أن يتراكم findings.md على مدار الجلسة.✓ تم النسخ
    → يكتب Claude findings.md بشكل تراكمي أثناء البحث
  2. اطلب تركيباً في النهاية
    الآن ركب findings.md في موجز بصفحة واحدة.✓ تم النسخ
    → موجز مستند على الملاحظات الدائمة، وليس مختلقاً

النتيجة: وثيقة نتائج يمكنك إعادة استخدامها وموجز مدعوم بها.

المزالق
  • يتضخم findings.md بضوضاء — وجه Claude للتقليص إلى الإشارات فقط عند حدود المرحلة
اجمعها مع: firecrawl · fetch

التركيبات

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

planning-with-files-skill + filesystem

تكتب الأداة ملفات markdown؛ يسمح filesystem MCP بـ Claude بتحرير الكود أيضاً في نفس الجلسة

استخدم planning-with-files للتخطيط، ثم طبق الإصلاحات على المستودع عبر filesystem.✓ تم النسخ
planning-with-files-skill + git

التزم progress.md و findings.md عند حدود المرحلة حتى يكون لديك مسار دائم عبر الآلات

نهاية المرحلة — التزم ملفات التخطيط الثلاثة برسالة تلخص ما تم إنجازه.✓ تم النسخ

الأدوات

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

الأداةالمدخلاتمتى تستدعيهاالتكلفة
create_plan task description في بداية أي مهمة بها 3 خطوات أو أكثر 0 — local file write
log_finding discovery text في كل مرة يظهر البحث شيئاً يستحق الذاكرة 0
update_progress step completed بعد كل استدعاء أداة أو مرحلة مهمة 0
resume_session none في بداية أي جلسة متابعة في نفس دليل العمل 0

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

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

حصة API
لا شيء
الرموز لكل استدعاء
متواضع — تستهلك الملفات الثلاثة رموزاً عند إعادة القراءة، عادة تحت 2000 لكل منها
التكلفة المالية
مجاني — الأداة عبارة عن دوافع خالصة وسكريبتات الخطاف
نصيحة
دع Claude يقلص progress.md بشكل دوري حتى لا ينمو بلا حد عبر المشاريع الطويلة.

الأمان

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

تخزين بيانات الاعتماد: لا بيانات اعتماد — الأداة عبارة عن دوافع خالصة وعمليات ملفات محلية
نقل البيانات الخارجي: لا شيء — تبقى جميع الحالات على قرصك في دليل العمل

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

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

Claude لا يستخدم الأداة ولا ينشئ task_plan.md

اذكره باسمه في موجهك: 'استخدم أداة planning-with-files'. تأكد من أن النسخة هبطت في ~/.claude/skills/planning-with-files.

تحقق: ls ~/.claude/skills/planning-with-files/SKILL.md
لا تعمل الخطافات بين استدعاءات الأدوات

تحقق من أن بيانات SKILL.md السابقة سليمة؛ أعد التثبيت إذا كانت النسخة جزئية.

تحقق: head ~/.claude/skills/planning-with-files/SKILL.md
يتم التزام الملفات الثلاثة بـ git عن طريق الخطأ

أضف task_plan.md و findings.md و progress.md إلى .gitignore.

تحقق: git check-ignore task_plan.md

البدائل

planning-with-files مقابل البدائل

البديلمتى تستخدمهاالمقايضة
skillforgeعندما تريد أداة لإنشاء أدوات أخرى، وليس فقط التخطيطهدف مختلف — يبني skillforge الأدوات؛ planning-with-files تشغل المهام
Native TodoWrite toolعندما تكون مهام في السياق خفيفة الوزن كافية ولا تحتاج إلى استمرارية عبر الجلساتمجاني لكنه يتلاشى عند إعادة تعيين السياق

المزيد

الموارد

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

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

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