Quran Lab

الإعداد بمساعد برمجي

ما يقدّمه زر «انسخ التعليمات» لمساعدك البرمجي، وطريقة تثبيت المهارة التي يتّبعها.

أسرع طريقة للإعداد هي نصّ تعليمات واحد. يعطيك زر «انسخ التعليمات» في صفحتك الرئيسية نصًّا تلصقه في مساعدك البرمجي (Claude Code أو Codex أو Cursor أو GitHub Copilot أو غيره) داخل مشروعك.

ما تفعله التعليمات

لمربع الحوار خطوتان. في الأولى تختار مهمة المساعد: إعداد جديد، أو الـ SDK فقط، أو ترحيل من حزمة SDK أخرى للتلاوة أو من إعداد أقدم لـ Quran Lab. وفي الثانية تنسخ التعليمات.

وفي الترحيل سؤال إضافي قبل التعليمات: ما مصير القواعد والعتبات ونصوص الملاحظات التي كتبتها بنفسك؟

  • أبقِها. لا يتغيّر إلا النموذج. تبقى شيفرتك كما هي، وتصلها مخرجات TajweedFormer.
  • انقلها. يعيد المساعد كتابة كل قاعدة لتعمل على مخرجات TajweedFormer، ويحافظ على سلوكها، ثم يذكر لك ما تعذّر نقله.
  • أزِلها. يزيلها المساعد بعد أن يعرض عليك قائمتها وتوافق.

عند نسخ التعليمات يُنشأ مفتاح للتطبيق ورمز إعداد صالح لمدة 24 ساعة. ولا يوضعان إلا في النص المنسوخ. وبهما يتولّى المساعد في الإعداد الجديد ما يلي:

  • يحدّد من بين حزم الـ SDK الأربع الحزمةَ التي يحتاجها مشروعك، ويثبّت أحدث إصدار منها؛
  • يضع المفتاح في المخزن السرّي لمنصّتك، خارج مستودعك؛
  • يسمّي المفتاح باسم تطبيقك، ويسجّل الإعداد لدى Quran Lab؛
  • يشرح مشاركة التسجيلات، ويكتب مسودة لبطاقة إدراج تطبيقك في الدليل لتراجعها؛
  • يُجري فحص الإعداد، ثم يخبرك في بضعة أسطر بما فعله.

وتعرض صفحتك الرئيسية تقدّم المساعد أثناء عمله: «نُسخت التعليمات»، «سجّل المساعد الدخول»، «جارٍ الإعداد»، «جاهز».

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

المهارة

تتضمّن التعليمات رابطًا إلى مهارة Quran Lab للمساعدات البرمجية: الإعداد كله في ملف واحد يتّبعه المساعد خطوة بخطوة. تعمل التعليمات وحدها، وتعمل على نحو أفضل حين تكون المهارة مثبّتة.

وتُبقي المهارة نفسها محدّثة. فمرة واحدة في اليوم على الأكثر، وقبل أي شيء آخر، يقارن المساعد إصدار النسخة المثبّتة بالإصدار المنشور. وإذا صدر إصدار أحدث، نزّل الملفات الجديدة، وتحقّق من كل ملف منها مقابل بصمة SHA-256 المدرجة في https://sdk.quranlab.ai/skills/quranlab-sdk/manifest.json، ولا يستبدل الملفات القديمة إلا بعد ذلك. ويحفظ وقت آخر تحقّق في quranlab-sdk.checked بجانب المهارة، ويستثنيه من git. وإذا فشل التحقّق، بقيت النسخة القديمة وأخبرك المساعد بذلك في سطر واحد؛ وإذا لم يكن متصلًا بالإنترنت، واصل العمل بالنسخة التي لديه. أما المساعد الذي لا يستطيع تشغيل الأوامر أو الوصول إلى sdk.quranlab.ai فيُبقي نسخته كما هي إلى أن تثبّت التعليمات التالية من زر «انسخ التعليمات» أحدث إصدار.

إصدار المهارة هو 3.1.8:

https://sdk.quranlab.ai/skills/quranlab-sdk/SKILL.md

ولا تحتوي المهارة على أي مفتاح أبدًا.

تثبيت المهارة

شغّل سطرًا واحدًا من مجلد مشروعك. يحفظ هذا السطر المهارة حيث يحمّل مساعدك المهارات، وينشئ المجلدات الناقصة في المسار. في Windows يُستخدم الأمر curl.exe. وهو مضمَّن في Windows 10 (منذ 2018) و Windows 11، ويعمل في PowerShell وفي Command Prompt.

Claude Code

macOS و Linux
curl -fsSL --create-dirs https://sdk.quranlab.ai/skill -o .claude/skills/quranlab-sdk/SKILL.md
Windows
curl.exe -fsSL --create-dirs https://sdk.quranlab.ai/skill -o .claude\skills\quranlab-sdk\SKILL.md

Codex

macOS و Linux
curl -fsSL --create-dirs https://sdk.quranlab.ai/skill -o .agents/skills/quranlab-sdk/SKILL.md
Windows
curl.exe -fsSL --create-dirs https://sdk.quranlab.ai/skill -o .agents\skills\quranlab-sdk\SKILL.md

Cursor

macOS و Linux
curl -fsSL --create-dirs https://sdk.quranlab.ai/skill -o .cursor/skills/quranlab-sdk/SKILL.md
Windows
curl.exe -fsSL --create-dirs https://sdk.quranlab.ai/skill -o .cursor\skills\quranlab-sdk\SKILL.md

GitHub Copilot

macOS و Linux
curl -fsSL --create-dirs https://sdk.quranlab.ai/skill -o .github/skills/quranlab-sdk/SKILL.md
Windows
curl.exe -fsSL --create-dirs https://sdk.quranlab.ai/skill -o .github\skills\quranlab-sdk\SKILL.md

أي مساعد آخر: أعطه رابط المهارة المذكور أعلاه.

المشاريع التي أُعدّت بقاعدة Cursor أو بملف تعليمات Copilot تواصل العمل، فهذان الملفان يبقيان متاحين على العنوانين https://sdk.quranlab.ai/skills/quranlab-sdk/quranlab-sdk.mdc و https://sdk.quranlab.ai/skills/quranlab-sdk/quranlab-sdk.instructions.md.

التغييرات اللاحقة

يُجري المساعد نفسه التغييرات اللاحقة عندما تطلبها منه: تحديث الـ SDK حين تشير صفحة تطبيقك إلى صدور تحديث، أو اختيار زمن استجابة آخر، أو تثبيت التطبيق على أحد إصدارات النموذج، أو تغيير التطبيقات التي يعمل لها المفتاح. ويمكنك أن تغيّر زمن الاستجابة وإصدار النموذج وتطبيقات المفتاح بنفسك في تبويب الإعداد في التطبيق، وحين يصدر تحديث للـ SDK تعرض صفحة التطبيق زر «انسخ تعليمات التحديث».