Back to Planning With Files

خطة المهمة: [وصف مختصر]

skills/planning-with-files-ar/templates/task_plan.md

2.37.06.4 KB
Original Source

خطة المهمة: [وصف مختصر]

<!-- ماذا: هذه خارطة طريقك للمهمة بأكملها. فكر فيها كـ "ذاكرتك العاملة على القرص". لماذا: بعد أكثر من 50 استدعاء أداة، قد تُنسى أهدافك الأصلية. هذا الملف يبقيها حاضرة. متى: أنشئ هذا أولاً، قبل بدء أي عمل. حدّث بعد إكمال كل مرحلة. -->

الهدف

<!-- ماذا: جملة واحدة واضحة تصف ما تحاول تحقيقه. لماذا: هذا نجمك القطبي. إعادة قراءته تبقيك مركزاً على الحالة النهائية. مثال: "إنشاء تطبيق مهام يومية بواجهة سطر أوامر بلغة بايثون مع وظائف الإضافة والعرض والحذف." -->

[جملة واحدة تصف الحالة النهائية]

المرحلة الحالية

<!-- ماذا: أي مرحلة تعمل عليها حالياً (مثلاً "المرحلة 1"، "المرحلة 3"). لماذا: مرجع سريع لمكانك في المهمة. حدّث هذا أثناء تقدمك. -->

المرحلة 1

المراحل

<!-- ماذا: قسّم مهمتك إلى 3-7 مراحل منطقية. يجب أن تكون كل مرحلة قابلة للإكمال. لماذا: تقسيم العمل إلى مراحل يمنع الإرهاق ويجعل التقدم مرئياً. متى: حدّث الحالة بعد إكمال كل مرحلة: pending → in_progress → complete -->

المرحلة 1: المتطلبات والاكتشاف

<!-- ماذا: افهم ما يجب القيام به واجمع المعلومات الأولية. لماذا: البدء بدون فهم يؤدي إلى جهد ضائع. هذه المرحلة تمنع ذلك. -->
  • فهم نية المستخدم
  • تحديد القيود والمتطلبات
  • توثيق النتائج في findings.md
  • الحالة: in_progress
<!-- قيم الحالة: - pending: لم يبدأ بعد - in_progress: يعمل عليه حالياً - complete: أُكملت هذه المرحلة -->

المرحلة 2: التخطيط والهيكلة

<!-- ماذا: قرر كيف ستعالج المشكلة وما الهيكل الذي ستستخدمه. لماذا: التخطيط الجيد يمنع إعادة العمل. وثّق القرارات لتتذكر لماذا اخترتها. -->
  • تحديد المنهج التقني
  • إنشاء هيكل المشروع إذا لزم الأمر
  • توثيق القرارات مع مبرراتها
  • الحالة: pending

المرحلة 3: التنفيذ

<!-- ماذا: بناء/إنشاء/كتابة الحل فعلياً. لماذا: هنا يحدث العمل. قسّم إلى مهام فرعية أصغر إذا لزم الأمر. -->
  • تنفيذ الخطة خطوة بخطوة
  • كتابة التعليمات البرمجية إلى الملفات قبل التنفيذ
  • الاختبار بشكل تدريجي
  • الحالة: pending

المرحلة 4: الاختبار والتحقق

<!-- ماذا: تحقق أن كل شيء يعمل ويحقق المتطلبات. لماذا: اكتشاف المشاكل مبكراً يوفر الوقت. وثّق نتائج الاختبار في progress.md. -->
  • التحقق من تحقيق جميع المتطلبات
  • توثيق نتائج الاختبار في progress.md
  • إصلاح أي مشاكل تم اكتشافها
  • الحالة: pending

المرحلة 5: التسليم

<!-- ماذا: المراجعة النهائية والتسليم للمستخدم. لماذا: يضمن عدم نسيان أي شيء واكتمال المخرجات. -->
  • مراجعة جميع ملفات المخرجات
  • التأكد من اكتمال المخرجات
  • التسليم للمستخدم
  • الحالة: pending

الأسئلة الرئيسية

<!-- ماذا: أسئلة مهمة تحتاج للإجابة عليها أثناء المهمة. لماذا: هذه توجه بحثك واتخاذ قراراتك. أجب عنها أثناء سير العمل. مثال: 1. هل يجب أن تستمر المهام بين الجلسات؟ (نعم - يحتاج تخزين ملفات) 2. ما صيغة تخزين المهام؟ (ملف JSON) -->
  1. [سؤال للإجابة عليه]
  2. [سؤال للإجابة عليه]

القرارات المتخذة

<!-- ماذا: القرارات التقنية والتصميمية التي اتخذتها، مع أسبابها. لماذا: ستنسى لماذا اتخذت خياراتك. هذا الجدول يساعدك على التذكر وتبرير القرارات. متى: حدّث كلما اتخذت خياراً مهماً (تقنية، منهج، هيكل). مثال: | استخدام JSON للتخزين | بسيط، مقروء بشرياً، دعم مدمج في بايثون | -->
القرارالمبرر

الأخطاء التي تمت مواجهتها

<!-- ماذا: كل خطأ واجهته، ما رقم المحاولة، وكيف حللته. لماذا: تسجيل الأخطاء يمنع تكرار نفس الأخطاء. هذا أمر بالغ الأهمية للتعلم. متى: أضف فوراً عند حدوث خطأ، حتى لو أصلحته بسرعة. مثال: | FileNotFoundError | 1 | التحقق من وجود الملف، إنشاء قائمة فارغة إذا لم يوجد | | JSONDecodeError | 2 | معالجة حالة الملف الفارغ بشكل صريح | -->
الخطأالمحاولةالحل
1

ملاحظات

<!-- تذكيرات: - حدّث حالة المرحلة أثناء تقدمك: pending → in_progress → complete - أعد قراءة هذه الخطة قبل القرارات الرئيسية (توجيه الانتباه) - سجّل جميع الأخطاء - فهي تساعد في تجنب التكرار - لا تكرر إجراءً فاشلاً - غيّر منهجك بدلاً من ذلك -->
  • حدّث حالة المرحلة أثناء تقدمك: pending → in_progress → complete
  • أعد قراءة هذه الخطة قبل القرارات الرئيسية (توجيه الانتباه)
  • سجّل جميع الأخطاء - فهي تساعد في تجنب التكرار