← العودة إلى القائمة

أفضل الممارسات الهندسية السريعة

تعامل مع المطالبات مثل التعليمات البرمجية: امنحها البنية، وقم بإصدارها، وقم بتقييمها. فيما يلي ست ممارسات نجت من العشرات من مسارات الإنتاج على Starsg - تلك التي حركت الإبرة باستمرار، بالترتيب الذي تميل إلى أهميته.

1. تحديد الدور والهدف

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

قالب تحديد الدور

text
أنت مهندس علاقات المطورين.
الجمهور: مهندسو الواجهة الخلفية مرتاحون لواجهات برمجة التطبيقات HTTP ولكنهم جدد على LLMs والتسعير القائم على الرمز المميز.
الهدف: في ثلاث دقائق، ساعد القارئ على تحديد ما إذا كان Starsg يستحق التكامل، وأخبره بالخطوة التالية.
استخدم نغمة بسيطة ولكن احترافية. تجنب زغب التسويق.

2. اكتب المهمة بشكل واضح

"اكتب دعاية مغالى فيها عن المنتج" تسلم كل قرار للنموذج - كل جولة هي تخمين. تحتوي التعليمات القابلة لإعادة الاستخدام على خمسة عناصر على الأقل: الإجراء (كتابة/تلخيص/ترجمة)، والموضوع (ماذا)، والجمهور (لمن)، والنغمة/الأسلوب، والطول أو الشكل. قم بتهجئتها وسيقفز استقرار الإخراج الخاص بك إلى مستوى على الفور.

❌ غامض جدًا

text
اكتب لي دعاية مغالى فيها للمنتج.

✅ جميع العناصر الخمسة

text
بكلمات 200 تقريبًا، بالنسبة لمهندسي الواجهة الخلفية، قدم ثلاثة عوامل تفاضلية لـ Starsg (البوابة الموحدة، والفوترة لكل مفتاح، والاحتياطي متعدد النماذج). لهجة: المهنية وضبط النفس. تجنب كلمات مثل «تمكين» أو «الجيل القادم». انتهي بدعوة واحدة محددة للعمل.

3. توفير السياق والأمثلة (قليل من اللقطات)

كلما كان المتطلب أكثر تجريدًا، كلما زاد عدد الأمثلة التي تستحق الاحتفاظ بها. يستحق واحد إلى ثلاثة أزواج من «المدخلات → المخرجات المتوقعة» عشرة أسطر من الشرح. تعتبر Few-shot حاسمة بشكل خاص عندما يكون التنسيق ثابتًا (التصنيف، الاستخراج، JSON)، عندما يصعب وصف الأسلوب بالكلمات، أو عندما يكون للمجال اتفاقياته الخاصة (الأنظمة القانونية والطبية والداخلية). اجعل الأمثلة تغطي التوزيع الحقيقي، وليس فقط الحالات السهلة.

مثال لاستخراج طلقة قليلة

text
من نص تذكرة الدعم أدناه، استخرج ثلاثة حقول: «type / scope / severity». إخراج JSON فقط.

مثال 1:
الإدخال: أبلغ المستخدمون عن حالات فشل تسجيل الدخول في جميع أنحاء منطقة قوانغتشو؛ الدعم عبر الهاتف مثقل.
الإخراج: {"type":"login","scope":"Guangzhou region","severity":"P1"}

مثال 2:
الإدخال: حساب تجريبي يظهر الرصيد الخاطئ؛ يتأثر ضمان الجودة الداخلي فقط.
الإخراج: {"type":"account","scope":"internal QA","severity":"P3"}

الآن العملية:
الإدخال: تقوم بوابة API في بكين بإرجاع 502؛ يتأثر جميع المستخدمين المدفوعين.

4. تقييد تنسيق الإخراج

