دليل التشغيل

# /runbook

> إذا رأيت عناصر نائبة غير مألوفة أو كنت بحاجة للتحقق من الأدوات المتصلة، راجع [CONNECTORS.md](../../CONNECTORS.md).

إنشاء دليل تشغيلي خطوة بخطوة لمهمة أو إجراء متكرر.

## الاستخدام

``` /runbook $ARGUMENTS ```

## المخرجات

```markdown ## دليل التشغيل: [اسم المهمة] **المالك:** [الفريق/الشخص] | **التكرار:** [يومي/أسبوعي/شهري/حسب الحاجة] **آخر تحديث:** [التاريخ] | **آخر تشغيل:** [التاريخ]

### الغرض [ما يحققه هذا الدليل ومتى يتم استخدامه]

### المتطلبات الأساسية - [ ] [الوصول أو الإذن المطلوب] - [ ] [الأداة أو النظام المطلوب] - [ ] [البيانات أو المدخلات المطلوبة]

### الإجراء

#### الخطوة 1: [الاسم] ``` [الأمر أو الإجراء أو التعليمات الدقيقة] ``` **النتيجة المتوقعة:** [ما يجب أن يحدث] **في حالة الفشل:** [ما يجب فعله]

#### الخطوة 2: [الاسم] ``` [الأمر أو الإجراء أو التعليمات الدقيقة] ``` **النتيجة المتوقعة:** [ما يجب أن يحدث] **في حالة الفشل:** [ما يجب فعله]

### التحقق - [ ] [كيفية تأكيد إكمال المهمة بنجاح] - [ ] [ما الذي يجب التحقق منه]

### استكشاف الأخطاء | الأعراض | السبب المحتمل | الحل | |---------|-------------|-----| | [ما تراه] | [السبب] | [ما يجب فعله] |

### الاسترجاع [كيفية التراجع عن هذا إذا حدث خطأ ما]

### التصعيد | الحالة | جهة الاتصال | الطريقة | |-----------|---------|--------| | [متى يتم التصعيد] | [من] | [كيفية التواصل معهم] |

### السجل | التاريخ | من قام بالتشغيل | ملاحظات | |------|--------|-------| | [التاريخ] | [الشخص] | [أي مشاكل أو ملاحظات] | ```

## إذا كانت الموصلات متاحة

إذا كانت **قاعدة المعرفة** متصلة: - ابحث عن أدلة تشغيل موجودة لتحديثها بدلاً من الإنشاء من الصفر - انشر دليل التشغيل المكتمل في wiki العمليات الخاص بك

إذا كانت **ITSM** متصلة: - ربط الدليل بأنواع الحوادث وطلبات التغيير ذات الصلة - ملء جهات الاتصال للتصعيد تلقائياً من جداول الخدمة على مدار الساعة

## نصائح

1. **كن محدداً بدقة** — "قم بتشغيل البرنامج النصي" ليست خطوة. "قم بتشغيل `python sync.py --prod --dry-run` من خادم العمليات" هي الصيغة الصحيحة. 2. **تضمين أوضاع الفشل** — ما الذي يمكن أن يحدث بشكل خاطئ في كل خطوة وماذا تفعل حيال ذلك. 3. **اختبر الدليل** — اطلب من شخص غير مألوف بالعملية أن يتبعه. أصحح المواضع التي يعلقون فيها.