planning-with-files-ar（使用文件 ar 进行规划）

نظام تخطيط الملفات

العمل بنمط Manus: استخدام ملفات Markdown المستمرة كـ «ذاكرة عمل على القرص».

الخطوة الأولى: استعادة السياق (v2.2.0)

قبل فعل أي شيء، تحقق من وجود ملفات التخطيط واقرأها:

1. إذا كان task_plan.md موجودًا، اقرأ فورًا task_plan.md و progress.md و findings.md.
2. ثم تحقق مما إذا كانت الجلسة السابقة تحتوي على سياق غير متزامن:

# Linux/macOS
$(command -v python3 || command -v python) ${CLAUDE_PLUGIN_ROOT}/scripts/session-catchup.py "$(pwd)"

# Windows PowerShell
& (Get-Command python -ErrorAction SilentlyContinue).Source "$env:USERPROFILE\.claude\skills\planning-with-files-ar\scripts\session-catchup.py" (Get-Location)

إذا أظهر تقرير الاستعادة وجود سياق غير متزامن:

1. نفذ git diff --stat لرؤية تغييرات الكود الفعلية
2. اقرأ ملفات التخطيط الحالية
3. حدّث ملفات التخطيط بناءً على تقرير الاستعادة و git diff
4. ثم تابع المهمة

مهم: موقع تخزين الملفات

• القوالب موجودة في ${CLAUDE_PLUGIN_ROOT}/templates/
• ملفات التخطيط الخاصة بك توضع في دليل مشروعك

البدء السريع

قبل أي مهمة معقدة:

1. أنشئ task_plan.md — راجع قالب templates/task_plan.md
2. أنشئ findings.md — راجع قالب templates/findings.md
3. أنشئ progress.md — راجع قالب templates/progress.md
4. أعد قراءة الخطة قبل القرارات — حدّث الأهداف في نافذة الانتباه
5. حدّث بعد كل مرحلة — علّم المكتمل، سجّل الأخطاء

ملاحظة: ملفات التخطيط توضع في جذر مشروعك، وليس في دليل تثبيت المهارة.

النمط الأساسي

نافذة السياق = الذاكرة (متقلبة، محدودة)
نظام الملفات = القرص (مستمر، غير محدود)

→ أي محتوى مهم يُكتب على القرص.

الغرض من الملفات

القواعد الأساسية

1. أنشئ الخطة أولاً

لا تبدأ أبدًا مهمة معقدة بدون task_plan.md. بلا استثناءات.

2. قاعدة الخطوتين

"بعد كل عمليتي بحث/تصفح، احفظ الاكتشافات المهمة فورًا في ملف."

هذا يمنع فقدان المعلومات البصرية/متعددة الوسائط.

3. اقرأ قبل القرار

قبل اتخاذ قرار مهم، اقرأ ملفات التخطيط. هذا يجعل الأهداف تظهر في نافذة انتباهك.

4. حدّث بعد العمل

بعد اكتمال أي مرحلة:

• علّم حالة المرحلة: in_progress → complete
• سجّل أي أخطاء واجهتك
• دوّن الملفات التي تم إنشاؤها/تعديلها

5. سجّل جميع الأخطاء

كل خطأ يجب كتابته في ملف التخطيط. هذا يبني المعرفة ويمنع التكرار.

## الأخطاء التي تمت مواجهتها
| الخطأ | عدد المحاولات | الحل |
|------|---------|---------|
| FileNotFoundError | 1 | تم إنشاء إعداد افتراضي |
| انتهاء مهلة API | 2 | تمت إضافة منطق إعادة المحاولة |

6. لا تكرر الفشل أبدًا

if فشل العملية:
    الخطوة التالية != نفس العملية

سجّل ما جربته، وغيّر النهج.

7. تابع بعد الاكتمال

عندما تنتهي جميع المراحل لكن المستخدم يطلب عملًا إضافيًا:

• أضف مراحل في task_plan.md (مثل المرحلة 6، المرحلة 7)
• سجّل إدخال جلسة جديد في progress.md
• تابع سير العمل المخطط كالمعتاد

بروتوكول الفشل الثلاثي

المحاولة 1: التشخيص والإصلاح
  → اقرأ الخطأ بعناية
  → اعثر على السبب الجذري
  → إصلاح مستهدف

المحاولة 2: نهج بديل
  → نفس الخطأ؟ جرّب طريقة مختلفة
  → أداة مختلفة؟ مكتبة مختلفة؟
  → لا تكرر أبدًا نفس الفشل تمامًا

المحاولة 3: إعادة التفكير
  → شكّك في الافتراضات
  → ابحث عن حلول
  → فكّر في تحديث الخطة

بعد 3 فشل: اطلب من المستخدم
  → اشرح ما جربته
  → شارك الخطأ المحدد
  → اطلب التوجيه

مصفوفة قرار القراءة vs الكتابة

اختبار إعادة التشغيل بخمسة أسئلة

إذا استطعت الإجابة على هذه الأسئلة، فإن إدارة سياقك سليمة:

متى تستخدم هذا النمط

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

• مهام متعددة الخطوات (أكثر من 3 خطوات)
• مهام البحث
• بناء/إنشاء مشاريع
• مهام تمتد عبر استدعاءات أدوات متعددة
• أي عمل يحتاج تنظيمًا

حالات التخطي:

• أسئلة بسيطة
• تعديل ملف واحد
• استعلامات سريعة

القوالب

انسخ هذه القوالب للبدء:

• templates/task_plan.md — تتبع المراحل
• templates/findings.md — تخزين البحث
• templates/progress.md — سجل الجلسة

النصوص البرمجية

نصوص برمجية مساعدة للأتمتة:

• scripts/init-session.sh — تهيئة جميع ملفات التخطيط
• scripts/check-complete.sh — التحقق من اكتمال جميع المراحل
• scripts/session-catchup.py — استعادة السياق من الجلسة السابقة (v2.2.0)

الحدود الأمنية

تستخدم هذه المهارة خطاف PreToolUse لإعادة قراءة task_plan.md قبل كل استدعاء أداة. المحتوى المكتوب في task_plan.md يُحقن بشكل متكرر في السياق، مما يجعله هدفًا ذا قيمة عالية للحقن غير المباشر عبر المطالبات.

الأنماط المضادة