---
name: help-article-writer
description: تكتب مقالة لمركز المساعدة أو قاعدة المعرفة عن مهمة واحدة يؤديها العميل، عنوانها المهمة نفسها، تبدأ بالإجابة، ثم خطوات مرقّمة بأسماء عناصر الواجهة كما تظهر حرفيًا، وأماكن لقطات الشاشة، وقسم لحل المشكلات، ومقالات ذات صلة. استخدمها حين يطلب أحد مقالة مساعدة، أو مستند دعم، أو دليل «كيف أفعل»، أو صفحة في قاعدة المعرفة (knowledge base)، أو تحويل رد على تذكرة أو ملاحظة إصدار أو ملاحظات أولية إلى مقالة يتبعها العميل وحده.
---

# كاتب مقالات المساعدة

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

## متى تستخدمها

- سؤال يتكرر في التذاكر وإجابته موجودة فقط في ردود موظفي الدعم.
- أُطلقت ميزة ويحتاج العملاء إلى معرفة طريقة استخدامها.
- مقالة موجودة طويلة، أو قديمة، أو مكتوبة بمصطلحات داخلية.
- ليست لقائمة أسئلة شائعة تغطي أسئلة كثيرة: استخدم faq-from-tickets. وليست لملاحظات الإصدار: استخدم release-notes.

## ما الذي تحتاجه

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

## الخطوات

1. **اجعل العنوان هو المهمة.** ابدأ بفعل بالصيغة التي يبحث بها العملاء: «صدّر جهات اتصالك إلى ملف CSV»، «أضف زميلًا إلى مساحة العمل». لا «ميزة التصدير» ولا «فهم عمليات التصدير». مهمة واحدة لكل مقالة؛ إن غطت الملاحظات مهمتين فاكتب مقالتين.
2. **أجب في أول جملتين.** قل ما تفعله المهمة وأقصر طريق إليها: «يمكنك تصدير جهات الاتصال من **جهات الاتصال** > **تصدير**. يصلك الملف بالبريد خلال دقائق.» ثم من يستطيع فعلها وما يحتاجه أولًا (الدور، أو الخطة، أو الصلاحية).
3. **اكتب خطوات مرقّمة، إجراء واحد في كل خطوة.** ابدأ كل خطوة بالفعل. ضع أسماء عناصر الواجهة بخط عريض، كما تظهر حرفيًا. اكتب مسارات القوائم هكذا: **الإعدادات** > **الفريق**، والأسهم بخط عادي. اذكر المكان قبل الإجراء: «في الزاوية العلوية، انقر **الإعدادات**.» اجعلها من 3 إلى 10 خطوات؛ وإن طالت فقسّمها إلى أقسام لكل منها عنوانه.
4. **قل كيف يبدو النجاح.** بعد آخر خطوة، سطر واحد عما يجب أن يراه العميل إن نجح الأمر: رسالة، أو ملف، أو عنصر جديد في قائمة.
5. **حدّد أماكن لقطات الشاشة حيث تفيد.** أضف مكانًا للقطة بعد خطوة يصعب فيها العثور على العنصر أو تكون الشاشة مزدحمة، لا بعد كل خطوة. اكتب ما تُظهره اللقطة، لتُلتقط لاحقًا وتُستخدم نصًا بديلًا.
6. **أضف حل المشكلات من مشكلات حقيقية.** كل بند عنوانه العَرَض بكلمات العميل، ثم السبب والحل في جملة إلى 3 جمل. استخدم فقط مشكلات من التذاكر أو من فريق المنتج؛ لا تخترع أخطاء.
7. **اربط من 2 إلى 4 مقالات ذات صلة.** المهمة التالية التي سيؤديها على الأرجح، والمتطلب السابق. استخدم العناوين الحقيقية للمقالات إن أُعطيت؛ وإلا فاكتب «[ذات صلة: الموضوع]».

## صيغة المخرجات

