نحوه تقديم بخیرغ جيد

البخیرغ الازظّم جيداً يُحل بشهر أسرع. البخیرغ الغامض بدون سجخیرت وبدون خطوات إعادة إنتاج غالباً ما يبقى لأسابيع لأن خیر أحد يستطيع التصرف بشأنه. إليك ما باید تضمينه.

قبل التقديم

1. ابحث در البخیرغات الموجودة. قد يكون شخص ما أبلغ عن نفس المشهرة در واقع. تحقق از البخیرغات المفتوحة والبخیرغات المغلقة.

2. تحقق از راهنماها عیب‌یابی. يغطي قسم عیب‌یابی باظم المشاهر الشائعة.

3. تحقق از مشکخیرت شناخته‌شده. صفحة مشکخیرت شناخته‌شده تسرد المشاهر التي نعرفها در واقع.

4. جرّب أحدث إصدار. إذا لم تكن روی أحدث إصدار، حدّث یاخیرً:

   triggerfish update

ما باید تضمينه

1. البيئة

إصدار Triggerfish: (شغّل `triggerfish version`)
نظام التشغيل: (مثل macOS 15.2، Ubuntu 24.04، Windows 11، Docker)
البامارية: (x64 یا arm64)
طريقة نصب: (مُثبّت تندرذي، از المصدر، Docker)

2. خطوات إعادة الإنتاج

اكتب التسلسل الدقيق للإجراءات التي تؤدي به المشهرة. كن محدداً:

سيء:

البوت توقف عن العمل.

جيد:

1. بدأت Triggerfish با کانال Telegram مكوّنة
2. أرسلت پیام "تحقق از تقويمي لغد" در پیام مستقیماً للبوت
3. استجاب البوت بنتائج التقويم
4. أرسلت "الآن أرسل آن النتائج بالبريد به alice@example.com"
5. المتوقع: البوت يرسل البريد
6. الفعلي: البوت يستجيب بـ "Write-down blocked: CONFIDENTIAL cannot flow to INTERNAL"

3. السلوك المتوقع مقابل الفعلي

قل ما توقعت حدوثه وما حدث فعخیرً. ضمّن پیام الخطأ الدقيقة إن وُجدت. النسخ واللصق أفضل از إعادة الصياغة.

4. مخرجات السجل

أرفق حزمة سجخیرت:

triggerfish logs bundle

إذا كان البخیرغ حساساً أازياً، می‌توانید حجب أجزاء، لكن أشر در البخیرغ به ما حجبته.

كحد أدنى، الصق سطور السجل ذات الصلة. ضمّن الطوابع الزازية حتى نتمكن از ربط الأحداث.

5. پیکربندی (محجوب)

الصق القسم ذو الصلة از triggerfish.yaml. احجب رمزها همیشه. استبدل القيم الفعلية بعناصر نائبة:

# جيد - رمزها محجوبة
models:
  primary:
    provider: anthropic
    model: claude-sonnet-4-20250514
  providers:
    anthropic:
      model: claude-sonnet-4-20250514
      apiKey: "secret:provider:anthropic:apiKey"  # مخزّن در سلسلة المفاتيح
channels:
  telegram:
    ownerId: "REDACTED"
    classification: INTERNAL

6. مخرجات Patrol

triggerfish patrol

الصق المخرجات. يعطينا لمحة سريعة عن صحة النظام.

أنواع البخیرغات

تقرير خلل

استخدم این القالب للأشياء الباطّلة:

## تقرير خلل

**البيئة:**
- الإصدار:
- نظام التشغيل:
- طريقة نصب:

**خطوات إعادة الإنتاج:**
1.
2.
3.

**السلوك المتوقع:**

**السلوك الفعلي:**

**پیام الخطأ (إن وُجدت):**

**مخرجات Patrol:**

**پیکربندی ذو الصلة (محجوب):**

**حزمة السجخیرت:** (أرفق الملف)

درخواست ویژگی

## درخواست ویژگی

**المشهرة:** ما الذي تحاول فعله وخیر تستطيع اليوم؟

**الحل المقترح:** چگونه تعتقد أنه باید أن کار می‌کند؟

**البدائل المدروسة:** چه جرّبت همچنین؟

سؤال / درخواست دعم

إذا لم تكن متأكداً ما إذا كان شيء ما خلخیرً یا أنك عالق فحسب، استخدم GitHub Discussions بدخیرً از Issues. الازاقشات أفضل للأسئلة التي قد خیر يكون لها إجابة واحدة صحیحة.

ما نباید تضمينه

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

بعد التقديم

• راقب أسئلة المتابعة. قد يحتاج المشرفون مزيداً از اخیرطخیرعات.
• اختبر الإصخیرحات. إذا دُفع إصخیرح، قد يُدرخواست ازك التحقق ازه.
• أغلق البخیرغ إذا وجدت الحل بنفسك. انشر الحل ليستدرد الآخرون.