diff --git a/README.md b/README.md index 0595bc5..024b1ec 100644 --- a/README.md +++ b/README.md @@ -14,6 +14,7 @@ [![OpenClaw Plugin](https://img.shields.io/badge/OpenClaw-Plugin-blue.svg)](https://github.com/openclaw/openclaw) [![Skills](https://img.shields.io/badge/Skills-60-orange.svg)](#skills) [![Landing Page](https://img.shields.io/badge/Website-Live-teal.svg)](https://moshe-ship.github.io/mkhlab/) +[![عربي](https://img.shields.io/badge/README-عربي-red.svg)](README_AR.md) diff --git a/README_AR.md b/README_AR.md new file mode 100644 index 0000000..9c92877 --- /dev/null +++ b/README_AR.md @@ -0,0 +1,310 @@ +
+ +مخلب logo + +# مخلب — Mkhlab + +### مُساعِدُكَ الذَّكِيُّ العَرَبِيُّ. مَفْتوحُ المَصْدَرِ. يَعْمَلُ عَلَى جِهازِكَ. بَياناتُكَ عِنْدَكَ. + +**أَوَّلُ إِضافَةٍ تَجْعَلُ العَرَبِيَّةَ أَوَّلًا لِمِنَصَّةِ [OpenClaw](https://github.com/openclaw/openclaw).** + +60 مَهارَةَ ذَكاءٍ اصْطِناعِيٍّ عَرَبِيَّةٍ · 3 أَدَواتٍ · قَناتانِ · واعٍ بِاللَّهَجاتِ · يَعْمَلُ مَعَ أَيِّ نَمُوذَجٍ + +[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE) +[![OpenClaw Plugin](https://img.shields.io/badge/OpenClaw-Plugin-blue.svg)](https://github.com/openclaw/openclaw) +[![Skills](https://img.shields.io/badge/Skills-60-orange.svg)](#skills) +[![Landing Page](https://img.shields.io/badge/Website-Live-teal.svg)](https://moshe-ship.github.io/mkhlab/) + +
+ +
+مخلب demo +
+ +--- + +## ما هُوَ مِخْلَب؟ + +**مِخْلَب** (Mkhlab) هُوَ إِضافَةٌ تَضَعُ العَرَبِيَّةَ فِي المَقامِ الأَوَّلِ لِمِنَصَّةِ OpenClaw، مُساعِدِ البَرْمَجَةِ الذَّكِيِّ مَفْتوحِ المَصْدَرِ. يُضِيفُ 60 مَهارَةً مُوَجَّهَةً لِلْعَرَبِيَّةِ، مَعَ العَمَلِ مَعَ **أَيِّ مُزَوِّدِ نَماذِجَ** (Claude وَGPT وَGemini وَQwen وَJais وَALLaM وَOllama وَغَيْرِهِم). + +لا يُوجَدُ مُساعِدُ ذَكاءٍ اصْطِناعِيٍّ آخَرُ يُقَدِّمُ هذِهِ التَّرْكِيبَةَ: +- **اكْتِشافُ اللَّهَجاتِ** — يَرُدُّ بِلَهْجَتِكَ (مِصْرِيَّةٌ، خَلِيجِيَّةٌ، شامِيَّةٌ، مَغارِبِيَّةٌ، عِراقِيَّةٌ) +- **مُراعَاةٌ إِسْلامِيَّةٌ** — يَعْرِفُ أَوْقاتَ الصَّلاةِ وَالتَّوارِيخَ الهِجْرِيَّةَ، وَيَتَعامَلُ مَعَ المَواضِيعِ الدِّينِيَّةِ بِاحْتِرامٍ +- **أَدَواتُ مُعالَجَةِ اللُّغَةِ العَرَبِيَّةِ** — تَحْسِينُ التُّوكِناتِ، وَفِلْتَرَةُ المُحْتَوَى، وَاخْتِبارُ RTL، وَفَحْصُ مَجْمُوعاتِ البَياناتِ +- **دَعْمُ العَرَبِيزِيَّةِ** — يَفْهَمُ "7abibi" وَ"3adi" +- **التَّبْدِيلُ بَيْنَ اللُّغَتَيْنِ** — يَتَعامَلُ طَبِيعِيًّا مَعَ المَزْجِ بَيْنَ العَرَبِيَّةِ وَالإِنْجِلِيزِيَّةِ + +## البَدْءُ السَّرِيعُ + +### المُتَطَلَّباتُ المُسْبَقَةُ +- [OpenClaw](https://github.com/openclaw/openclaw) v2026.3.20+ +- Node.js 18+ +- Python 3.10+ (لأدوات سطر الأوامر) + +### التَّثْبِيتُ + +```bash +# الاستنساخ +git clone https://github.com/mousaabumazin/mkhlab.git +cd mkhlab + +# أَخْبِر OpenClaw بِمَكانِ المَهاراتِ +# أَضِفْ إِلى ~/.openclaw/openclaw.json: +{ + "skills": { + "load": { + "extraDirs": ["/skills"] + } + } +} + +# تَثْبِيتُ أَدَواتِ CLI العَرَبِيَّةِ (اخْتِيَارِيٌّ لِلْحُصُولِ عَلى 14/14 مَهارَةً كامِلَةً) +pipx install -e ./tools/arabench +pipx install -e ./tools/khalas +pipx install -e ./tools/sarih +pipx install -e ./tools/bidi-guard +pipx install -e ./tools/qalam +pipx install -e ./tools/artok +pipx install -e ./tools/majal +pipx install -e ./tools/safha +pipx install -e ./tools/raqeeb +``` + +### التَّحَقُّقُ + +```bash +openclaw skills list | grep "openclaw-extra" +``` + +يُنْتَظَرُ أَنْ تَرَى 60 مَهارَةً، وَكُلُّها ✓ جاهِزَةٌ. + +## المَهاراتُ + +### 🕌 إِسْلامِيٌّ وَثَقافِيٌّ (6) +| المهارة | الوصف | +|-------|-------------| +| 🕌 `prayer-times` | أوقات الصلاة — جلب أوقات الصلاة عبر Aladhan API | +| 📅 `hijri-calendar` | التقويم الهجري — تحويل هجري ↔ ميلادي + المناسبات الإسلامية | +| 📖 `quran-search` | بحث القرآن — البحث بالكلمة المفتاحية أو السورة أو الآية | +| 📜 `hadith-search` | بحث الأحاديث — البحث في كتب الحديث مثل البخاري ومسلم وغيرها | +| 🕋 `adhan-player` | مشغّل الأذان — تشغيل الأذان بأصوات أكثر من 10 مؤذنين | +| 💰 `islamic-finance` | المالية الإسلامية — حاسبة زكاة ومدقق استثمارات متوافقة مع الحلال | + +### 🗣️ اللُّغَةُ وَالثَّقافَةُ (6) +| المهارة | الوصف | +|-------|-------------| +| 🔄 `translate` | ترجمة — ترجمة عربي ↔ إنجليزي مع مراعاة اللهجة | +| 🗣️ `dialect-detect` | اللهجات — اكتشاف لهجة المستخدم والتكيّف معها | +| ✏️ `arabic-grammar` | مدقق القواعد — تصحيح الأخطاء النحوية والإملائية | +| 🔤 `tashkeel` | التشكيل — إضافة الحركات إلى النص العربي | +| 🪶 `arabic-poetry` | الشعر العربي — بحث وشرح وكتابة الشعر العربي | +| 👶 `arabic-names` | أسماء عربية — معاني الأسماء واقتراحات أسماء المواليد | + +### 🔊 الوَسائِطُ (4) +| المهارة | الوصف | +|-------|-------------| +| 🔊 `voxtral-tts` | نص إلى صوت — تحويل النص العربي إلى صوت عبر Voxtral/SILMA | +| 🎙️ `whisper-arabic` | صوت إلى نص — تفريغ الصوت العربي عبر Whisper | +| 👁️ `arabic-ocr` | التعرف على النص — استخراج النص العربي من الصور (OCR) | +| 🎤 `voice-assistant` | مساعد صوتي — سلسلة صوتية كاملة: STT → LLM → TTS | + +### 🔧 أَدَواتُ مُعالَجَةِ اللُّغَةِ العَرَبِيَّةِ (10) +| المهارة | الوصف | +|-------|-------------| +| 📊 `arabench` | معيار الجودة — قياس جودة النماذج العربية عبر 8 فئات | +| ✂️ `khalas` | تحسين التوكنات — تحسين البرومبتات العربية لتقليل التكلفة | +| 🛡️ `sarih` | فلترة المحتوى — مراجعة محتوى عربي محليًا بدون إنترنت (5 لهجات) | +| 🔒 `bidi-guard` | حماية Bidi — كشف هجمات Trojan Source ثنائية الاتجاه في الكود | +| 📝 `qalam` | توثيق عربي — توليد توثيق عربي من كود Python/JS/TS | +| 🧮 `artok` | ضريبة التوكنات — مقارنة تكلفة التوكنات العربية عبر 18 مقسّم توكنات | +| 🔍 `majal` | فاحص البيانات — فحص بيانات التدريب العربية (16 اختبار جودة) | +| 🕸️ `safha` | كاشط الويب — جمع محتوى ويب عربي لبيانات تدريب تعلم الآلة | +| ↩️ `raqeeb` | فاحص RTL — اكتشاف مشاكل RTL في HTML/CSS (24 اختبارًا، تقييم 0-100) | +| 🧠 `arabic-rag` | بحث دلالي — بحث دلالي باستخدام AraGemma embeddings + FAISS | + +### 🔎 البَحْثُ وَالمُطَوِّرُونَ (2) +| المهارة | الوصف | +|-------|-------------| +| 🌐 `arabic-web-search` | بحث ويب — بحث عربي محسّن بمصادر موثوقة | +| 🔎 `arabic-code-review` | مراجعة كود — مراجعة واعية بـ RTL/Unicode واللغة العربية | + +### 📚 التَّعْلِيمُ (2) +| المهارة | الوصف | +|-------|-------------| +| 📐 `arabic-math` | رياضيات — حل المسائل الرياضية بالأرقام والمصطلحات العربية | +| 🔬 `arabic-science` | مصطلحات علمية — مترجم مصطلحات علمية (حاسب، فيزياء، كيمياء، أحياء) | + +### 🇸🇦 المَنْظُومَةُ السُّعُودِيَّةُ (17) +| المهارة | الوصف | +|-------|-------------| +| 📍 `saudi-address` | العنوان الوطني — البحث والتحقق والترميز الجغرافي عبر SPL API | +| 📱 `saudi-apps` | التطبيقات السعودية — دليل لأكثر من 50 تطبيقًا سعوديًا (حكومي، طعام، تسوق، نقل) | +| 🏢 `saudi-business` | السجل التجاري — بيانات السجل والنشاط التجاري عبر Wathq API | +| 🛒 `saudi-ecommerce` | التجارة الإلكترونية — تكاملات Salla وZid وNoon | +| 🧾 `saudi-einvoice` | الفوترة الإلكترونية — فواتير ZATCA (امتثال، تقارير، اعتماد) | +| 🍽️ `saudi-food` | المطاعم والتوصيل — تكاملات Foodics وHungerStation وJahez وCareem | +| 👔 `saudi-hr` | الموارد البشرية — بيانات التوظيف عبر Masdr/GOSI وMudad وQiwa وMusaned | +| 🪪 `saudi-identity` | الهوية الرقمية — هوية نفاذ والتحقق عبر يقين (Elm) | +| ⚖️ `saudi-legal` | الخدمات القانونية — تكاملات ناجز (63+ واجهة) ووثائق واثق | +| 🛃 `saudi-customs` | الجمارك والتجارة — منصة فسح وبيانات الجمارك من ZATCA | +| 🏦 `saudi-openbanking` | الخدمات المصرفية — الخدمات المصرفية المفتوحة من SAMA وLean وواجهات البنوك | +| 📊 `saudi-opendata` | البيانات المفتوحة — data.gov.sa (أكثر من 11,439 مجموعة بيانات من 289+ جهة) | +| 💳 `saudi-pay` | بوابات الدفع — Moyasar وTap وHyperPay وPayTabs وTabby وTamara وSTC Pay | +| 📋 `saudi-procurement` | المشتريات الحكومية — منصة اعتماد للمنافسات والعقود الحكومية | +| 🚚 `saudi-shipping` | الشحن والتوصيل — تكاملات SMSA وAramex وNaqel وJ&T وBARQ | +| 📈 `saudi-stocks` | أسهم تداول — أسعار الأسهم السعودية ومؤشر TASI وبيانات CMA | +| 📱 `saudi-telecom` | الاتصالات — واجهات STC وMobily وZain (SMS وOTP والمدفوعات) | +| 🕌 `saudi-tourism` | السياحة — واجهات Visit Saudi للوجهات والفعاليات والتأشيرات | +| 🗣️ `saudi-tts` | نص لصوت سعودي — NAMAA-Saudi-TTS وLahajati (192+ لهجة) | +| 🌡️ `saudi-weather` | الطقس — بيانات الطقس للمدن السعودية عبر Open-Meteo | + +### 💬 التَّواصُلُ (1) +| المهارة | الوصف | +|-------|-------------| +| 💬 `unifonic` | يونيفونك — منصة اتصالات سعودية (SMS، واتساب، صوت، OTP) | + +### 🔌 أَدَواتٌ بَرْمَجِيَّةٌ (3، عَبْرَ الإِضافَةِ) +| الأداة | الوصف | +|------|-------------| +| `arabic-greeting` | رد تلقائي مناسب على التحيات الإسلامية | +| `arabizi-convert` | تحويل الفرنكو-عربي (7abibi, 3adi) إلى العربية | +| `hijri-today` | جلب التاريخ الهجري الحالي بسرعة | + +### 📱 القَنَواتُ (2) +| القناة | الوصف | +|---------|-------------| +| WhatsApp | بوت خدمة مخصص: صلاة، هجري، قرآن، حديث، ترجمة | +| Telegram | وصول كامل إلى جميع المهارات الـ 60 عبر البوت (polling + webhook) | + +## دَعْمُ النَّماذِجِ + +مِخْلَب يَعْمَلُ مَعَ **أَيِّ نَمُوذَجٍ** يَدْعَمُهُ OpenClaw: + +| المزوّد | النماذج | +|----------|--------| +| Anthropic | Claude Opus, Sonnet, Haiku | +| OpenAI | GPT-5.x, o-series | +| Google | Gemini 3.x | +| Qwen | Qwen 3.5 series | +| DeepSeek | DeepSeek R1 | +| GLM | GLM-4.7+ | +| Kimi | Kimi Coding | +| **نماذج عربية أولاً** | Jais-2, ALLaM, SILMA, Falcon-H1, Karnak, Fanar | +| محلي | Ollama, vLLM, LM Studio | +| بوابة | OpenRouter, Groq, Cerebras | + +## البُنْيَةُ المِعْمارِيَّةُ + +``` +مِخْلَب إِضافَةٌ (Plugin) وَلَيْسَ نُسْخَةً مُتَفَرِّعَةً (Fork). +يَعْمَلُ فَوْقَ OpenClaw، مِثْلَ openclaw-china لِمِنَصّاتِ الصِّينِ. + +┌─────────────────────────────────┐ +│ OpenClaw Core │ +│ (any model, any provider) │ +├─────────────────────────────────┤ +│ مخلب Plugin Layer │ +│ ┌─────────┐ ┌───────────────┐ │ +│ │ SOUL.md │ │ IDENTITY.md │ │ +│ │ persona │ │ 🦅 مخلب │ │ +│ └─────────┘ └───────────────┘ │ +│ ┌─────────────────────────────┐│ +│ │ 60 Arabic Skills ││ +│ │ Islamic: prayer · hijri ││ +│ │ quran · hadith · adhan ││ +│ │ finance ││ +│ │ Language: translate · dialect││ +│ │ grammar · tashkeel ││ +│ │ poetry · names ││ +│ │ Media: tts · stt · ocr ││ +│ │ voice-assistant ││ +│ │ NLP: arabench · khalas ││ +│ │ sarih · bidi-guard · qalam││ +│ │ artok · majal · safha ││ +│ │ raqeeb · arabic-rag ││ +│ │ Dev: code-review · web-search│ +│ │ Edu: math · science ││ +│ │ Saudi: address · apps · ││ +│ │ business · ecommerce · ││ +│ │ einvoice · food · hr · ││ +│ │ identity · legal · customs││ +│ │ openbanking · opendata · ││ +│ │ pay · procurement · ││ +│ │ shipping · stocks · ││ +│ │ telecom · tourism · tts · ││ +│ │ weather ││ +│ │ Comms: unifonic ││ +│ └─────────────────────────────┘│ +│ ┌─────────────────────────────┐│ +│ │ 2 Channels ││ +│ │ WhatsApp (scoped service) ││ +│ │ Telegram (full access) ││ +│ └─────────────────────────────┘│ +└─────────────────────────────────┘ +``` + +## لِماذا مِخْلَب؟ + +- **أَكْثَرُ مِنْ 420 مِلْيُونِ مُتَحَدِّثٍ بِالعَرَبِيَّةِ**، وَلا يُوجَدُ مُساعِدٌ عَرَبِيٌّ مَفْتوحُ المَصْدَرِ بِهذِهِ القُوَّةِ +- دِقَّةُ GPT-4 تَهْبِطُ مِنْ **85% إِلى 45%** عِنْدَ التَّعامُلِ مَعَ اللَّهَجاتِ العَرَبِيَّةِ +- العَرَبِيَّةُ تَسْتَهْلِكُ **مِنْ 2 إِلى 3 أَضْعافِ التُّوكِناتِ** مُقارَنَةً بِالإِنْجِلِيزِيَّةِ فِي أَغْلَبِ النَّماذِجِ +- لا يُوجَدُ فَرْعٌ إِقْلِيمِيٌّ مِنْ OpenClaw لِلْعَرَبِيَّةِ، وَمِخْلَب هُوَ الأَوَّلُ + +## خارِطَةُ الطَّرِيقِ + +- [x] المرحلة 0: بيئة العمل + الشخصية + 5 مهارات API +- [x] المرحلة 1: 14 مهارة، هيكل الإضافة، مستودع GitHub +- [x] المرحلة 2: قناة WhatsApp (واجهة ChannelPlugin الصحيحة) +- [x] المرحلة 3: TTS/STT/OCR + القواعد + التشكيل + الأحاديث +- [x] المرحلة 4: Arabic RAG + قناة Telegram + 9 مهارات إضافية +- [x] المرحلة 5: 40 مهارة: المالية، الشعر، الأسماء، التعليم، الصوت، مراجعة الكود، الطبخ، السفر، الصحة، التطبيقات السعودية، سناب شات، الأطفال +- [x] المرحلة 5.5: المنظومة السعودية: 17 تكامل API سعودي +- [ ] المرحلة 6: النشر في متجر ClawHub +- [ ] المرحلة 7: اختبارات شاملة + CI/CD +- [ ] المرحلة 8: مساهمات المجتمع + توسيع دعم اللهجات + +## المُساهَمَةُ + +المُساهَماتُ مُرَحَّبٌ بِها. المَجالاتُ الَّتِي نَحْتاجُ فِيها دَعْمًا: +- مهارات عربية جديدة +- توسيع تغطية اللهجات (خصوصًا السودانية واليمنية والصومالية العربية) +- تحسينات RTL +- معايير قياس للنماذج العربية +- تكامل قناة WhatsApp + +## الأَمانُ + +مِخْلَب يَتَعامَلُ مَعَ الأَمانِ بِجِدِّيَّةٍ عالِيَةٍ: +- **مَنْعُ هَجَماتِ Bidi** — إِزالَةُ مَحارِفِ Unicode الخَطِيرَةِ (CVE-2021-42574) +- **تَنْقِيَةُ المُدْخَلاتِ** — التَّحَقُّقُ مِنَ النُّصُوصِ العَرَبِيَّةِ قَبْلَ المُعالَجَةِ +- **عَدَمُ تَخْزِينِ بَياناتِ الاعْتِمادِ** — جَمِيعُ مَفاتِيحِ API عَبْرَ مُتَغَيِّراتِ البِيئَةِ +- **مُتَوافِقٌ مَعَ NemoClaw** — حاوِيَةُ الأَمانِ الخاصَّةُ بِـ NVIDIA لِوُكَلاءِ الذَّكاءِ الاصْطِناعِيِّ +- **فِلْتَرَةٌ مَحَلِّيَّةٌ** — فِلْتَرُ `sarih` يَعْمَلُ مَحَلِّيًّا، وَلا تُغادِرُ أَيُّ بَياناتٍ جِهازَكَ + +راجِعْ [SECURITY.md](SECURITY.md) لِلتَّفاصِيلِ الكامِلَةِ وَآلِيَّةِ الإِبْلاغِ عَنِ الثَّغَراتِ. + +## قَوالِبُ الوُكَلاءِ + +وُكَلاءُ عَرَبٌ مُجَهَّزونَ مُسْبَقًا لِحالَاتِ اسْتِخْدامٍ مُتَخَصِّصَةٍ: + +| الوكيل | المهارات | حالة الاستخدام | +|-------|--------|----------| +| 📖 عالم (Scholar) | القرآن، الحديث، الهجري، الصلاة، المالية | البحث الإسلامي | +| 🔄 مترجم (Translator) | الترجمة، اللهجات، القواعد، التشكيل | الترجمة الاحترافية | +| 💻 مطوّر (Developer) | مراجعة الكود، bidi-guard، RTL، التوثيق | تطوير يضع العربية أولًا | + +## الرُّخْصَةُ + +MIT — مَفْتوحُ المَصْدَرِ لِلْجَمِيعِ. + +--- + +
+ +**مِخْلَب** — مِنَ المُجْتَمَعِ السُّعُودِيِّ مَفْتوحِ المَصْدَرِ، إِلى العالَمِ العَرَبِيِّ. + +مِنَ المُجْتَمَعِ السُّعُودِيِّ مَفْتوحِ المَصْدَرِ — لِلْعالَمِ العَرَبِيِّ كُلِّهِ 🇸🇦 + +صُنِعَ بِحُبٍّ 🇸🇦🇪🇬🇦🇪🇯🇴🇱🇧🇮🇶🇲🇦🇩🇿🇹🇳🇱🇾🇸🇾🇵🇸🇰🇼🇶🇦🇧🇭🇴🇲🇸🇩🇾🇪 + +
diff --git a/agents/travel-advisor/agent.md b/agents/travel-advisor/agent.md new file mode 100644 index 0000000..5f14925 --- /dev/null +++ b/agents/travel-advisor/agent.md @@ -0,0 +1,103 @@ +--- +name: travel-advisor +description: "مستشار سفر وسياحة — يساعد في التأشيرات، متطلبات الدخول، والتخطيط للسفر مع الاعتماد على المصادر الرسمية." +emoji: ✈️ +model: default +skills: + - travel-advisor-visa + - arabic-web-search + - saudi-tourism + - arab-travel +--- + +# مستشار السفر — Travel Advisor + +أنت مستشار سفر وسياحة موجه للمستخدم العربي. + +تساعد في: +- معرفة متطلبات التأشيرات (Visa) +- هل الدخول بدون فيزا أو يحتاج تأشيرة +- نوع التأشيرة (eVisa / عند الوصول / مسبقة) +- متطلبات الدخول الرسمية +- السفر إلى السعودية ومتطلباته +- اقتراحات سياحية ونصائح سفر + +## أسلوبك +- واضح ومباشر +- يعتمد على المصادر الرسمية +- يشرح بالعربية بشكل بسيط +- يفهم اللهجات (الخليجية، المصرية، وغيرها) + +## طريقة العمل + +1. استخرج من السؤال: + - الجنسية + - الوجهة + - الغرض من السفر (إن وجد) + +2. إذا لم تُذكر الجنسية: + - وضّح أن النتيجة تختلف حسب الجواز + - اطلب التحديد عند الحاجة + +3. تحقق من: + - حالة التأشيرة (بدون / eVisa / عند الوصول / مطلوبة) + - المتطلبات الأساسية + - المصدر الرسمي + +4. اعرض النتيجة بشكل منظم + +## تنسيق الرد + +✈️ معلومات السفر +━━━━━━━━━━━━━━━━━━ +🪪 الجنسية: {{nationality}} +📍 الوجهة: {{destination}} + +✅ حالة الدخول: {{visa_status}} +🎫 نوع التأشيرة: {{visa_type}} + +📄 المتطلبات: +- ... +- ... +- ... + +🔗 المصدر الرسمي: +... + +⚠️ ملاحظة: +المعلومات قد تتغير، يُفضّل التأكد من الموقع الرسمي. + +## قواعد مهمة + +- لا تعتمد على مصدر واحد فقط +- Passport Index يستخدم كمؤشر أولي فقط +- اعتمد دائمًا على: + - مواقع السفارات + - الجهات الحكومية الرسمية +- لا تعطِ معلومات غير مؤكدة + +## عند السفر إلى السعودية 🇸🇦 + +- أعط أولوية للمصادر الرسمية السعودية +- اذكر: + - نوع التأشيرة + - رابط التقديم الرسمي + - المتطلبات الأساسية + +## أمثلة + +### مثال: +أنا إماراتي، هل أقدر أدخل فرنسا؟ + +→ تحقق من الفيزا +→ اعرض الحالة + الشروط + المصدر + +### مثال: +أنا مصري وأبغى أزور السعودية + +→ استخدم المصادر السعودية +→ اذكر المتطلبات + رابط التقديم + +## الهدف + +تقديم إجابات دقيقة، عملية، وموثوقة للمستخدم العربي في كل ما يخص السفر والتأشيرات. diff --git a/skills/arab-travel/SKILL.md b/skills/arab-travel/SKILL.md index ccd5f5d..8897055 100644 --- a/skills/arab-travel/SKILL.md +++ b/skills/arab-travel/SKILL.md @@ -49,8 +49,40 @@ metadata: {"openclaw": {"emoji": "✈️"}} - "الحمد لله على السلامة" (وصول) - "في أمان الله" (وداع) +## 🕌 الأدعية أثناء السفر + +### دعاء الركوب +- "الله أكبر، الله أكبر، الله أكبر +سبحان الذي سخر لنا هذا وما كنا له مقرنين +وإنا إلى ربنا لمنقلبون +اللهم إنا نسألك في سفرنا هذا البر والتقوى ومن العمل ما ترضى +اللهم هوّن علينا سفرنا هذا واطوِ عنا بُعده +اللهم أنت الصاحب في السفر، والخليفة في الأهل +اللهم إني أعوذ بك من وعثاء السفر، وكآبة المنظر، وسوء المنقلب في المال والأهل" + +--- + +### دعاء السفر +- "اللهم إنا نسألك في سفرنا هذا البر والتقوى ومن العمل ما ترضى +اللهم هوّن علينا سفرنا هذا واطوِ عنا بُعده +اللهم أنت الصاحب في السفر، والخليفة في الأهل" + +--- + +### دعاء الوصول +- "الحمد لله الذي بنعمته تتم الصالحات +اللهم إني أسألك خير هذه البلدة وخير أهلها +وأعوذ بك من شرها وشر أهلها" + +--- + +### دعاء الوداع +- "أستودعك الله الذي لا تضيع ودائعه" + + ## متى تستخدم - المستخدم يخطط سفرة لدولة عربية - يسأل عن تأشيرات أو متطلبات - يريد اقتراحات أماكن سياحية - يسأل عن تكاليف أو ميزانية +- اعط المستخدم الأدعية أثناء السفر لو طلبها في حال ركوب السيارة للسفر او الطائرة او القطار diff --git a/skills/hijri-calendar/SKILL.md b/skills/hijri-calendar/SKILL.md index fb3178d..87c2438 100644 --- a/skills/hijri-calendar/SKILL.md +++ b/skills/hijri-calendar/SKILL.md @@ -31,8 +31,13 @@ curl -s "https://api.aladhan.com/v1/gToH" | jq '.data.hijri' - 27 رجب: الإسراء والمعراج - 15 شعبان: ليلة النصف من شعبان - 1 رمضان: بداية رمضان +- 19 رمضان: عند غروب شمس هذا اليوم فهذا هو بداية دخوب العشر الاواخر - 27 رمضان: ليلة القدر (تقريباً) - 1 شوال: عيد الفطر - 10 ذو الحجة: عيد الأضحى +## ملاحظات +عند السؤال عن مناسبة، احسب كم باقي عليها بالأيام مع التقويم الميلادي والهجري واليوم بالعربي. -عند السؤال عن مناسبة، احسب كم باقي عليها بالأيام. +29 رمضان: نبه المستخدم انه ينتبه لهلال عيد الفطر حسب بلده لو اعلنت +29 شعبان: نبه المستخدم انه ينتبه لهلال شهر رمضان عند اعلانها الرسمي من قبل بلده لو اعلنت او متى رمضان بالميلادي +29 ذو القعدة: نبه المستخدم انه ينتبه لهلال شهر ذو الحجة عند اعلانها ومتى يوم عرفة بالميلادي والخ. diff --git a/skills/travel-advisor-visa/SKILL.md b/skills/travel-advisor-visa/SKILL.md new file mode 100644 index 0000000..2be7d66 --- /dev/null +++ b/skills/travel-advisor-visa/SKILL.md @@ -0,0 +1,239 @@ +--- +name: travel-advisor-visa +description: "مستشار السفر والتأشيرات — افحص متطلبات الدخول والتأشيرة حسب جنسية المستخدم ووجهته، مع أولوية للمصادر الرسمية مثل مواقع السفارات، وزارات الخارجية، والبوابات الحكومية." +metadata: + openclaw: + emoji: "✈️" + requires: + bins: ["curl"] +--- + +# مستشار السفر والتأشيرات + +مهارة عربية لفحص **متطلبات السفر والدخول والتأشيرة** حسب **الجنسية** و**الدولة الوجهة**، مع إعطاء أولوية للمصادر الرسمية: +- مواقع السفارات والقنصليات +- وزارات الخارجية والهجرة +- البوابات الحكومية الرسمية +- بوابات التأشيرات الرسمية +- Passport Index كمؤشر أولي سريع، ثم **يجب** التحقق من المصدر الرسمي + +## الهدف + +استخدم هذه المهارة عندما يسأل المستخدم عن: +- هل أحتاج فيزا؟ +- هل الدخول بدون فيزا؟ +- هل توجد تأشيرة إلكترونية أو تأشيرة عند الوصول؟ +- ما متطلبات دخول السعودية؟ +- ما المستندات المطلوبة؟ +- أين أقدم رسميًا؟ +- ما نوع التأشيرة المناسب: سياحة، عمل، دراسة، زيارة؟ + +## القاعدة الأساسية + +**لا تعتمد على مصدر واحد فقط.** +ابدأ بمؤشر سريع مثل Passport Index، ثم أكّد النتيجة من **الموقع الرسمي** للدولة المقصودة أو سفارتها أو بوابة التأشيرات الرسمية. + +## المدخلات المتوقعة + +- **الجنسية**: مثل سعودي، إماراتي، مصري، أردني +- **الوجهة**: مثل فرنسا، اليابان، السعودية، تركيا +- **نوع الرحلة** (اختياري): + - سياحة + - عمل + - دراسة + - زيارة عائلية + - عبور (ترانزيت) + +## منطق العمل + +1. استخرج **الجنسية** و**الدولة الوجهة** من سؤال المستخدم +2. إذا لم يذكر الجنسية: + - لا تفترض دائمًا + - اسأل بلطف أو اذكر أن النتيجة تختلف حسب الجواز +3. افحص حالة الدخول مبدئيًا: + - بدون تأشيرة + - تأشيرة إلكترونية + - تأشيرة عند الوصول + - تأشيرة مطلوبة مسبقًا +4. **تحقق رسميًا** من: + - موقع السفارة أو القنصلية + - وزارة الخارجية + - بوابة الهجرة أو التأشيرات الرسمية +5. لخّص للمستخدم: + - حالة التأشيرة + - نوعها + - مدة الإقامة إن توفرت + - صلاحية الجواز المطلوبة إن ذكرت + - أبرز المستندات المطلوبة + - جهة التقديم الرسمية + - روابط رسمية +6. إن كانت الوجهة **السعودية**: + - أعطِ أولوية لبوابات السعودية الرسمية + - اذكر المسار الرسمي للتقديم أو الاستعلام +7. إذا اختلفت المصادر أو كانت غير واضحة: + - صرّح بعدم اليقين + - قدّم للمستخدم المصدر الرسمي الأعلى موثوقية + +## ترتيب المصادر + +### أولوية التحقق +1. **الموقع الحكومي الرسمي للدولة الوجهة** +2. **السفارة أو القنصلية الرسمية** +3. **بوابة التأشيرات الرسمية** +4. **Passport Index** كمؤشر أولي فقط +5. مواقع السفر التجارية كمرجع ثانوي فقط عند الحاجة، وليس كمصدر حاسم + +## عند السفر إلى السعودية 🇸🇦 + +إذا كانت الوجهة **المملكة العربية السعودية**: +- افحص ما إذا كانت الجنسية مؤهلة لتأشيرة إلكترونية أو تحتاج مسارًا آخر +- استخدم المصادر الرسمية السعودية أولًا +- اذكر: + - نوع التأشيرة المتاح + - رابط التقديم الرسمي + - المتطلبات الأساسية + - أي تنبيه رسمي متعلق بالدخول + +### مصادر سعودية مقترحة +- بوابة التأشيرة السعودية الرسمية +- Visit Saudi +- وزارة الخارجية السعودية +- منصة السفارة/القنصلية السعودية عند الحاجة + +## عند السفر إلى دول أخرى + +إذا كانت الوجهة **خارج السعودية**: +- استخدم Passport Index كفحص أولي سريع +- ثم انتقل مباشرة للتحقق من: + - سفارة الدولة + - وزارة الخارجية + - بوابة الهجرة/التأشيرات + +## شكل الإجابة + +استخدم تنسيقًا واضحًا مثل: + +```text +✈️ معلومات السفر والتأشيرة +━━━━━━━━━━━━━━━━━━━━━ +🪪 الجنسية: {{nationality}} +📍 الوجهة: {{destination}} +🧳 الغرض: {{purpose}} + +✅ حالة الدخول: {{visa_status}} +🎫 نوع التأشيرة: {{visa_type}} +📅 مدة الإقامة: {{stay_duration}} +🕒 مدة المعالجة: {{processing_time}} + +📄 المتطلبات الأساسية: +- {{requirement_1}} +- {{requirement_2}} +- {{requirement_3}} + +🔗 التقديم أو التحقق الرسمي: +{{official_link}} + +⚠️ ملاحظة: +{{important_note}} +``` + +## أمثلة استخدام + +### مثال 1 +**سؤال المستخدم:** +> هل أقدر أدخل فرنسا بدون فيزا إذا كنت إماراتي؟ + +**ما يجب فعله:** +- استخرج: الجنسية = إماراتي +- الوجهة = فرنسا +- افحص مبدئيًا عبر Passport Index +- أكّد من المصدر الرسمي الفرنسي أو جهة أوروبية رسمية +- قدّم النتيجة بالعربية بشكل مختصر وواضح + +### مثال 2 +**سؤال المستخدم:** +> أنا مصري وأبغى أزور السعودية، وش المطلوب؟ + +**ما يجب فعله:** +- الوجهة = السعودية +- أعط أولوية للمصادر السعودية الرسمية +- اذكر نوع التأشيرة والمسار الرسمي للتقديم والمتطلبات الأساسية + +### مثال 3 +**سؤال المستخدم:** +> أنا سعودي وبسافر اليابان للسياحة، هل أحتاج فيزا؟ + +**ما يجب فعله:** +- استخرج الجنسية والوجهة والغرض +- تحقّق من حالة التأشيرة +- لخّص الشروط الرسمية + +## قواعد مهمة + +- **لا تجزم** إن لم تجد مصدرًا رسميًا واضحًا +- **لا تعتمد على معلومات قديمة** +- **اذكر تاريخ التحقق** إذا كانت المعلومات حساسة أو متغيرة +- **نبّه** أن شروط الدخول قد تتغير حسب: + - نوع الجواز + - بلد الإقامة + - الغرض من الزيارة + - وجود إقامات أو تأشيرات سارية في دول أخرى +- إذا كان المستخدم يسأل عن **سفر فوري** أو **اليوم/هذا الأسبوع**: + - شدد على ضرورة مراجعة المصدر الرسمي مباشرة + +## التعامل مع الغموض + +إذا قال المستخدم: +> هل أحتاج فيزا لفرنسا؟ + +فهذا **غير كافٍ** لأن الجواب يعتمد على الجنسية. +في هذه الحالة: +- اطلب الجنسية أو نوع الجواز +- أو اشرح أن الحكم يختلف حسب الجواز + +## ما لا ينبغي فعله + +- لا تعطِ نصيحة قانونية قطعية +- لا تعتمد على منتديات أو مدونات مجهولة +- لا تذكر أن Passport Index وحده كافٍ +- لا تخترع متطلبات غير مذكورة رسميًا +- لا تخلط بين: + - الدخول بدون تأشيرة + - التأشيرة الإلكترونية + - التأشيرة عند الوصول + - الإعفاء الجزئي أو المؤقت + +## كلمات مفتاحية لتفعيل المهارة + +استخدم هذه المهارة عند وجود عبارات مثل: +- فيزا +- تأشيرة +- دخول بدون فيزا +- eVisa +- visa on arrival +- متطلبات السفر +- متطلبات الدخول +- سفارة +- قنصلية +- زيارة السعودية +- السفر إلى السعودية +- هل أقدر أسافر +- هل أحتاج تأشيرة + +## مراجع مقترحة + +- Passport Index: https://www.passportindex.org/ +- السعودية (التأشيرة الرسمية): https://visa.visitsaudi.com/ +- Visit Saudi: https://www.visitsaudi.com/ +- وزارة الخارجية السعودية: https://www.mofa.gov.sa/ + +## ملاحظات للمطور + +هذه المهارة مناسبة للتوسعة لاحقًا بإضافة: +- تكلفة تقريبية للتأشيرة +- مدة المعالجة +- مراكز التأشيرات مثل VFS أو TLS عند الحاجة +- متطلبات اللقاحات أو التأمين إن كانت ضمن المصدر الرسمي +- مهارة مكملة لاحقًا باسم: + - `travel-agencies` + - أو `trip-planner`