زوّد الوكيل بسياق مفيد عن المستودع

ابدأ بالنسخة الحالية من المستودع

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

اطلب من الوكيل فحص تعليمات المشروع وإعدادات الحزمة قبل التنفيذ. قد يكون أمر يتذكره من مستودع آخر خاطئاً هنا. ولا يثبت اسم إطار عمل مألوف الإصدار المثبّت أو أعراف المشروع.

لتغيير صغير، قدّم الوحدة المعنية والشيفرة التي تستدعيها والاختبارات والقرار المعماري. أضف معلومات أخرى عندما يكشف البحث عن حاجة محددة.

استخدم تعليمات المستودع للقواعد المستقرة

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

احتفظ بقواعد المشروع المستقرة في المستودع. واحتفظ بالمهمة الحالية في وصف المهمة. لا تحوّل ملف التعليمات إلى سجل لكل محادثة أو قائمة خطط مؤقتة.

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

قارن التعليمات بالشيفرة

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

سجّل التعارض. استخدم أدلة مباشرة عن الإصدار الحالي لفهم سلوك التنفيذ. ولا تُسقط سياسة مقصودة بصمت لأن شيفرة قديمة تخالفها. تجيب السياسة والسلوك الحالي عن سؤالين مختلفين.

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

حافظ على صلة السياق بالمهمة وسلامته

قد يحتوي مستودع كامل على بيانات اعتماد وبيانات اختبار خاصة وملفات تصدير بيانات العملاء وسجلات دعم قديمة. لا يجعل الوصول إلى المستودع كل ملف مناسباً تلقائياً لخدمة نموذج.

استخدم الأدوات المعتمدة وقواعد معالجة البيانات. استبعد الأسرار من السياق. واستبدل أمثلة العملاء ببيانات مختلقة حيثما أمكن. افحص الأدوات المتصلة والملفات المرفوعة معاً: فقد يجلب موصّل بحث معلومات لم تكن في المطالبة الأولى.

تُعد تعليمات المستودع التي تقول «لا تقرأ الأسرار» إرشاداً مفيداً. لكنها لا تغني عن تقييد الوصول إلى مخازن الأسرار والمجلدات الحساسة.

اترك سجلاً مفيداً لمن يأتي بعدك

عند الإكمال، سجّل السلوك الذي تغيّر والتحقق والقيود غير المحسومة في طلب الدمج. حدّث توثيق المشروع الدائم عندما يتغير سير العمل المدعوم. وتجنّب نسخ محادثة الوكيل كاملة إلى المستودع.

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

يقلّل السياق الجيد البحث المتكرر. ويسهّل أيضاً كشف الأخطاء لأن السلوك المتوقع والأوامر التي تعمل محدّدان بوضوح.