لماذا يكتب وكيل الذكاء الاصطناعي «سلوب»؟ المدير التقني السابق لـ«سيتي درايف» يشرح كيف تُهيّأ المستودعات
لا يكتب الوكيل «سلوب» لأن النموذج سيئ. هو أشبه بموظف جديد ينسى كل صباح مراجعة الأمس، بينما اتفاقات الفريق غير مدوّنة في الكود. ينصح المدير التقني السابق لـ«سيتي درايف» بإنشاء ملف AGENTS.md من بضع مئات من الأسطر، والتحقق من القواعد عبر أدوات linter وhooks وCI. وأسهل مصدر للمادة الأولى للملف هو التعليقات على طلبات الدمج (pull request) خلال العام الأخير. وبهذا يقلّ تعثّر الوكيل في المشكلات نفسها في كل جلسة جديدة.
معالج بواسطة الذكاء الاصطناعي من Habr AI؛ بتحرير Hamidun News
يروي المتشككون في التطوير بالذكاء الاصطناعي عادةً القصة نفسها. جرّبوا الأداة، فبُني الكود وحتى اجتاز الاختبارات، لكنه مكتوب بغير الطريقة المتّبعة في الفريق، ويقلّد أسوأ أجزاء المشروع، وينهار عند أول تعديل. هذا هو ما يُسمّى AI slop، أي «الهراء». أما كاتب هذا التحليل، الذي ترك قبل نحو عام منصب المدير التقني لشركة مشاركة السيارات «سيتي درايف» ليتفرغ للتطوير بالوكلاء، فيرى أن اللوم يقع في الغالب لا على النموذج بل على المستودع الذي لم يُهيَّأ للوكيل.
الوكيل كموظف جديد يصل كل صباح لأول مرة
يبدأ الكاتب بقصة من عام 2019. كان يقود تطوير «تاكسي فكونتاكتي» على VK Mini Apps، وضمّ الفريق المكوّن من شخصين مطوّرًا ثالثًا قويًا ذا عادات مختلفة. لم تكن هناك قواعد مدوّنة، فتلقّى طلب دمج واحد من ألف وخمسمئة سطر رقمًا قياسيًا من مئة تعليق. وبعد نحو عشرة طلبات دمج صار بالإمكان عدّ التعليقات على أصابع اليد. لكن جزءًا من المعرفة لم يكن لدى الوافد الجديد أي مصدر لها. بعضها لم يكن إلا في الرؤوس، وبعض الأساليب تخلّى عنها الفريق بعد أن اكتوى بها دون أن يبقى لها أثر في المستودع.
تخيّلوا الآن أن هذا المطوّر يبدأ من الصفر كل صباح. هكذا يتصرف الوكيل. فالنموذج بلا ذاكرة: في كل طلب يُرسَل إليه سجل المحادثة كاملًا، وعندما يمتلئ السياق تُضغط المحادثة وتضيع التعليمات الواردة في بداية الجلسة. ولا يحتفظ الوكيل بالمشروع كله في رأسه، بل يرى فقط ما عثر عليه بنفسه.
ويورد الكاتب ثلاثة فخاخ نموذجية:
- في المشروع مئة وحدة، عشر منها حديثة وجيدة التأليف وتسعون قديمة (legacy). لا يعرف الوكيل أيها نموذج يُحتذى، وقد يتخذ الأولى والأسوأ قدوة.
- تُشغَّل اختبارات التكامل في مشروع Java بالأمر
mvn test -P integration. سيشغّل الوكيل الأمر العاديmvn test، فيحصل على «No tests to run» وBUILD SUCCESS، ويقرّر أن كل شيء أخضر. - يقرأ الفريق البيانات المكتوبة للتوّ من الخادم الرئيسي (master) لأن النسخة المتماثلة (replica) قد تتأخر. الوافد الجديد يُصحَّح له مرة واحدة، أما الوكيل فسيكرر الخطأ في كل جلسة.
أخطاء الوكلاء اليوم صارت في الغالب دلالية لا نحوية. الكود يُبنى ويبدو سليمًا، لكنه مبني على افتراض خاطئ: فهم الوكيل منطق العمل فهمًا خاطئًا، أو لم يسأل، أو أغفل حالة حدّية. وهذا أصعب اكتشافًا في المراجعة من بناء فاشل.
دوّن المعرفة ودع الوكيل يرى النتيجة
الخطوة الأولى ملف AGENTS.md في جذر المستودع. تقرؤه Claude Code وCodex وغيرها من الوكلاء. يشبهه الكاتب بورقة A4 تُسلَّم للوافد الجديد في يومه الأول: ينبغي أن يشغل بضع مئات من الأسطر لا خمسين صفحة من الويكي. وفيه خمسة أشياء: ما هذا المستودع، وأين يوجد كل شيء، وأوامر البناء والاختبار، والاتفاقات غير المكتوبة، وقاموس مصطلحات الفريق. ولا حاجة لإعادة سرد الكود فيه، وإلا نشأ مصدران للحقيقة، والمصدر الحقيقي الوحيد هو الكود العامل في بيئة الإنتاج.
وأسرع طريقة لجمع القواعد أن تطلب من الوكيل استخراج كل التعليقات على طلبات الدمج خلال العام الأخير، ثم يُبقي الإنسان في القائمة على ما هو ساري المفعول فقط. وإذا أخطأ الوكيل مجددًا في مهمة متعددة الخطوات، كإنشاء feature flag مثلًا، فالحل مهارة (skill)، أي تعليمات يحمّلها الوكيل عند الحاجة. وليس من المستحسن كتابتها من الصفر: نفّذ المهمة مع الوكيل واطلب منه في الجلسة نفسها وصف الخطوات التي قطعتموها.
ويحتاج الوكيل أيضًا إلى بيئة يرى فيها نتيجة عمله. فإن كان المشروع صغيرًا، جرى تشغيله محليًا. والأفضل صياغة سلسلة الأوامر في سكربت: فالوكيل يقرأ نص التعليمات في كل مرة بطريقة مختلفة، أما السكربت فيُنفَّذ بالطريقة نفسها دائمًا. وللمشاريع الكبيرة تلزم بيئة معاينة (preview) لكل طلب دمج، وتستطيع Vercel وNetlify وGitLab Review Apps وArgo CD إنشاء مثل هذه البيئات. يأخذ الوكيل عنوان البيئة، ويستدعي نقاط النهاية (endpoints)، ويفحص البيانات في قاعدة البيانات، أو ينقر في المتصفح وفق حالات الاختبار.
تحقّق بالبرنامج وقيّد الصلاحيات
أي قاعدة في AGENTS.md تبقى مجرد طلب: قد لا ينفذها الوكيل، أو يفقدها بعد ضغط السياق. لذلك فكل ما يمكن التحقق منه برمجيًا ينبغي التحقق منه برمجيًا:
- الاختبار أولًا ثم الكود. وإلا غرى الوكيلَ أن يطوّع الاختبار نفسه ليلائم الكود.
- أدوات linter برسائل واضحة. يمكن صياغة قاعدة الخادم الرئيسي والنسخة المتماثلة كفحص يمنع القراءة من النسخة المتماثلة مباشرة بعد الكتابة، ويشرح نص الخطأ كيفية التصحيح.
- الـ hooks. تستطيع Claude Code تشغيل linter تلقائيًا بعد كل تعديل.
- CI لا يمكن الدمج من دونه. لا تُعدَّل إعدادات CI والاختبارات إلا بموافقة المالكين المسجّلين في CODEOWNERS، ويجب ألا تتجاوز كل الفحوص 20–30 دقيقة، وإلا التهمت المكسب في السرعة.
وتتغير المراجعة أيضًا. فالمطوّر الذي كان ينجز ثلاث أو أربع مهام في الأسبوع قد ينجز الآن ثلاثًا أو أربعًا في اليوم، ومن المستحيل فعليًا قراءة كل شيء سطرًا سطرًا. يقترح الكاتب مخططًا: وكيل يكتب الكود ووكيل آخر يراجعه في جلسة جديدة، لأن كاتب الكود يفحصه بالسياق نفسه الذي كتبه به. أما الإنسان فينظر في القرارات التي يصعب التراجع عنها: مخطط قاعدة البيانات، وصلاحيات الوصول، والأمان، والمعمارية. ولئلا يبحث عنها في diff من 20 ألف سطر، يُبرز الوكيل بنفسه القرارات المفصلية في وصف طلب الدمج.
وفي شأن الأمان يذكّر الكاتب بأن الوكيل يتصرف باسمك، وأن الخطر الأكبر يأتي من الكود الخبيث، كالذي قد تحمله مكتبة مصابة. والأكثر أمانًا ألا يكون لجهاز الوكيل وصول إلى بيئة الإنتاج. يلي ذلك صندوق رمل (sandbox) أو حاوية يمكن فيها السماح بكل شيء. أما أضعف الخيارات فهو تأكيد الإنسان، الذي يقوم على hooks تفحص كل أمر قبل تنفيذه.
للبدء، اسأل الوكيل عن الجزء من المشروع الذي تعرفه أفضل من غيرك: أين يوجد الكود المطلوب؟ وراقب أوامر البحث التي شغّلها وعدد الجولات التي قام بها. وكل ما بحث عنه طويلًا أو وجده خطأً سيصبح الأسطر الأولى في AGENTS.md الخاص بك. وقد نشر الكاتب النسخة الكاملة من منهجه في كتاب مجاني عن Agentic SDLC على GitHub. وهذه تجربة شخصية لممارس واحد، لا دراسة مُقاسة، ولا أرقام عن حجم الأثر في النص. لكن النصائح قابلة للاختبار ولا تكلّف شيئًا عند تجربتها.
- 22 نوفمبر 2026الملف الشخصي للعمل في Android يسدّ تسرّب عنوان IP الحقيقي الذي لا يرصده Happ ولا v2rayNG
- 22 نوفمبر 2026Anthropic تدخل ناسداك: السهم من 83 إلى 111 دولارًا، لكن هل ستصمد معايير السلامة؟
- 22 نوفمبر 2026Databricks تبحث جولة تمويل بتقييم 225 مليار دولار، أي بزيادة تقارب 20% عن أغسطس
- 21 نوفمبر 2026Anthropic تعلن إثبات فرضية ريمان بمساعدة Claude، وستانفورد ترد بمسوّدة دون ذكاء اصطناعي
أسئلة وأجوبة حول الخبر
ما أبرز التفاصيل حول الوكيل كموظف جديد يصل كل صباح لأول مرة؟
يبدأ الكاتب بقصة من عام 2019. كان يقود تطوير «تاكسي فكونتاكتي» على VK Mini Apps، وضمّ الفريق المكوّن من شخصين مطوّرًا ثالثًا قويًا ذا عادات مختلفة. لم تكن هناك قواعد مدوّنة، فتلقّى طلب دمج واحد من ألف وخمسمئة سطر رقمًا قياسيًا من مئة تعليق. وبعد نحو عشرة طلبات دمج صار بالإمكان عدّ التعليقات على أصابع اليد. لكن جزءًا من المعرفة لم يكن لدى الوافد الجديد أي مصدر لها. بعضها لم يكن إلا في الرؤوس، وبعض الأساليب تخلّى عنها الفريق بعد أن اكتوى بها دون أن يبقى لها أثر في المستودع.
ما أبرز التفاصيل حول دوّن المعرفة ودع الوكيل يرى النتيجة؟
الخطوة الأولى ملف AGENTS.md في جذر المستودع. تقرؤه Claude Code وCodex وغيرها من الوكلاء. يشبهه الكاتب بورقة A4 تُسلَّم للوافد الجديد في يومه الأول: ينبغي أن يشغل بضع مئات من الأسطر لا خمسين صفحة من الويكي. وفيه خمسة أشياء: ما هذا المستودع، وأين يوجد كل شيء، وأوامر البناء والاختبار، والاتفاقات غير المكتوبة، وقاموس مصطلحات الفريق. ولا حاجة لإعادة سرد الكود فيه، وإلا نشأ مصدران للحقيقة، والمصدر الحقيقي الوحيد هو الكود العامل في بيئة الإنتاج.
ما أبرز التفاصيل حول تحقّق بالبرنامج وقيّد الصلاحيات؟
أي قاعدة في AGENTS.md تبقى مجرد طلب: قد لا ينفذها الوكيل، أو يفقدها بعد ضغط السياق. لذلك فكل ما يمكن التحقق منه برمجيًا ينبغي التحقق منه برمجيًا: الاختبار أولًا ثم الكود. وإلا غرى الوكيلَ أن يطوّع الاختبار نفسه ليلائم الكود. أدوات linter برسائل واضحة. يمكن صياغة قاعدة الخادم الرئيسي والنسخة المتماثلة كفحص يمنع القراءة من النسخة المتماثلة مباشرة بعد الكتابة، ويشرح نص الخطأ كيفية التصحيح. الـ hooks. تستطيع Claude Code تشغيل linter تلقائيًا بعد كل تعديل. CI لا يمكن الدمج من دونه.
Test Frontier LLMs & Autonomous Agents in One Workspace
Run Claude Opus 5.5, GPT-6, Gemini 3.1, and DeepSeek side-by-side in Nomad AI (nomadnet.ai) — unified model routing, deep research, and multimodal workflows under one subscription.
أهم ما في عالم الذكاء الاصطناعي — مرة كل أسبوع
سبع قصص مهمة فعلاً هذا الأسبوع، مختارة بعناية. بلا ضجيج ولا بيانات صحفية.
تم! تحقق من بريدك للتأكيد.