كيف تمنح وكيل برمجة بالذكاء الاصطناعي معرفة موثوقة بالمجال

قد يكتب وكيل برمجة عام إجابة تبدو معقولة، لكنه يفوّت التفصيل الأهم في مكدسك: واجهة API تغيرت حديثاً، أو حدود مستودع لا يجب تجاوزها، أو قاعدة تحافظ على استقرار الإنتاج. الحل ليس دائماً مطالبة أطول. النمط الأفضل هو تزويد الوكيل بإرشاد صغير قابل لإعادة الاستخدام وتعريف قابل للتحقق للاكتمال.

1. افصل قواعد المشروع عن إجراءات المجال

ابدأ بطبقتين. الأولى عقد مستودع مختصر: ما المشروع، كيف منظم، أوامر البناء والاختبار، الملفات الممنوعة، وما معنى “تم”. يصف توثيق JetBrains لسلوك الوكلاء ملفات مثل AGENTS.md وCLAUDE.md بأنها تعليمات تسافر مع المستودع ويمكن مشاركتها بين الأدوات.

اجعل هذه الطبقة ثابتة وعملية. يجب أن تجيب عن أسئلة يحتاجها الوكيل في كل مهمة: أين منطق المجال؟ كيف أشغل الفحوص؟ ماذا لا أعدل؟ أما القاعدة الخاصة بسير عمل واحد فضعها في skill منفصلة.

الطبقة الثانية معرفة المجال: وصفة مركزة لمهمة متكررة مثل ترقية تنقل Android أو تغيير مخطط قاعدة البيانات أو قائمة إصدار. يجب أن تحتوي skill على محفز واضح وتسلسل قصير وتحقق صريح، حتى يبقى السياق الافتراضي صغيراً ولا تُحمّل المعرفة المتخصصة إلا عند الحاجة.

2. اكتب skill حول فجوة معرفية

توجد skill جيدة لأن النموذج يكرر خطأ أو يهدر الوقت في اكتشاف الشيء نفسه. تقدم فلسفة Android Skills اختباراً مفيداً: تُنشأ المهارات الرسمية لفجوات يمكن التحقق منها، خصوصاً عند تغير APIs أو استخدام بنية مخصصة. ويحذر المصدر من تنزيل مهارات من مجموعات ضخمة غير مختبرة قد تحتوي تعليمات خبيثة.

مثال على skill صغيرة:

---
name: navigation-upgrade
description: Use when changing the app's Navigation 3 setup or upgrading its related APIs.
---

Before editing:
1. Inspect the current dependency versions and existing navigation tests.
2. Read the project's navigation conventions.
3. Confirm the target API in the approved platform documentation.

While editing:
- Make the smallest vertical change that satisfies the requested behavior.
- Do not replace the navigation architecture without approval.
- Preserve existing deep-link and back-stack behavior unless the task says otherwise.

Done means:
- The focused tests pass.
- The relevant build or lint command passes.
- The response names changed files, checks run, and unresolved risks.

المثال ضيق عمداً. لا يلصق دليلاً كاملاً في كل مطالبة، بل يحدد متى يطبق الإجراء، وما الذي يفحصه الوكيل، والحدود المهمة، وكيف يثبت الإنجاز. استبدل فحوص المنصة بأوامر وممارسات مستودعك الفعلية.

3. اجعل الوكيل يفحص قبل أن يتصرف

تفيد وكلاء البرمجة لأنها تجمع الطلب مع سياق البيئة، وتستدل عليه، ثم تنفذ تعديلات واختبارات وبناء. هذا هو النمط الموضح في إرشادات AWS لوكلاء البرمجة. اجعل تعليماتك تعرض هذه المراحل.

يتكون الطلب العملي من أربعة أجزاء:

1. السياق: حدد الميزة والمجلدات والقيود.
2. الخطة: اطلب قائمة الملفات والفحوص قبل التعديل.
3. التغيير: اطلب أصغر تنفيذ يحقق معايير القبول.
4. الدليل: اطلب الاختبارات وlint والبناء أو الفحوص اليدوية التي تثبت النتيجة.

يمنع ذلك بدء البرمجة من جملة المستخدم ثم اكتشاف بنية المستودع متأخراً واللجوء إلى إعادة كتابة واسعة. الفحص ليس شكلاً؛ إنه طريقة حصول الوكيل على السياق الذي تعتمد عليه قراراته.

4. امنح الوكيل حلقة تغذية راجعة ضيقة

يشرح إرشاد المجال كيف يعمل المشروع، لكن الفحوص القابلة للتنفيذ تظهر هل يعمل التغيير. يوضح دليل TDD الحالي في VS Code فصل مرحلة red لكتابة اختبار فاشل، وgreen لتنفيذ الحد الأدنى، وrefactor لتحسين البنية مع إبقاء الاختبارات ناجحة.

لا تحتاج إلى ثلاثة وكلاء معقدين. في مهمة صغيرة اطلب اختباراً فاشلاً أو اختبار توصيف أولاً، ثم اسمح بالتنفيذ بعد وضوح السلوك المتوقع. اختم باختبار مركز وحواجز الجودة المعتادة. إذا لم ينجح الوكيل، فهذه معلومة عن المتطلب أو البيئة وليست سبباً لإخفاء الفشل في ملخص واثق.

5. راجع الإرشاد وأوقفه عند الحاجة

تعامل مع skill كبنية هندسية ذات إصدار. راجعها عند تغير framework، أو تكرار خطأ، أو زيادة ضجيج اختبار. وتعرض إرشادات Android Skills المهارات كمرشحة للإيقاف: تتحسن النماذج فتصبح تعليمات غير ضرورية، بينما تخلق APIs الجديدة فجوات جديدة.

حلقة صيانة خفيفة:

• احتفظ بمهمة مثال تستعمل skill.
• سجل الملفات المتوقعة وأوامر التحقق.
• شغلها بعد تغيير skill أو النموذج.
• احذف التعليمات التي لم يعد النموذج يحتاجها.
• اجعل العمليات الحساسة اختيارية وقابلة للمراجعة.

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