أي شيء يستهلكه النظام النهائي يجب أن يكون قابلاً للتحليل. JSON؟ توفير المخطط والملاحظات الميدانية. قائمة؟ قم بتثبيت العدد وشكل كل عنصر. طول القبعة؟ قل ذلك. أضف عبارة مثل «إذا كان الحقل مفقودًا، فاضبطه على قيمة خالية - لا تخترع» وسوف تقلل من الهلوسة بشكل ملموس.

JSON قيد الإخراج

text
قم بتحويل السيرة الذاتية أدناه إلى JSON، مع مطابقة هذا المخطط تمامًا:
{
  "name": string,
  "yearsOfExperience": number,
  "skills": string[],     // at most 5, lowercase
  "summary": string        // <= 60 words
}
إذا لم يذكر المصدر حقلاً ما، فاضبطه على null — لا تخترع. إخراج JSON فقط، بدون نص محيط.

5. تحليل المهام المعقدة (مع سلسلة الأفكار)

إن مطالبة النموذج بـ "التحليل + التخطيط + الإنتاج" في لقطة واحدة عادةً ما يفقد التفاصيل أو يتعامل مع المنطق باعتباره الإجابة النهائية. هناك خياران: دعه يفكر خطوة بخطوة داخليًا، أو قم بتقسيم العمل إلى عدة أدوار بنفسك. بالنسبة لسير العمل القابل للتدقيق، نفضل الخيار الأخير — احتفظ بكل وسيط حتى تتمكن لاحقًا من تحديد الخطوة التي فشلت.

قالب خطوة بخطوة

text
سأعطيك مواصفات المنتج. قم بمعالجتها في ثلاث خطوات وافصل كل منها بعنوان ##:

##1. المعلومات الأساسية
القائمة النقطية: المستخدم المستهدف، والسيناريو الأساسي، والميزات الضرورية، والأشياء خارج النطاق بشكل واضح.

##2. مخاطر ونقاط غير واضحة
قم بإدراج أي شيء غامض أو متناقض في المواصفات، جملة واحدة لكل منهما.

##3. الخطوات التالية
امنح رئيس الوزراء ثلاثة إجراءات تالية ملموسة وقابلة للتنفيذ، مرتبة حسب الأولوية.

المواصفات:
<<<

>>>

6. التكرار والتقييم

لا تتم كتابة المطالبات الجيدة، بل يتم تكرارها. أنشئ مجموعة تقييم ثابتة (حالات 20 – 50 تغطي الحالات العادية + الحافة + الخصومة). قم بتشغيله عند كل تغيير فوري وسجل معدل الإصابة ومتوسط ​​الطول وتكلفة الرمز المميز. قم بإصدار المطالبات الخاصة بك مثل التعليمات البرمجية - كل تغيير له سبب وخط أساس للانحدار، ولا يوجد "شعور أفضل هذه المرة".

قائمة التحقق من التقييم
  • مجموعة بيانات ثابتة تغطي الحالات العادية وحالات الحافة والعدائية.
  • قم بتغيير متغير واحد في كل تكرار (التعليمات، عدد الأمثلة، قيود التنسيق) - وإلا فإن الإسناد سيكون مشوشًا.
  • تتبع معدل الإصابة / متوسط ​​الرموز المميزة / أوضاع الفشل لكل إصدار في ورقة واحدة.
  • الاختبار عبر النماذج - غالبًا ما يتصرف نفس الموجه بشكل مختلف تمامًا على Claude / GPT / Gemini.
إغلاقلا يعتبر أي من هذه العناصر الستة بمثابة حل سحري، ولكنها مجتمعة معًا تمثل الفجوة بين "جاهز للإنتاج، وقابل للتنفيذ، وقابل للتصحيح" و"نوع من الأعمال". قم بتطبيق الأقسام 1 و2 و4 أولاً - ستشعر بتغير الاستقرار على الفور. ثم أضف بعض اللقطات والتقييم، وستتحول ممارستك الفورية من الحرفة إلى الهندسة.