حزم مهام الذكاء الاصطناعي: تعليمات أفضل ومعايير القبول

Table of Contents
العودة إلى دورة سير العمل العملي للذكاء الاصطناعي
تصف التعليمات الجيدة العمل وطريقة تقييمك للنتيجة. زيادة الكلمات لا تعالج غياب النطاق. يحوّل هذا الدرس طلباً مبهماً إلى حزمة مهام لمختبر الدورة.
هدف التعلم: ستكتب حزمة مهام محددة تتضمن المصدر ونطاق الملفات والفحوصات وشرط التوقف.
أهم النقاط
- النتيجة تسمي العنصر أو السلوك المطلوب.
- النطاق يحدد الملفات المسموح بها والإجراءات المستثناة.
- المصدر يحدد المتطلب المعتمد.
- فحوصات القبول تجعل النجاح قابلاً للملاحظة.
- شروط التوقف تمنع التخمين والعمل اللاحق غير المعتمد.
قبل أن تبدأ
المتطلبات المسبقة: ملفات المختبر المستخرجة، وملف docs/requirements.md فيها، و
درس سياق المستودع
. خصص 30 دقيقة. المستوى مبتدئ. ينتهي التمرين بحزمة مكتوبة. لا تحتاج إلى تعديل الشيفرة بعد.
قارن بين طلبين
طلب مبهم: «حسّن سكربت المهام». قد يعيد الوكيل كتابة المخرجات أو يضيف تبعيات أو يعدل بيانات المثال أو يتجاوز الاختبارات. لا يحدد الطلب أياً من هذه الخيارات.
طلب محدد: «أضف مرشح حالة اختياري إلى task_report.py وفق المراجعة 1 من docs/requirements.md. أبقِ المخرجات الافتراضية كما هي. أضف اختبارات. لا تعدل بيانات المثال. توقف قبل إجراء الالتزام». يختار الوكيل تفاصيل التنفيذ، بينما تحدد المهمة معنى النجاح.
| جزء الحزمة | مثال المختبر | الفحص |
|---|---|---|
| النتيجة | أضف --status إلى التقرير | تعمل القيمتان المقبولتان |
| المصدر | docs/requirements.md، المراجعة 1 | تطابق الشيفرة القيم المعتمدة |
| النطاق | البرنامج والاختبارات فقط | لا يتضمن diff ملفات أخرى |
| القيود | أبقِ المخرجات الافتراضية وبيانات المثال | تبقى المخرجات الأساسية Total tasks: 4 |
| الدليل | أمر الاختبار والتشغيل اليدوي | تطابق المخرجات الأعداد المتوقعة |
| التوقف | لا تجرِ commit أو push | لا يتغير سجل Git أو المستودع البعيد |
استخدم قالباً قابلاً لإعادة الاستخدام
انسخ هذا القالب لمهمة برمجة أو بحث صغيرة. احذف الحقول غير ذات الصلة بدلاً من ملئها بنص مبهم.
Outcome:
Authoritative source and revision:
Relevant files or records:
Allowed changes:
Excluded changes and actions:
Examples of desired behavior:
Completion checks:
Stop or ask when:
Report back with:
في المختبر، تبدو الحزمة المكتملة كما يلي:
Outcome: Add an optional --status filter to task_report.py.
Source: docs/requirements.md, revision 1.
Relevant files: task_report.py, tasks.json, tests/.
Allowed changes: task_report.py and focused tests.
Excluded: tasks.json, new dependencies, commits, pushes.
Examples: no filter prints Total tasks: 4. Open and done each print 2.
Checks: run unit tests and four manual commands: no filter, open, done, and invalid.
The invalid value must exit nonzero with a clear error.
Stop or ask: source conflict, missing file, unrelated failing baseline.
Report: changed files, commands, observed outputs, unresolved issues.
على Windows، استخدم py -3 في أوامر الحزمة إذا كانت بيئتك تستخدم مشغّل Python.
لا تحدد الحزمة كل سطر من الشيفرة. فهي تترك للوكيل اختيار تنفيذ صغير، مع إبقاء النتيجة قابلة للتحقق.
أضف الأمثلة بعناية
يقلل المثال الدقيق الالتباس. تحدد أمثلة open وdone المخرجات لملف المهام الأربع المرفق. ولا تضع قاعدة عامة لكل الملفات. في ملف آخر تعتمد الأعداد على سجلاته.
افصل بين المتوقع والملحوظ. قبل تشغيل البرنامج، تكون Total tasks: 2 النتيجة المتوقعة لكل حالة. بعد تشغيله، يصبح ناتج الطرفية ملاحظة فعلية. إذا اختلفت القيم، افحص البيانات والتنفيذ قبل إعلان النجاح.
تدرب على شرط التوقف
افترض أن ملف المتطلبات مفقود. تسميه الحزمة مصدراً معتمداً. توقف واطلب المتطلب بدلاً من استنتاج القيم المقبولة من محادثة قديمة أو مسألة نموذجية.
افترض أن الاختبارات الأساسية تفشل قبل التعديل. سجل الإخفاق واسأل إن كان ينبغي إصلاح الحالة الأولية أولاً. لا توضح نتيجة ناجحة لاحقاً إن كان سبب الفرق هو المرشح أم الحالة الأولية.
افترض أن الوكيل يريد إجراء commit. تستثني الحزمة عمليات الالتزام. اطلب منه التوقف بعد diff والاختبارات. وأنت تقرر إن كان الالتزام اللاحق يناسب سير عمل المشروع.
افحص الحزمة
امنح نقطة لكل إجابة: هل النتيجة محددة؟ هل سمي المصدر الحاكم؟ هل نطاق الملفات واضح؟ هل ورد فحصان قابلان للملاحظة على الأقل؟ هل يوجد شرط للتوقف؟ إذا كانت النتيجة أقل من خمس نقاط، فراجع الحزمة قبل تفويض المهمة.
مخرجك: احفظ حزمة المهام النهائية وتفسيراً من سطر واحد لشرط توقف. قدمها لوكيل برمجة في الدرس العملي التالي أو اكتب النتائج المتوقعة يدوياً في مسار الدراسة.
تحقق من فهمك
- السؤال: ما الذي يجعل حزمة المهام قابلة للتحقق؟ الإجابة: مصدر وملفات مسموح بها وفحوصات قابلة للملاحظة وشرط توقف.
- السؤال: ماذا ينبغي للوكيل أن يفعل إذا أغفل المصدر تفصيلاً مطلوباً؟ الإجابة: يتوقف ويبلغ عن التفصيل المفقود بدلاً من اختلاقه.
استكشاف الأخطاء وإصلاحها
- الوكيل يغير أكثر مما ينبغي: حدد الملفات والإجراءات المستثناة في الحزمة.
- الوكيل يطرح أسئلة كثيرة: قدم المصدر المفقود أو مثالاً ملموساً.
- الوكيل يعلن النجاح مبكراً: اطلب مخرجات الأوامر الفعلية وافحص الملفات.
- الحزمة تطول كثيراً: استبدل النص المنسوخ من المصدر بمساره ورقم مراجعته.
الخطوات التالية
تابع إلى مهمتك الأولى مع وكيل برمجة . استخدم الحزمة لتوجيه تعديل صغير في المختبر.
التنقل في الدورة: السابق: سياق المستودع ، مخطط الدورة .

