اطلب من مساعد كود ذكي إصلاح خطأ في خدمة غير مألوفة، وراقب ما يفعله أولاً: يبدأ بالقراءة. يفتح ملفاً، ثم آخر، ثم يبحث عن اسم دالة ويفتح أربعة ملفات أخرى. كل جولة تكلّف رموزاً ووقتاً، ويصل الوكيل إلى التعديل شبه أعمى — إذ اكتفى بأخذ عينات من قاعدة الكود بدلاً من فهمها.
Codna يعكس هذا الترتيب. يقرأ المستودع بأكمله قبل أن يكتب الوكيل سطراً واحداً، بانياً خريطة هيكلية للمشروع كله في أجزاء من الثانية. الوكلاء يقرؤون كودك. Codna يفهمه.
لماذا يقرأ مساعد الكود الذكي بشكل أعمى
المستودع الكبير ليس مجلداً من النصوص. إنه رسم بياني — من الاستيرادات ومواقع الاستدعاء وتعريفات الأنواع والأعراف الصامتة التي راكمها الفريق على مدار سنوات. حين يدخل وكيل البرمجة الذكي إلى هذا الرسم ملفاً بملف، يدفع ثمناً مزدوجاً: مرة في رموز أُنفقت على إعادة قراءة ما رآه من قبل، ومرة في أخطاء ارتكبها لأنه لم يرَ الجزء الذي كان يهم.
الإخفاق نادراً ما يكون مدوّياً. يعالج الوكيل العَرَض ويفوّت المساعد المشترك على بُعد ثلاثة مجلدات. يكرّر أداةً موجودة أصلاً. يغيّر توقيعاً دون أن يلاحظ المستدعين السبعة في المراحل اللاحقة. لا شيء من هذا إخفاق في التفكير. إنه إخفاق في السياق — لم يُعرض على النموذج ما يكفي من قاعدة الكود ليعرف أفضل.
معظم التعديلات الذكية السيئة ليست أخطاء تفكير. إنها أخطاء سياق مفقود.
الحل المعتاد هو إرسال المزيد من النص: حشو الطلب بالملفات وأمل أن تكون الأسطر ذات الصلة في مكان ما. هذا يستبدل مشكلة بأخرى. تمتلئ نوافذ السياق، وترتفع التكاليف، وتُدفن الإشارة التي يحتاجها الوكيل فعلاً تحت كل ما لا يحتاجه.
الخريطة أولاً، ثم العمل
مبدأ Codna أن فهم قاعدة الكود وتعديلها مهمتان مختلفتان، وينبغي أن تعملا على محركين مختلفين. يؤدي محرك رسم الخرائط العمل الهيكلي المكلف مرة واحدة ويبقيه محدّثاً. يقوم وكيل البرمجة بالكتابة، واصلاً بسياق دقيق بدلاً من قائمة قراءة.
يحدث رسم الخريطة هذا بـصفر رموز. يفهرس Codna المستودع بالتحليل الساكن بدلاً من تمرير الكود المصدري عبر نموذج لغوي، لذا لا يكلّف بناء خريطة مشروع بمليون سطر وتحديثها شيئاً في الاستدلال. تُنفق ميزانية النموذج حيث تؤتي ثمارها — على التغيير نفسه، لا على إعادة اكتشاف المشروع من الصفر في كل جلسة.
النتيجة مساعد برمجة مدعوم بالذكاء الاصطناعي يعامل سياق قاعدة الكود كبنية تحتية. الخريطة موجودة دائماً، محدّثة دائماً، وقابلة للاستعلام في اللحظة التي يحتاجها الوكيل.
افهم. أصلح. طوّر.
تسير الحلقة في أربع خطوات، وتعمل بهذا الترتيب في كل مرة يباشر فيها الوكيل عمله.
أولاً، يرسم Codna خريطة المستودع — محللاً المشروع إلى فهرس هيكلي من الملفات والرموز والتبعيات ورسوم الاستدعاء. ثانياً، يفهم تلك الخريطة، محدداً كيف ترتبط الأجزاء ببعضها حتى يعرف الاستعلام عن دالة ما الكود الذي يستدعيها والكود الذي تعتمد عليه. ثالثاً، حين تصل مهمة، يسترجع Codna السياق — مستخرجاً الشريحة الدقيقة من قاعدة الكود التي يمسّها التغيير، لا أكثر. رابعاً، يوجّه الوكيل، مسلّماً إياه ذلك السياق المركّز ليُجري التعديلات بالوعي ذاته الذي يحمله مهندس أول في ذهنه.
افهم. أصلح. طوّر. التسمية مقصودة. الفهم يسبق الإصلاح لأن الإصلاح بلا فهم مجرد تخمين، والتطوير — إعادة الهيكلة والترحيل والتحسين التدريجي للنظام عبر الزمن — لا يكون آمناً إلا حين يكون كل تغيير مرسّخاً في الكل.
ما الذي يغيّره السياق الدقيق
حين يتوقف الوكيل عن القراءة بشكل أعمى، يظهر الفرق في العمل لا في العرض التوضيحي.
- تقع التعديلات في المكان الصحيح لأن الوكيل يرى كل مستدعي الدالة التي يلمسها
- ينخفض استهلاك الرموز لأن النموذج لا يدفع ثمن إعادة قراءة الملفات في كل جولة
- تصبح إعادة الهيكلة أكثر أماناً، إذ تكشف الخريطة النطاق الكامل لأثر التغيير قبل إطلاقه
- يتوقف الإلمام بمستودع غير مألوف عن كونه لعبة تخمين — الهيكل مرسوم مسبقاً
هذا هو الخط الفاصل بين وكيل البرمجة الذكي وذكاء الكود الحقيقي. أحدهما يقرأ بقدر ما يستطيع تحمّله. والآخر يعرف ما يقرأه قبل أن يبدأ. بين أدوات مساعدة الكود الذكية، يسهل إغفال هذا الفارق في تجربة سريعة ويستحيل إغفاله عبر ربع عمل حقيقي — إنه ما يفصل الإكمال التلقائي الذكي عن أفضل مساعد كود ذكي لقاعدة كود تحتاج فعلاً إلى صيانتها.
مبني للمستودعات التي لديك بالفعل
يعمل Codna على المشاريع الحقيقية — الكبيرة والمتعددة الطبقات وشبه الموثّقة، لا الأمثلة المرتّبة في الدروس التعليمية. يعمل جنباً إلى جنب مع وكلاء البرمجة التي تستخدمها الفرق بالفعل، بما في ذلك كمساعد كود ذكي لـ VS Code، لتُعلم الخريطةُ الأدواتَ التي يلجأ إليها المطورون بدلاً من استبدالها. لم يكن الهدف يوماً إضافة نافذة أخرى. كان جعل الوكيل في النافذة التي لديك يصل وهو يعرف أين هو.
مع نمو الأنظمة، لا تزيد الهوة بين قراءة الكود وفهمه إلا اتساعاً، والمساعدات التي تردمها ستكون تلك التي ترسم الخريطة قبل أن تتصرف. Codna متاح الآن، ومبني لذلك المستقبل — حيث يكون فهم قاعدة الكود أول ما تفعله أدواتك، لا آخره.