مركز المساعدة · الفهم

كيف أشرح أعرافي الداخلية للوكلاء؟

اكتب ما يحتاج زميل جديد أن يُشرح له، لتعرفه كل عملية تشغيل.

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

ما الذي يستحق أن يُكتب هناك؟

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

ما ينفع فعلًا:

• «كل نداءات واجهتنا البرمجية تمرّ عبر ApiClient، لا عبر fetch مباشرةً.»
• «نصوص المستخدم تعيش في lang/، ولا تُكتب داخل العرض أبدًا.»
• «وحدة الفواتير قيد إعادة الكتابة: لا تلمسها دون إخبارنا.»

وما لا ينفع: تكرار أعراف إطار العمل. يعرفها Diavi أصلًا، وهي ما تدفع ثمنه.

لماذا سياق لكل مستودع؟

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

يعرض العمود الأيمن جميع مستودعاتي، لما لا يتعلق بأي مستودع (عادات المراجعة لديك، أعراف التذاكر)، ثم المستودعات التي لديها سياق بالفعل. يتيح لك إضافة مستودع اختيار واحد من قائمة منصتك.

يحمّل التشغيل جميع مستودعاتي إضافة إلى المستودع الذي يعمل عليه، ولا يحمّل غيره أبدًا.

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

هل هناك حدّ للحجم؟

نعم، 40 000 حرف لما يحمّله التشغيل فعليًا: جميع مستودعاتي إضافة إلى مستودع واحد. يعرض المؤشر هذا المجموع للنطاق المفتوح. ليس الأمر اعتباطيًا: يُرسل هذا النص في كل استدعاء أثناء التشغيل، لذا ينعكس حجمه مباشرة على استهلاكك. ترفض الواجهة الحفظ بعد هذا الحد بدلًا من الاقتطاع بصمت.

من يستطيع تعديلها؟

مالك الحساب والمسؤولون. يدخل السياق في كل موجّه: فهو رافعة كلفة، لا إعداد راحة.

هل أرى قواعد Diavi؟

لا. قواعد كل تقنية هي خبرة Diavi وتبقى خاصة. سياقاتك تُضاف إليها؛ ولا تحلّ محلها أبدًا، وتظل تستفيد من تحديثاتها.