إنتقل إلى المحتوى الرئيسي

مكتبة المطالبات

المطالبات قوالب تعليمات قابلة لإعادة الاستخدام، ولكل منها هوية أمر يبدأ بشرطة مائلة. لكل مطالبة slug مثل (/review-pr)، وعنوان، ووصف ووسوم اختياريان، ومحتوى قالب، ومتغيرات محددة النوع.

المتغيرات

يشير المحتوى إلى المتغيرات بصيغة {{name}}. يجب التصريح عن كل متغير مشار إليه، ويكون لكل تصريح نوع: text أو number أو select (مع خيارات) أو boolean، مع إمكانية جعله مطلوبًا وتعيين قيمة افتراضية له. عند إدراج مطالبة في محرر الرسائل، تُجمع قيم متغيراتها قبل عرض المحتوى.

الإصدارات

يؤدي تحديث مطالبة إلى زيادة رقم إصدارها وأرشفة المراجعة السابقة. تعرض شاشة السجل المراجعات؛ وتؤدي العودة إلى مراجعة قديمة إلى استعادتها في صورة إصدار جديد، ليظل المسار خطيًا ولا يُعاد كتابة أي شيء بصمت.

المشاركة والتصدير والاستيراد

تكون المطالبات خاصة افتراضيًا، ويمكن مشاركتها عبر نموذج منح الوصول المشترك للموارد (قراءة أو كتابة، للمستخدمين أو المجموعات). ينشئ التصدير مستند JSON من النوع libre-prompt.v1، ويعيد الاستيراد إنشاءه مع رفض تعارض slug ما لم يُطلب الاستبدال. تُشفّر عناوين المطالبات وأوصافها ومحتواها ومتغيراتها ووسومها عند التخزين؛ بينما يبقى slug نصًا صريحًا كي يعمل البحث بأوامر الشرطة المائلة.

الملفات الشخصية

يمكن ربط ملف مساعد شخصي بمطالبة واحدة؛ وعندئذ يسبق المحتوى المعروض مطالبة النظام الخاصة بالملف في كل جلسة تستخدمه.

مثال

أنشئ مطالبة من الإعدادات ← المطالبات (أو اختر أحد القوالب الابتدائية هناك وعدّله):

  • Slug: review-pr

  • العنوان: Pull request review

  • المحتوى:

    Review the following {{language}} changes with {{strictness}} strictness.
    Point out bugs first, style second, and end with a one-line verdict.
  • المتغيرات: language (من النوع text، مطلوب) وstrictness (من النوع select: low وnormal وpedantic، والقيمة الافتراضية normal).

اكتب / في أي محادثة، فيعرض محرر الرسائل مطالباتك. اختر /review-pr، وأدخل language: TypeScript، ثم اختر pedantic. يحل النص المعروض محل مسودتك ويصبح جاهزًا للإرسال (ألصق الفرق بعده). إذا عدّلت المطالبة لاحقًا، تنتقل إلى الإصدار 2؛ وتبقى الصياغة القديمة في السجل ويمكن الرجوع إليها.