> For the complete documentation index, see [llms.txt](https://docs.crew.you/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.crew.you/ar/tools/code-development.md).

# البرمجة والتطوير

يمكن لـ Crew كتابة وتنفيذ كود Python، وتحليل البيانات، وإنشاء رسوم بيانية، وحتى إجراء تعديلات على مستودعات GitHub الخاصة بك.

## بيئة Python

يشغّل Crew كود Python في بيئة آمنة ومعزولة. كل تنفيذ يبدأ ببيئة نظيفة.

### تحليل البيانات

> "حلّل ملف CSV هذا — ابحث عن أفضل ١٠ عملاء من حيث الإيرادات، واحسب الاتجاهات الشهرية، وأنشئ رسماً بيانياً."

> "اقرأ جدول بيانات Excel وأنشئ جدولاً محورياً يُظهر المبيعات حسب المنطقة وفئة المنتج."

> "احسب الارتباط بين الإنفاق التسويقي والإيرادات من مجموعة البيانات هذه."

### إنشاء الرسوم البيانية

> "أنشئ رسماً بيانياً شريطياً يُظهر الإيرادات الشهرية من هذه البيانات: \[الصق أو ارفع البيانات]."

> "أنشئ رسماً بيانياً خطياً يقارن خطوط منتجاتنا الثلاثة خلال العام الماضي."

> "أنشئ رسماً دائرياً لتوزيع المصروفات."

### معالجة البيانات

> "نظّف ملف CSV هذا — أزل التكرارات، أصلح صيغ التاريخ، عالج القيم المفقودة، واحفظ النسخة المنظّفة."

> "ادمج جدولي البيانات هذين على عمود 'رقم العميل' وأنشئ تقريراً مجمّعاً."

> "حوّل ملف JSON هذا إلى CSV منسّق بشكل جيد."

### المكتبات المثبتة مسبقاً

تأتي البيئة مع هذه مكتبات Python جاهزة للاستخدام:

* **pandas** — معالجة البيانات وتحليلها
* **numpy** — الحوسبة العددية
* **matplotlib** — إنشاء الرسوم البيانية
* **openpyxl** — قراءة/كتابة ملفات Excel
* **python-docx** — التعامل مع مستندات Word
* **Pillow** — معالجة الصور
* **lxml** — تحليل XML/HTML

### كيف يعمل

1. تطلب من Crew تنفيذ مهمة بيانات
2. يكتب Crew كود Python
3. يُشغَّل الكود في بيئة معزولة
4. تُرجع النتائج (مخرجات نصية، ملفات، رسوم بيانية) إليك

### حدود البيئة

| الخطة  | أقصى وقت تنفيذ |
| ------ | -------------- |
| مجانية | ٣٠ ثانية       |
| أساسية | ١٢٠ ثانية      |
| بلس    | ٣٠٠ ثانية      |
| برو    | ٣٠٠ ثانية      |

### العمل مع الملفات

عند رفع ملف قبل طلب تنفيذ الكود، يكون الملف متاحاً تلقائياً في البيئة:

> \[ارفع sales\_data.xlsx] "حلّل جدول البيانات هذا وأنشئ تقريراً ملخصاً مع رسوم بيانية."

ملفات المخرجات (رسوم بيانية، بيانات معالجة، مستندات مولّدة) تُحفظ في ملفاتي.

## تكامل GitHub

> **متطلب الخطة:** خطة Pro

### إدارة المستودعات

> "اعرض مستودعاتي على GitHub."

> "اعرض المشكلات المفتوحة في my-org/my-repo."

> "ما هي طلبات السحب التي تنتظر المراجعة؟"

### الوصول عبر API

يمتلك Crew وصولاً كاملاً إلى GitHub API، فيمكنك:

* إنشاء وإدارة المشكلات
* مراجعة طلبات السحب
* فحص حالة CI/CD
* إدارة إعدادات المستودع
* وأي شيء آخر يدعمه GitHub API

## وكيل البرمجة

يمكن لوكيل البرمجة إجراء تعديلات مستقلة على مستودعات GitHub:

> "في my-org/frontend-app، أصلح نموذج تسجيل الدخول المعطل. زر الإرسال لا يعمل على الهاتف."

> "أضف التحقق من المدخلات لنموذج التسجيل في my-org/web-app."

> "أعد هيكلة وحدة قاعدة البيانات في my-org/api-server لاستخدام تجميع الاتصالات."

### كيف يعمل

1. تصف التعديل الذي تريده
2. يستنسخ Crew مستودعك في بيئة آمنة
3. يقرأ الوكيل الكود، ويفهم البنية، ويجري التعديلات
4. تُنفَّذ التعديلات في فرع جديد
5. يُنشأ طلب سحب لمراجعتك

يعمل الوكيل في الخلفية — ستُبلَّغ عند جاهزية طلب السحب.

### أفضل الممارسات

* **كن محدداً**: صِف السلوك الدقيق الذي تريده، لا مجرد "أصلح الخلل"
* **أشر إلى الملفات**: إذا كنت تعرف الملفات التي تحتاج تعديلاً، اذكرها
* **راجع دائماً**: ينشئ الوكيل طلبات سحب، لا يدفع أبداً إلى الفرع الرئيسي — راجع دائماً قبل الدمج

## سيناريوهات عملية

### خط أنابيب تحليل البيانات

> \[ارفع quarterly\_data.xlsx] "حلّل هذه البيانات الفصلية: ١) احسب النمو سنوياً لكل خط منتج، ٢) أنشئ رسوماً بيانية لأهم ٣ مؤشرات، ٣) أنشئ تقرير PDF بجميع النتائج."

### حساب سريع

> "احسب الفائدة المركبة على ١٠٠,٠٠٠ درهم بمعدل ٥٪ سنوياً لمدة ١٠ سنوات، مركبة شهرياً. اعرض جدولاً بالأرصدة السنوية."

### تحويل صيغ الملفات

> "حوّل استجابة JSON API هذه إلى جدول بيانات Excel نظيف مع عناوين أعمدة مناسبة."

### الاستخراج من الويب + التحليل

> "ابحث في الويب عن قائمة Fortune 500، استخرج أسماء الشركات والإيرادات، وأنشئ رسماً بيانياً يُظهر أعلى ٢٠ من حيث الإيرادات."

### التقارير الآلية

> "أعدّ مهمة أسبوعية: كل اثنين الساعة ٩ صباحاً، اسحب آخر البيانات من \[رابط API]، حلّل الاتجاهات، أنشئ رسماً بيانياً، وأرسل التقرير لبريدي."

## نصائح

* **ارفع الملفات أولاً**: أرفق جداول البيانات وملفات البيانات قبل طلب التحليل
* **اطلب مخرجات محددة**: "أنشئ رسماً بيانياً" جيد؛ "أنشئ رسماً شريطياً بالإيرادات الشهرية على المحور Y والأشهر على المحور X، ملوّن حسب خط المنتج" أفضل
* **كرّر**: إذا لم يكن التحليل الأول مثالياً، اطلب من Crew التعديل — يتذكر السياق
* **احفظ النتائج**: اطلب من Crew حفظ المخرجات المهمة في ملفاتي أو Google Drive
* **ادمج مع البريد**: "حلّل البيانات، أنشئ تقريراً، وأرسله بالبريد للفريق"
* **تحتاج مزيداً من العمق؟** للتحليلات المعقدة أو الأبحاث التي تحتاج مستندات منسقة، جرّب [Deep Work](/ar/tools/deep-work.md)