```markdown
# [عنوان المهمة يبدأ بفعل]

[ما تفعله المهمة وأقصر طريق إليها، جملة أو جملتان.]

**من يستطيع فعل ذلك:** [الدور / الخطة] · **قبل أن تبدأ:** [المتطلب السابق، أو احذف هذا الجزء]

## [المهمة، أو الجزء الأول منها]
1. [المكان]، انقر **[الاسم]**.
2. [...]

![لقطة شاشة: ما تُظهره]

عند النجاح، [ما يراه العميل].

## حل المشكلات
### [العَرَض بكلمات العميل]
[السبب والحل، جملة إلى 3 جمل.]

## مقالات ذات صلة
- [عنوان المقالة]
```

## مثال

**المدخلات:**

> ملاحظات من فريق المنتج: يستطيع المشرفون دعوة الزملاء من الإعدادات ← الفريق ← زر «دعوة أشخاص»، يكتبون عناوين البريد (مفصولة بفواصل)، ويختارون الدور «عضو» أو «مشاهد»، ثم «إرسال الدعوات». تنتهي صلاحية الدعوة بعد 7 أيام. من التذاكر: يقول الناس إن بريد الدعوة لم يصل أبدًا (غالبًا في مجلد الرسائل غير المرغوب فيها، أو العنوان خطأ)؛ وزر «دعوة أشخاص» باهت لغير المشرفين.

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

```markdown
# ادعُ زميلًا إلى مساحة العمل

يمكنك دعوة زملائك من **الإعدادات** > **الفريق** > **دعوة أشخاص**. يصلهم بريد فيه رابط للانضمام؛ ويعمل الرابط لمدة 7 أيام.

**من يستطيع فعل ذلك:** مشرفو مساحة العمل

## أرسل دعوة
1. في القائمة الجانبية، انقر **الإعدادات**.
2. انقر **الفريق**.
3. انقر **دعوة أشخاص**.
4. اكتب عنوان بريد واحدًا أو أكثر، مفصولة بفواصل.
5. اختر الدور: **عضو** أو **مشاهد**.
6. انقر **إرسال الدعوات**.

![لقطة شاشة: نافذة «دعوة أشخاص» وفيها عنوانا بريد مكتوبان وقائمة الأدوار مفتوحة]

عند النجاح، يظهر كل شخص في قائمة الفريق بحالة «مدعو» حتى ينضم.

## حل المشكلات
### لم يصل بريد الدعوة
اطلب منه أن يفحص مجلد الرسائل غير المرغوب فيها. إن لم تكن هناك، فتحقق من العنوان في قائمة الفريق، ثم أرسل الدعوة مرة أخرى.

### زر «دعوة أشخاص» باهت
المشرفون وحدهم يستطيعون الدعوة. اطلب من أحد مشرفي مساحة العمل أن يدعوه، أو أن يجعلك مشرفًا.

## مقالات ذات صلة
- [ذات صلة: تغيير دور زميل]
- [ذات صلة: إزالة زميل]
```

## تحقق قبل الإرسال

- [ ] العنوان يبدأ بفعل ويسمّي مهمة واحدة.
- [ ] أول جملتين تجيبان عن السؤال دون الخطوات.
- [ ] في كل خطوة إجراء واحد، وكل اسم في الواجهة بخط عريض ومطابق للمنتج أو موسوم «[تحقق من الاسم]».
- [ ] تقول المقالة من يستطيع فعل ذلك وكيف يبدو النجاح.
- [ ] كل بند في حل المشكلات مصدره التذاكر أو فريق المنتج.
- [ ] لا تظهر أي مصطلحات داخلية (تذكرة، SKU، feature flag، الواجهة الخلفية).

## أخطاء شائعة

- البدء بخلفية عامة («الفرق جزء مهم من...»). القارئ جاء من أجل الخطوات.
- كتابة «انتقل إلى صفحة الإعدادات واضبط فريقك». سمِّ كل نقرة.
- لقطة شاشة بعد كل خطوة. تطيل الصفحة وتتقادم مع كل تغيير في الواجهة.