محلل سياق البيانات

# مستخلص سياق البيانات

مهارة وصفية تستخرج معرفة البيانات الخاصة بالشركة من المحللين وتوليد مهارات تحليل بيانات مخصصة.

## كيفية العمل

لهذه المهارة نمطان:

1. **وضع الإقلاع**: إنشاء مهارة تحليل بيانات جديدة من الصفر 2. **وضع التكرار**: تحسين مهارة موجودة بإضافة ملفات مراجع خاصة بالمجال

---

## وضع الإقلاع

الاستخدام عند: رغبة المستخدم في إنشاء مهارة سياق بيانات جديدة لمستودع البيانات لديه.

### المرحلة الأولى: اتصال قاعدة البيانات والاستكشاف

**الخطوة 1: تحديد نوع قاعدة البيانات**

السؤال: "أي مستودع بيانات تستخدمون؟"

الخيارات الشائعة: - **BigQuery** - **Snowflake** - **PostgreSQL/Redshift** - **Databricks**

استخدم أدوات `~~data warehouse` (الاستعلام والمخطط) للاتصال. إذا لم يكن واضحاً، تحقق من أدوات MCP المتاحة في الجلسة الحالية.

**الخطوة 2: استكشف المخطط**

استخدم أدوات مخطط `~~data warehouse` لـ: 1. إدراج المجموعات البيانية والمخططات المتاحة 2. تحديد أهم الجداول (اسأل المستخدم: "ما أهم 3-5 جداول يبحث عنها المحللون بشكل متكرر؟") 3. سحب تفاصيل المخطط لتلك الجداول الرئيسية

استعلامات استكشافية نموذجية حسب اللهجة: ```sql -- BigQuery: إدراج مجموعات البيانات SELECT schema_name FROM INFORMATION_SCHEMA.SCHEMATA

-- BigQuery: إدراج الجداول في مجموعة بيانات SELECT table_name FROM `project.dataset.INFORMATION_SCHEMA.TABLES`

-- Snowflake: إدراج المخططات SHOW SCHEMAS IN DATABASE my_database

-- Snowflake: إدراج الجداول SHOW TABLES IN SCHEMA my_schema ```

### المرحلة الثانية: الأسئلة الأساسية (اطرح هذه الأسئلة)

بعد اكتشاف المخطط، اطرح هذه الأسئلة بطريقة طبيعية (ليس كلها مرة واحدة):

**توضيح الكيانات (حاسم)** > "عندما يقول الناس هنا 'مستخدم' أو 'عميل'، ماذا بالضبط يقصدون؟ هل هناك أنواع مختلفة؟"

استمع إلى: - أنواع كيانات متعددة (مستخدم مقابل حساب مقابل منظمة) - العلاقات بينها (واحد لواحد، واحد لكثير، كثير لكثير) - حقول المعرفات التي تربطها معاً

**المعرفات الأساسية** > "ما المعرف الرئيسي للـ [عميل/مستخدم/حساب]؟ هل هناك معرفات متعددة للكيان نفسه؟"

استمع إلى: - المفاتيح الأساسية مقابل مفاتيح الأعمال - معرفات UUID مقابل معرفات الأعداد الصحيحة - أنظمة المعرفات القديمة

**المقاييس الرئيسية** > "ما أهم 2-3 مقاييس يسأل عنها الناس؟ كيف يُحسب كل منها؟"

استمع إلى: - الصيغ الدقيقة (ARR = monthly_revenue × 12) - الجداول والأعمدة التي تغذي كل مقياس - اتفاقيات الفترات الزمنية (آخر 7 أيام، شهر تقويمي، إلخ)

**نظافة البيانات** > "ما الذي يجب أن يُستبعد دائماً من الاستعلامات؟ (بيانات الاختبار، الاحتيال، المستخدمون الداخليون، إلخ)"

استمع إلى: - جمل WHERE القياسية التي يجب تضمينها دائماً - أعمدة الأعلام التي تشير إلى الاستبعادات (is_test, is_internal, is_fraud) - قيم محددة يجب استبعادها (status = 'deleted')

**الأخطاء الشائعة** > "ما الأخطاء التي يرتكبها المحللون الجدد عادة مع هذه البيانات؟"

استمع إلى: - أسماء أعمدة مربكة - مشاكل المنطقة الزمنية - خصوصيات معالجة القيم الفارغة (NULL) - جداول الحالة التاريخية مقابل الحالة الحالية

### المرحلة الثالثة: توليد المهارة

أنشئ مهارة بهذا الهيكل:

``` [company]-data-analyst/ ├── SKILL.md └── references/ ├── entities.md # تعريفات الكيانات والعلاقات ├── metrics.md # حسابات مؤشرات الأداء الرئيسية ├── tables/ # ملف واحد لكل مجال │ ├── [domain1].md │ └── [domain2].md └── dashboards.json # اختياري: فهرس لوحات المعلومات الموجودة ```

**قالب SKILL.md**: انظر إلى `references/skill-template.md`

**قسم لهجة SQL**: انظر إلى `references/sql-dialects.md` وأضمّن ملاحظات اللهجة المناسبة.

**قالب ملف المرجع**: انظر إلى `references/domain-template.md`

### المرحلة الرابعة: الحزم والتسليم

1. أنشئ جميع الملفات في دليل المهارة 2. عبّئ كملف zip 3. قدّم للمستخدم مع ملخص ما تم التقاطه

---

## وضع التكرار

الاستخدام عند: امتلاك المستخدم مهارة موجودة لكنه يحتاج إضافة سياق إضافي.

### الخطوة 1: تحميل المهارة الموجودة

اطلب من المستخدم تحميل مهارته الموجودة (zip أو مجلد)، أو حدّد موقعها إذا كانت موجودة في الجلسة.

اقرأ SKILL.md الحالي وملفات المراجع الموجودة لفهم ما تم توثيقه بالفعل.

### الخطوة 2: تحديد الفجوة

السؤال: "أي مجال أو موضوع يحتاج إلى سياق إضافي؟ ما الاستعلامات التي تفشل أو تنتج نتائج خاطئة؟"

الفجوات الشائعة: - مجال بيانات جديد (تسويق، مالية، منتج، إلخ) - تعريفات مقاييس مفقودة - علاقات الجداول غير الموثقة - مصطلحات جديدة

### الخطوة 3: الاستكشاف المستهدف

للمجال المحدد:

1. **استكشف الجداول ذات الصلة**: استخدم أدوات مخطط `~~data warehouse` للبحث عن جداول في هذا المجال 2. **اطرح أسئلة خاصة بالمجال**: - "ما الجداول المستخدمة لتحليل [المجال]؟" - "ما أهم المقاييس لـ [المجال]؟" - "أي مرشحات أو أخطاء خاصة ببيانات [المجال]؟"

3. **توليد ملف مرجع جديد**: أنشئ `references/[domain].md` باستخدام قالب المجال

### الخطوة 4: التحديث وإعادة الحزم

1. أضف ملف المرجع الجديد 2. حدّث قسم "ملاحة قاعدة المعرفة" في SKILL.md ليشمل المجال الجديد 3. أعد حزم المهارة 4. قدّم المهارة المحدثة للمستخدم

---

## معايير ملفات المرجع

يجب أن يشمل كل ملف مرجع على:

### لتوثيق الجداول - **الموقع**: المسار الكامل للجدول - **الوصف**: