Back to Planning With Files

النتائج والقرارات

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

2.37.04.8 KB
Original Source

النتائج والقرارات

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

المتطلبات

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

نتائج البحث

<!-- ماذا: اكتشافات رئيسية من بحث الويب أو قراءة التوثيق أو الاستكشاف. لماذا: المحتوى متعدد الوسائط (صور، نتائج المتصفح) لا يستمر. اكتبه فوراً. متى: بعد كل عمليتي عرض/تصفح/بحث، حدّث هذا القسم (قاعدة الإجراءين). مثال: - وحدة argparse في بايثون تدعم الأوامر الفرعية لتصميم واجهة سطر أوامر نظيفة - وحدة JSON تتعامل مع استمرار الملفات بسهولة - النمط القياسي: python script.py <command> [args] --> <!-- اكتشافات رئيسية أثناء الاستكشاف -->

القرارات التقنية

<!-- ماذا: خيارات البنية والتنفيذ التي اتخذتها، مع الأسباب. لماذا: ستنسى لماذا اخترت تقنية أو منهجاً معيناً. هذا الجدول يحفظ تلك المعرفة. متى: حدّث كلما اتخذت خياراً تقنياً مهماً. مثال: | استخدام JSON للتخزين | بسيط، مقروء بشرياً، دعم مدمج في بايثون | | argparse مع أوامر فرعية | واجهة سطر أوامر نظيفة: python todo.py add "task" | --> <!-- القرارات المتخذة مع مبرراتها -->
القرارالمبرر

المشاكل التي تمت مواجهتها

<!-- ماذا: المشاكل التي واجهتها وكيف حللتها. لماذا: مشابه للأخطاء في task_plan.md، لكن يركز على مشاكل أوسع (ليس فقط أخطاء البرمجة). متى: وثّق عندما تواجه عوائق أو تحديات غير متوقعة. مثال: | الملف الفارغ يسبب JSONDecodeError | أُضيف فحص صريح للملف الفارغ قبل json.load() | --> <!-- الأخطاء وكيف تم حلها -->
المشكلةالحل

الموارد

<!-- ماذا: عناوين URL ومسارات الملفات ومراجع API وروابط التوثيق التي وجدتها مفيدة. لماذا: مرجع سهل لاحقاً. لا تفقد روابط مهمة في السياق. متى: أضف كلما اكتشفت موارد مفيدة. مثال: - توثيق argparse في بايثون: https://docs.python.org/3/library/argparse.html - هيكل المشروع: src/main.py، src/utils.py --> <!-- عناوين URL ومسارات الملفات ومراجع API -->

نتائج بصرية/المتصفح

<!-- ماذا: معلومات تعلمتها من عرض الصور أو ملفات PDF أو نتائج المتصفح. لماذا: بالغ الأهمية - المحتوى البصري/متعدد الوسائط لا يستمر في السياق. يجب التقاطه كنص. متى: فوراً بعد عرض الصور أو نتائج المتصفح. لا تنتظر! مثال: - لقطة الشاشة تُظهر أن نموذج تسجيل الدخول يحتوي على حقلي البريد الإلكتروني وكلمة المرور - المتصفح يُظهر أن API يُعيد JSON بمفتاحي "status" و "data" --> <!-- بالغ الأهمية: حدّث بعد كل عمليتي عرض/تصفح --> <!-- المحتوى متعدد الوسائط يجب التقاطه كنص فوراً -->

<!-- تذكير: قاعدة الإجراءين بعد كل عمليتي عرض/تصفح/بحث، يجب عليك تحديث هذا الملف. هذا يمنع فقدان المعلومات البصرية عند إعادة تعيين السياق. -->

حدّث هذا الملف بعد كل عمليتي عرض/تصفح/بحث هذا يمنع فقدان المعلومات البصرية