امنع وكلاء البرمجة بالذكاء الاصطناعي من تكرار نفس الأخطاء
غالبًا ما يرتكب وكلاء البرمجة بالذكاء الاصطناعي مثل Claude Code أو Cursor نفس الأخطاء. يستخدمون مشغل اختبار (test runner) خاطئ، أو أسلوب استيراد (import style) خاطئ. تقوم بتصحيحهم في الدردشة، لكنهم ينسون التصحيح في الجلسة التالية.
سجل الدردشة ليس ذاكرة. عندما تنتهي الجلسة، تتلاشى تصحيحاتك.
الحل بسيط. اكتب قواعدك في ملف يقرؤه الوكيل في كل مرة يعمل فيها.
تدعم معظم الأدوات ملفات التعليمات في جذر المشروع (project-root):
• يقرأ Claude Code ملف CLAUDE.md.
• يستخدم Cursor المسار .cursor/rules/*.mdc.
• تستخدم العديد من الأدوات معيار AGENTS.md.
يتم إلحاق هذه الملفات بسياق النموذج (model context). توجد القواعد قبل أن يكتب النموذج أي كود.
لا تكتب أهدافًا غامضة. لا تطلب من الوكيل كتابة "clean code". القواعد الغامضة لا تجدي نفعًا. استخدم بدلاً من ذلك قواعد محددة وقابلة للاختبار.
استخدم هذا الهيكل لملف القواعد الخاص بك:
• الأوامر (Commands): حدد بدقة كيفية تشغيل الاختبارات وفحوصات الأنواع (typechecks). • النمط (Style): حدد استخدام ESM بدلاً من CommonJS، أو التصدير المسمى (named exports) بدلاً من التصدير الافتراضي (defaults). • الحدود (Boundaries): حدد المجلدات كـ "للقراءة فقط" أو حدد مكان وجود الأسرار (secrets). • تعريف الإنجاز (Definition of Done): نص على أن كل ميزة جديدة يجب أن تبدأ باختبار فاشل أولاً.
يعمل ملف القواعد الجيد كسجل للندوب (scar log). في كل مرة يرتكب فيها الوكيل خطأً، أضف قاعدة من سطر واحد إلى الملف في نفس الجلسة.
حافظ على قصر الملف. إذا كان ملف القواعد طويلاً جدًا، فإنه سينافس الكود الخاص بك على انتباه النموذج. إذا تجاوزت القاعدة 200 سطر، فقم بتقليمها. احذف القواعد التي لم تعد هناك حاجة إليها.
لا تفترض أن الوكيل يقرأ الملف. اختبر ذلك. أضف قاعدة تطلب من الوكيل ذكر أمر الاختبار الخاص به في بداية المهمة. إذا فعل ذلك، فالنظام يعمل.
توقف عن تصحيح الوكلاء في الدردشة. ابدأ في تهيئتهم باستخدام الملفات.
كيفية تنفيذ ذلك:
- أنشئ ملف CLAUDE.md أو AGENTS.md في جذر مشروعك.
- اكتب قواعد محددة وقابلة للتحقق فقط.
- أضف قاعدة فور ارتكاب كل خطأ.
- حافظ على رشاقة الملف وقم بتقليم القواعد القديمة.
مجتمع تعليمي اختياري: https://t.me/GyaanSetuAi