> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lasersell.io/llms.txt
> Use this file to discover all available pages before exploring further.

# مهارات البرمجة

> ثبّت معرفة حزمة التطوير المُعبأة مسبقاً في مساعد البرمجة الذكي الخاص بك حتى يتمكن من كتابة تكاملات LaserSell مع سياق كامل عن الأنماط وتوقيعات الطرق والأمثلة واستكشاف الأخطاء.

تمنح مهارات البرمجة مساعد البرمجة الذكي معرفة عميقة ومدمجة بحزمة تطوير LaserSell. بدلاً من البحث في الوثائق حسب الطلب، يحمّل المساعد أنماط حزمة التطوير وتوقيعات الطرق والأمثلة العملية وتكوينات الاستراتيجية وإرشادات استكشاف الأخطاء مباشرة في نافذة السياق. هذا يعني أنه يستطيع كتابة كود LaserSell صحيح من البداية دون الحاجة للبحث عن أي شيء.

## المهارات مقابل MCP

يقدم LaserSell مسارين لتكامل الذكاء الاصطناعي. يخدمان أغراضاً مختلفة ويعملان بشكل أفضل معاً.

|                       | خادم MCP                                                                                  | مهارات البرمجة                                                             |
| --------------------- | ----------------------------------------------------------------------------------------- | -------------------------------------------------------------------------- |
| **كيف يعمل**          | يبحث في وثائق LaserSell حسب الطلب عندما يحتاج المساعد للبحث عن شيء                        | يحمّل معرفة عميقة بحزمة التطوير مباشرة في سياق المساعد قبل بدء كتابة الكود |
| **الأفضل لـ**         | البحث عن مخططات الواجهة البرمجية وإيجاد صفحات وثائق محددة والإجابة عن أسئلة حول LaserSell | كتابة تكاملات حزمة التطوير وبناء المعاملات والاتصال بالبث ومعالجة الأخطاء  |
| **متى تتوفر المعرفة** | حسب الطلب (يجب أن يطلبها المساعد)                                                         | فوراً (المساعد يمتلكها بالفعل في السياق)                                   |
| **الإعداد**           | أضف تكوين خادم MCP إلى محررك                                                              | ثبّت حزمة المهارة                                                          |

خادم MCP ممتاز للاكتشاف والبحث المرجعي. مهارات البرمجة ممتازة لكتابة الكود الذي يتكامل مع حزمة التطوير. استخدم كليهما للحصول على أفضل تجربة.

## ما يتضمنه

تُرسل مهارة البرمجة من LaserSell شجرة معرفة منظمة يحمّلها المساعد عند العمل على كود LaserSell:

* **SKILL.md** — ملف المهارة الجذري مع نظرة عامة على حزمة التطوير والمفاهيم الرئيسية ومؤشرات إلى المراجع التفصيلية
* **أمثلة عملية بـ 4 لغات** — أمثلة TypeScript وPython وRust وGo تغطي معاملات الشراء/البيع واتصالات البث وتكوين الاستراتيجية وتقديم المعاملات
* **دليل الاستراتيجية** — مرجع تفصيلي لتكوين جني الأرباح ووقف الخسارة والوقف المتحرك والبيع عند التخرج ومهلة الموعد النهائي
* **دليل استكشاف الأخطاء** — الأخطاء الشائعة وأسبابها وإصلاحاتها
* **مراجع الواجهة البرمجية والأنواع** — مخططات الطلب/الاستجابة وقيم التعداد وأوصاف الحقول لكل نقطة نهاية
* **مرجع بروتوكول البث** — تنسيق رسائل بث ذكاء الخروج الكامل وأنواع الأحداث ودورة حياة الاتصال
* **قوالب** — قوالب كود جاهزة لأنماط التكامل الشائعة

## التثبيت

### الخيار 1: npx (موصى به)

```bash theme={null}
npx skills add lasersell/skills
```

يحمّل ويثبّت مهارة البرمجة من LaserSell في مشروعك. يلتقطها المساعد تلقائياً في الجلسة التالية.

### الخيار 2: Claude Code CLI

```bash theme={null}
claude install-skill https://github.com/lasersell/skills/tree/main/skills/lasersell
```

### الخيار 3: يدوي

انسخ مجلد `skills/lasersell/` من [مستودع مهارات LaserSell](https://github.com/lasersell/skills) إلى مجلد `.claude/skills/` في مشروعك:

```bash theme={null}
mkdir -p .claude/skills
cp -r path/to/skills/lasersell .claude/skills/
```

سيكتشف المساعد ملفات المهارة ويحمّلها في السياق عند العمل على كود LaserSell.

## ما تغطيه المهارة

بمجرد التثبيت، يمتلك مساعد الذكاء الاصطناعي سياقاً كاملاً حول هذه المواضيع:

**بناء معاملات الشراء والبيع.** يعرف المساعد كيفية بناء كائنات `BuildBuyTxRequest` و`BuildSellTxRequest` واستدعاء LaserSell API ومعالجة الاستجابة عبر لغات حزمة التطوير الأربع. يفهم أنواع المخرجات (SOL مقابل USD1) وتكوين الانزلاق والبيع الجزئي.

**بث ذكاء الخروج.** يستطيع المساعد كتابة كود اتصال البث وتكوين معاملات الاستراتيجية ومعالجة جميع أنواع أحداث الخادم (`pnl_update` و`exit_signal_with_tx` و`position_opened` و`position_closed` و`liquidity_snapshot`) ومعالجة إشارات الخروج من البداية إلى النهاية.

**البيع الجزئي ومتعدد الخطوات.** يفهم المساعد كيفية الاستعلام عن نطاقات الانزلاق وتحديد الحد الأقصى للمبلغ القابل للبيع عند عتبة انزلاق معينة وبناء معاملات بيع جزئية. يمكنه أيضاً بناء تسلسلات بيع متعددة الخطوات للمراكز الكبيرة.

**لقطات السيولة.** يعرف المساعد كيفية قراءة نطاقات الانزلاق وتفسير اتجاهات السيولة (`growing` و`stable` و`draining`) واستخدام بيانات اللقطة لتحديد حجم البيع بشكل مثالي.

**توقيع وتقديم المعاملات.** يستطيع المساعد كتابة كود توقيع المعاملات محلياً ويفهم جميع أهداف الإرسال: RPC الافتراضي وRPC المخصص وHelius Sender. يعرف متى يستخدم كل واحد وكيفية تكوينه.

**معالجة الأخطاء.** يمتلك المساعد سياقاً عن رموز الأخطاء الشائعة وأنماط إعادة المحاولة وإخفاقات الانزلاق واستعادة الاتصال لكل من واجهة REST البرمجية والبث.

## الجمع بين المهارات وMCP

للحصول على أفضل تجربة برمجة بالذكاء الاصطناعي، استخدم كلاً من مهارة البرمجة وخادم MCP معاً:

1. **ثبّت مهارة البرمجة** حتى يمتلك مساعدك معرفة عميقة بحزمة التطوير محمّلة في السياق كلما كتبت كود LaserSell.
2. **اربط خادم MCP** حتى يتمكن مساعدك من البحث في الوثائق الكاملة عندما يحتاج للبحث عن شيء خارج نطاق المهارة مثل تفاصيل رسوم الشركاء أو مستويات حدود المعدل أو إدخالات سجل التغييرات.

مع تنشيط كليهما، يستطيع المساعد كتابة كود حزمة التطوير الصحيح فوراً (من المهارة) والبحث عن معلومات تكميلية حسب الطلب (من MCP).

راجع [خادم MCP](/ai-agents/mcp-server) لتعليمات إعداد MCP.