توليد الإرشادات

# توليد المبادئ التوجيهية

إنشاء مبادئ توجيهية شاملة وجاهزة لـ LLM حول صوت العلامة التجارية من أي مزيج من المصادر — وثائق العلامة التجارية، نصوص مكالمات المبيعات، تقارير الاكتشاف، أو إدخال المستخدم المباشر. تحويل المواد الخام إلى مبادئ توجيهية منظمة وقابلة للتنفيذ مع درجات الثقة والأسئلة المفتوحة.

## المدخلات

قبول أي مزيج من: - **تقرير الاكتشاف** من مهارة discover-brand (منظم، مفروز مسبقا) - **وثائق العلامة التجارية** المرفوعة أو من المنصات المتصلة (PDF, PPTX, DOCX, MD, TXT) - **نصوص المحادثات** من Gong أو Granola أو التحميلات اليدوية أو ملاحظات اجتماعات Notion - **إدخال المستخدم المباشر** حول صوت العلامة التجارية والقيم الخاصة بهم

عند توفر تقرير اكتشاف، استخدمه كمدخل أساسي — المصادر مفروزة ومرتبة مسبقا. أكمل بتحليل إضافي حسب الحاجة.

## سير عمل التوليد

### 1. تحديد وتصنيف المصادر

تحديد ما قدمه المستخدم. إذا لم تكن هناك مصادر متاحة: - التحقق من وجود تقرير اكتشاف من تشغيل `/brand-voice:discover-brand` السابق - التحقق من `.claude/brand-voice.local.md` للحصول على مواقع مواد العلامة التجارية المعروفة - اقتراح تشغيل الاكتشاف أولا: `/brand-voice:discover-brand`

### 2. معالجة المصادر

**للوثائق:** تفويض وكيل تحليل الوثائق للتحليل الثقيل. استخراج سمات الصوت، موضوعات الرسائل، المصطلحات، توجيهات النبرة، والأمثلة.

**للنصوص:** تفويض وكيل تحليل المحادثة لتعرف الأنماط. استخراج سمات الصوت الضمنية، أنماط اللغة الناجحة، النبرة حسب السياق، والأنماط المضادة.

**لتقارير الاكتشاف:** استخراج المصادر المفروزة مسبقا والتضاربات والفجوات. استخدم المصادر المرتبة مباشرة.

### 3. دمج المبادئ التوجيهية

دمج جميع النتائج في وثيقة مبادئ توجيهية موحدة باتباع القالب في `references/guideline-template.md`. الأقسام الرئيسية:

**جدول "نحن عليه / لسنا عليه"** — لنقطة الارتساء الأساسية للهوية:

| نحن عليه | لسنا عليه | |---------|---------| | [السمة — مثل "واثق"] | [النقيض — مثل "متغطرس"] | | [السمة — مثل "ودود"] | [النقيض — مثل "عرضي أو مهمل"] |

استخلص السمات من أكثر الأنماط اتساقا عبر المصادر. يجب أن يكون لكل صف أدلة داعمة.

**ثوابت الصوت مقابل مرونة النبرة** — توضيح ما يبقى ثابتا وما يتكيف: - **الصوت** = الشخصية والقيم و"نحن عليه / لسنا عليه" — ثابت عبر جميع المحتوى - **النبرة** = الرسمية والطاقة والعمق التقني — يتكيف حسب السياق

**مصفوفة النبرة حسب السياق:**

| السياق | الرسمية | الطاقة | العمق التقني | مثال | |--------|---------|--------|---------|---------| | المراسلة الباردة | متوسطة | عالية | منخفضة | "[مثال على العبارة]" | | اقتراح المؤسسات | عالية | متوسطة | عالية | "[مثال على العبارة]" | | وسائل التواصل الاجتماعي | منخفضة | عالية | منخفضة | "[مثال على العبارة]" |

### 4. إسناد درجات الثقة

اسند درجات لكل قسم باستخدام منهجية في `references/confidence-scoring.md`: - **ثقة عالية**: 3 مصادر أو أكثر متطابقة، توجيهات صريحة موجودة - **ثقة متوسطة**: 1-2 مصادر، أو مستنتجة من الأنماط - **ثقة منخفضة**: مصدر واحد، مستنتجة، أو بيانات متضاربة

### 5. إبراز الأسئلة المفتوحة

توليد أسئلة مفتوحة لأي غموض لا يمكن حله:

```markdown ## أسئلة مفتوحة لنقاش الفريق

### أولوية عالية (تعيق اكتمال المبادئ التوجيهية) 1. **[عنوان السؤال]** - ما تم العثور عليه: [معلومات متضاربة أو غير كاملة] - توصية الوكيل: [القرار المقترح مع الأسباب] - ما نحتاجه منك: [قرار محدد أو تأكيد مطلوب] ```

كل سؤال مفتوح يجب أن يتضمن توصية من الوكيل. حول الغموض إلى "تأكيد أو استبدال" — لا تترك منفذا مسدودا.

### 6. فحص الجودة

قبل العرض، تحقق عبر وكيل ضمان الجودة (معرف في `agents/quality-assurance.md`): - جميع الأقسام الرئيسية معبأة (بما في ذلك Brand Personality وContent Examples إذا دعمت المصادر) - 3 سمات صوت على الأقل مع أدلة - جدول "نحن عليه / لسنا عليه" يحتوي على 4 صفوف أو أكثر - مصفوفة النبرة تغطي 3 سياقات على الأقل - درجات ثقة مسندة حسب القسم - الإسناد إلى المصادر لجميع العناصر المستخلصة - عدم كشف بيانات شخصية - الأسئلة المفتوحة تتضمن توصيات

### 7. العرض وتقديم الخطوات التالية

ملخص النتائج الرئيسية: - إجمالي الأقسام المولدة مع تفاصيل الثقة - أقوى سمة صوت وأكثر رسالة فعالية - عدد الأسئلة المفتوحة (إن وجدت)

### 8. الحفظ للجلسات المستقبلية

موقع الحفظ الافتراضي هو `.claude/brand-voice-guidelines.md` داخل مجلد العمل للمستخدم.

**مهم:** قد لا يكون مجلد عمل الوكيل هو جذر المشروع الخاص بالمستخدم (خاصة في Cowork حيث تعمل المكونات الإضافية من مجلد ذاكرة تخزين مؤقت للمكون). حل دائما المسار بالنسبة إلى مجلد العمل الخاص بالمستخدم وليس مجلد العمل الحالي. إذا لم يتم تعيين مجلد عمل، تخط حفظ الملف وأخبر المستخدم أن المبادئ التوجيهية ستكون متاحة فقط في هذه المحادثة.

1. **حل مسار الحفظ.** يجب حفظ الملف في `.claude/brand-voice-guidelines.md` داخل مجلد العمل الخاص بالمستخدم. أكد مسار مجلد العمل