المبادئ الواجب اتباعها عند إصلاح الأكواد القديمة (Legacy Code) باستخدام وكلاء البرمجة بالذكاء الاصطناعي
makedream2026년 4월 25일
0
Computing/Software
Comments (0)
Log in to leave a comment
No posts yet
makedreammakedreamLog in to leave a comment
No posts yet
ترك الوكيل (Agent) يعبث بحاسوبك أمر محفوف بالمخاطر. فإذا تركت مفاتيح API مكشوفة في متغيرات البيئة، فقد يقوم الوكيل عن غير قصد بتسجيل المفاتيح في ملفات السجل (Logs) أو إرسالها إلى جهات خارجية. استخدم 1Password CLI، فهي تتيح لك إدخال المفاتيح في الذاكرة مؤقتًا فقط عند تنفيذ الأمر.
لحماية الملفات الأساسية من تعديلات الوكيل غير المقصودة، يجب عليك عزل نظام الملفات. قم بإنشاء ملف .cursorignore واحذف منه مفاتيح SSH، ومخرجات البناء (Build artifacts)، وملفات الإعدادات الحساسة تمامًا. إن وضع هذا الملف في مجلد المشروع الرئيسي يقلل من احتمالية تعديل الوكيل لملفات خاطئة بنسبة 80 بالمئة. وإذا أمكن، قم بتشغيل الوكيل داخل حاوية Docker؛ فهي الطريقة الأكثر ضمانًا لمنع الوكيل من الوصول المباشر إلى نظام المضيف.
إذا تركت الوكيل يقرأ المشروع بالكامل، فلن تستطيع تحمل تكاليف API الشهرية. خاصةً قراءة مجلدات مثل node_modules أو .git فهي مجرد إهدار للمال.
قم بتزويد الوكيل بالأكواد اللازمة فقط. ومع زيادة حجم المشروع، يصبح تقليص نطاق الفهرسة أمرًا ضروريًا. إذا كنت تستخدم Aider، تحقق من تكاليفك الحالية لحظة بلحظة باستخدام أمر /tokens. بمجرد الانتهاء من العمل على ملف ما، يجب عليك إخراجه من السياق فورًا باستخدام أمر /drop. هذا الإجراء وحده كفيل بتقليل استهلاك الرموز غير الضروري بأكثر من 70 بالمئة. إذا اخترت نموذجًا يدعم خاصية تخزين السياق المؤقت (Context Caching) من Anthropic، يمكنك الحصول على خصم إضافي يصل إلى 75 بالمئة على هياكل الأكواد المتكررة، لذا تحقق من فاتورة API وقم بتغيير النموذج وفقًا لذلك.
الأكواد القديمة تعاني من تشابك الاعتمادات، لذا فإن تركها للوكيل بشكل عشوائي قد يؤدي إلى انهيار النظام بالكامل. لا تطلب منه كتابة الكود بشكل أعمى، بل امنحه السياق باستخدام وسوم XML. حدد بوضوح أي الدوال تريد تعديلها، وما هي القواعد التي يجب الالتزام بها.
لا تقم بدمج (Merge) الأكواد مباشرة. اجبر الوكيل أولًا على تقديم خطة للتعديل، بحيث لا يبدأ بكتابة الكود إلا بعد موافقة المطور على الخطة. يجب عليك تجربة الكود الذي عدله الوكيل في بيئة اختبار محلية. إذا أعدت إرسال سجل أخطاء CI (التكامل المستمر) إلى الوكيل كما هو، فسيقوم بإصلاح الأخطاء بنفسه. تشير نتائج الأبحاث إلى أن اتباع هذه العملية يتيح معالجة الأخطاء بنسبة 84 بالمئة دون تدخل إضافي.
إذا كنت ترغب في معرفة مدى السرعة التي حققتها بعد إدخال الوكيل، فانسَ سرعة كتابة الكود؛ فزمن الدورة هو الجوهر. يجب عليك قياس الوقت الإجمالي المستغرق من كتابة الكود، والمراجعة، والتعديل، حتى النشر.
ابدأ بتسجيل عدد الأيام التي يستغرقها مشروعك الحالي من أول التزام (Commit) وحتى النشر الفعلي. يجب تدوين الأخطاء المتكررة التي يقع فيها الوكيل في ملف AGENTS.md كمعايير برمجية. إذا كان هناك جزء من النظام يعاني من انخفاض جودة الكود الذي ينتجه الذكاء الاصطناعي، فهذه ليست مشكلة الذكاء الاصطناعي بل مشكلة هيكلية في النظام. تحقق أسبوعيًا من نسبة إعادة العمل (Rework rate) لكل PR. الأداة تظل أداة؛ فمعاملة الوكيل كزميل عمل وتعديل البنية التحتية لتناسب سير عمل الفريق هو ما يحدد القدرة التنافسية لفريق التطوير.