ما هي مكتبة التلقينات؟
📍 In One Sentence
مكتبة التلقينات هي مستودع مشترك ومُصدَر وقابل للبحث يمكن للفريق اكتشافه وإعادة استخدامه وتحسينه بمرور الوقت.
💬 In Plain Terms
فكر في مكتبة التلقينات كمكتبة كود لتعليمات الذكاء الاصطناعي: كل شيء مُسمَّى ومُصدَر وقابل للاكتشاف ويُراجَع قبل الدخول إلى الإنتاج.
مكتبة التلقينات هي مجموعة مشتركة ومُصدَرة من التلقينات يمكن للفريق البحث فيها وإعادة استخدامها وتحسينها بمرور الوقت. تحل ثلاث مشكلات: الاكتشاف (إيجاد تلقين يفعل ما تحتاجه بالفعل)، والتكرار (كتابة نفس التلقين مرتين)، وخط أساس الجودة (ضمان أن جميع التلقينات تلبي حدًا أدنى من المعايير قبل المشاركة).
بدون مكتبة، تعيش التلقينات في ملاحظات فردية ورسائل Slack وتاريخ ChatGPT — غير متاحة للفريق، وغير مُصدَرة، ومفقودة عندما يغادر شخص ما. المكتبة تحول التلقينات من معرفة فردية إلى أصل للفريق.
أنشئ مكتبة تلقينات عندما يكتب 3 أشخاص أو أكثر التلقينات بانتظام، عندما يستخدم الفريق 20 تلقينًا مختلفًا أو أكثر في دوران نشط، أو عندما تلاحظ إعادة إنشاء نفس التلقين لأن أحدًا لم يستطع إيجاد الإصدار السابق.
📌 متى تبني المكتبة
المحرك لبناء مكتبة ليس الحجم — بل عندما تبدأ إعادة إنشاء التلقينات في الحدوث. إذا قال أحد أعضاء الفريق يومًا ما "أعتقد أن لدينا تلقينًا لهذا بالفعل"، فقد حان الوقت لبناء مكتبة.
بنية المجلدات واصطلاحات التسمية
**استخدم النمط `/prompts/theme/slug-vversion.ext` لجميع ملفات التلقينات.** تتيح هذه البنية التصفية حسب الموضوع، والفرز حسب الإصدار، وتحديد التنسيق (`.md` للـ markdown، `.txt` للنص العادي، `.json` للتلقينات المنظمة) للوهلة الأولى.
مثال على بنية المجلد لفريق من 4 أشخاص:
- /prompts/customer-support/ticket-triage-v2.md
- /prompts/customer-support/first-response-draft-v1.md
- /prompts/content/blog-outline-v3.md
- /prompts/content/product-description-v1.md
- /prompts/engineering/code-review-v2.md
- /prompts/engineering/pr-summary-v1.md
- /prompts/research/source-summarize-v2.md
- /prompts/deprecated/ (تلقينات مؤرشفة، محتفظ بها لمدة عام)
⚠️ لا تستخدم هذه الأسماء أبدًا
لا تستخدم "latest" أو "final" أو "new" أو "copy" كمعرفات إصدار في أسماء الملفات. تفقد هذه المعرفات معناها فورًا وتجعل تاريخ الإصدارات غير قابل للقراءة.
قواعد التسمية: حروف صغيرة فقط، شُرَط بدلًا من المسافات، لا أحرف خاصة. أدرج لاحقة الإصدار (`-v1`، `-v2`) في اسم الملف حتى يكون تاريخ الإصدارات مرئيًا في قائمة الملفات دون الحاجة إلى فتح سجل التحكم بالإصدارات. لا تستخدم `latest` أو `final` كمعرفات إصدار أبدًا.
استراتيجيات التحكم بالإصدارات لمكتبات التلقينات
استخدم علامات Git لتمييز إصدارات الإنتاج من التلقينات: ضع علامة `prompt/ticket-triage/v2` عند نشر ذلك الإصدار في الإنتاج. هذا يجعل التراجع محددًا — العودة إلى الـ commit المُوسَم، لا إلى حالة "آخر استقرار" الغامضة.
للتعديلات المتزامنة، اتبع استراتيجية الفروع نفسها المستخدمة للكود: أنشئ فرع ميزة (`prompt/ticket-triage-intent-detection`)، افتح pull request، احصل على مراجعة، ثم ادمج. لا تُعدِّل التلقينات مباشرة في `main`. تُطبِّق قواعد حماية الفروع على `main` ذلك على مستوى البنية التحتية.
يوفر PromptHub سير عمل مراجعة منظمة للفرق التي تريد سلاسل تعليقات، ومربعات اختيار الموافقة، والوصول القائم على الأدوار دون إدارة فروع Git يدويًا. قبل دمج إصدار تلقين جديد، يتحقق PromptQuorum منه عبر 25+ نموذجًا في وقت واحد.
التحكم بالوصول والملكية
نموذج الثلاثة أدوار يغطي معظم الفرق: مساهم (يمكنه الإضافة)، مالك/مراجع (يمكنه التعديل)، موافق (يمكنه النشر في الإنتاج). دمج هذه الأدوار — السماح لأي شخص بالتعديل والنشر — هو السبب الرئيسي لتراجع التلقينات في المكتبات المشتركة.
التطبيق في Git: اضبط قواعد حماية الفروع على `main` التي تتطلب موافقة مراجعة واحدة قبل الدمج. عيِّن ملف CODEOWNERS يربط كل مجلد تلقينات بمراجع محدد. لـ PromptHub: استخدم إعداد الأدوار المدمج — مساهم، مراجع، ومدير.
يجب أن يكون لكل تلقين مالك محدد. المالك مسؤول عن إبقاء التلقين محدثًا، وتصنيف المشكلات، وتقرير متى يُهمله. عندما يغادر المالك الفريق، يجب إعادة تعيين التلقين قبل يومه الأخير.
💡 نقل الملكية
أضف إعادة تعيين ملكية التلقينات إلى قائمة مراجعة إلغاء انضمام الفريق. التلقين اليتيم بدون مالك يتدهور بصمت — لا أحد يلاحظ حتى يفشل نظام تابع.
سير عمل المراجعة والإهمال
نفِّذ مراجعة ربع سنوية لمكتبة التلقينات: تحقق من مقاييس الاستخدام، وقيِّم ما إذا كانت الإصدارات الحالية لا تزال تلبي معايير الجودة، وحدد التلقينات الجاهزة للإهمال. التلقين الذي لا يستخدمه أحد في 90 يومًا هو عبء صيانة وليس أصلًا.
معايير إهمال التلقين: عدم الاستخدام خلال 90 يومًا الماضية؛ إصدار أفضل يحل محله والإصدار القديم لم يعد ضروريًا؛ النموذج الذي كُتب واختُبر من أجله لم يعد في الإنتاج. إذا انطبق أي اثنان من هذه الثلاثة، فأهمله.
عملية الإهمال: (1) أضف `status: deprecated` إلى frontmatter التلقين، (2) انقل الملف إلى `/prompts/deprecated/`، (3) أضف ملاحظة تشير إلى التلقين البديل إن وُجد، (4) احتفظ به في مجلد deprecated لمدة عام على الأقل. احذف بعد عام إذا لم يُطلب أي تراجع.
الأخطاء الشائعة في إدارة مكتبة التلقينات
❌ بنية مجلدات مسطحة دون تنظيم حسب الموضوع
Why it hurts: مع 20 تلقينًا أو أكثر، تصبح الملفات غير قابلة للبحث ويضاعف أعضاء الفريق العمل لأنهم لا يجدون التلقينات الموجودة
Fix: نظِّم التلقينات حسب الموضوع: /prompts/theme/slug-vN.txt. 20 تلقينًا كحد أقصى لكل مجلد موضوع.
❌ عدم وجود اصطلاح تسمية لملفات التلقينات
Why it hurts: الملفات المسماة "prompt1.txt"، "final.txt"، "final-v2.txt" لا يمكن اكتشافها أو مقارنتها برمجيًا
Fix: استخدم التنسيق: slug-vmajor.minor.txt. مثال: classify-intent-v2.1.txt. لا تستخدم "final" أو "copy" أو "new" أبدًا.
❌ عدم وجود عملية إهمال
Why it hurts: تتراكم التلقينات القديمة، ويستخدم أعضاء الفريق إصدارات قديمة دون أن يعلموا أنها تجاوزتها
Fix: أضف DEPRECATED.md لكل مجلد يحتوي على قائمة بـ slugs المُهملة، وتاريخ الإهمال، وslug البديل.
❌ عدم التحكم بالوصول على تلقينات الإنتاج
Why it hurts: يمكن لأي عضو في الفريق تعديل تلقين الإنتاج دون مراجعة، مما يتسبب في تراجعات جودة صامتة
Fix: أضف قواعد حماية الفروع: اطلب مراجعة PR + اجتياز CI/CD لأي تغيير في /prompts/production/.
النقاط الرئيسية
- تحل مكتبة التلقينات مشكلات الاكتشاف والتكرار وخط أساس الجودة — أنشئها عندما يكتب 3 أشخاص أو أكثر التلقينات أو يكون هناك 20 تلقينًا أو أكثر في الاستخدام النشط
- بنية المجلدات: /prompts/theme/slug-vversion.ext — حروف صغيرة، شُرَط، إصدار في اسم الملف
- Git: ضع علامة على إصدارات الإنتاج، استخدم فروع الميزات، اطلب مراجعة PR قبل الدمج في main
- PromptHub: استخدمه لسير عمل مراجعة منظمة مع سلاسل التعليقات والموافقة القائمة على الأدوار
- ثلاثة أدوار وصول: مساهم (إضافة)، مالك/مراجع (تعديل)، موافق (النشر في الإنتاج)
- أهمل التلقينات غير المستخدمة خلال 90 يومًا؛ أرشف واحتفظ بها عامًا قبل الحذف
الأسئلة الشائعة
ما هي مكتبة التلقينات؟
مكتبة التلقينات هي مستودع مشترك ومُصدَر يخزن فيه الفريق التلقينات ويبحث فيها ويعيد استخدامها. تشمل عادةً بنية مجلدات منظمة حسب الموضوع أو حالة الاستخدام، وملفات مُسماة ومُصدَرة، وقواعد التحكم بالوصول، وعملية مراجعة أو موافقة.
هل أستخدم Git أم PromptHub لإصدار التلقينات؟
استخدم Git إذا كان فريقك يعامل التلقينات ككود ويرتاح للتحكم بالإصدارات. استخدم PromptHub إذا احتاج فريقك إلى سير عمل مراجعة منظمة مع وصول قائم على الأدوار وسلاسل تعليقات. تستخدم فرق كثيرة Git للتخزين وPromptHub لواجهة المراجعة.
ما هي بنية المكتبة الأدنى لفريق من 3 أشخاص؟
يحتاج فريق من 3 أشخاص إلى: مجلد /prompts/ في Git، ومجلدات حسب الموضوع (حتى 5 موضوعات)، واصطلاح تسمية (slug + إصدار)، وREADME.md لكل مجلد. أضف متطلب مراجعة على main. يستغرق هذا الإعداد أقل من 30 دقيقة.
متى تستخدم PromptHub مقابل Git لإدارة التلقينات؟
استخدم Git إذا كان فريقك مكونًا بشكل رئيسي من مطورين ويريد مراجعة التلقينات في GitHub PRs. استخدم PromptHub إذا ضم الفريق غير المطورين، أو احتاج إلى واجهة مستخدم للاكتشاف والمقارنة، أو احتاج إلى مشاركة التلقينات عبر قواعد كود متعددة.