/ الدليل / الملعب / 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

التثبيت

مستودع المؤلف · وثائق Claude Skills الرسمية

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

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

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

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

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

الخطوات
  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 بشكل دوري حتى لا ينمو بلا حد عبر المشاريع الطويلة.

الأمان

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

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

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

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

يتم التزام الملفات الثلاثة بـ 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