● مجتمع
JuliaGenAI
⚡ فوري
julia-agent-skills
بواسطة JuliaGenAI · JuliaGenAI/julia-agent-skills
مجموعة مهارات JuliaGenAI للعملاء الذين يكتبون جوليا — تبدأ بـ DocumenterVitepress.jl، وتهدف إلى التوسع عبر نظام جوليا البيئي.
julia-agent-skills مجموعة مبكرة من المهارات المخصصة لجوليا لـ Claude Code و Cursor و Gemini CLI والأدوات الأخرى المتوافقة مع مهارات الوكيل. في وقت كتابة هذا، المهارة الموثقة هي documenter-vitepress، التي تعلم الوكلاء إعداد والتكرار على مواقع التوثيق الخاصة بجوليا المبنية باستخدام DocumenterVitepress.jl. يتم صيانة المستودع بواسطة JuliaGenAI — المجتمع خلف أدوات GenAI في جوليا.
لماذا تستخدمه
الميزات الأساسية
- مهارة documenter-vitepress لإعداد DocumenterVitepress.jl والتكرار عليها
- متوافقة مع أي أداة تقرأ معيار Agent Skills المفتوح
- يتم صيانتها بواسطة JuliaGenAI — مجتمع Julia GenAI
- محدودة باتفاقيات جوليا (Project.toml وتخطيط docs/ وتكوين DocumenterVitepress)
- قالب للمهارات المستقبلية المخصصة للحزم في جوليا التي سيتم إضافتها
عرض مباشر
كيف يبدو في الممارسة
julia-agent-skill.replay
▶ جاهز
حالات الاستخدام
استخدامات عملية: julia-agent-skills
متى تستخدمه: لديك حزمة جوليا وتريد توثيقًا حديثًا قائمًا على Vitepress بدلاً من HTML الافتراضي في Documenter.
الخطوات
-
اطلب من المهارة بناء الأساس للتوثيق
استخدم مهارة documenter-vitepress — قم بإعداد توثيق DocumenterVitepress.jl لـ MyPackage.jl.✓ تم النسخ
→ يقوم Claude بإنشاء docs/ مع Project.toml و make.jl و index.md مكونة لـ Vitepress
-
قم بتشغيل المعاينة المحلية
أعطني الأوامر الدقيقة لمعاينة محليًا.✓ تم النسخ
→ julia --project=docs docs/make.jl + تعليمات خادم npm dev
-
قم بتوصيل CI
أضف GitHub Actions للنشر على gh-pages في main.✓ تم النسخ
→ معيار Julia doc-deploy workflow YAML
النتيجة: موقع توثيق يعمل يمكنك توسيعه.
المزالق
- عدم توافق الإصدار بين DocumenterVitepress.jl وnode/vitepress — قم بتثبيت الإصدارات كما تقترح المهارة؛ الإصدارات من DocumenterVitepress تتحرك بسرعة
متى تستخدمه: التوثيق يعمل لكن الملاحة / المظهر لا يستقطب.
الخطوات
-
صف التغيير
documenter-vitepress — أعد تنظيم الشريط الجانبي إلى أقسام البدء / البرامج التعليمية / API / التصميم.✓ تم النسخ
→ فرق تكوين Vitepress يطابق اتفاقيات توثيق جوليا
-
معاينة وضبط
تبدو المعاينة غريبة في الوضع الداكن — أصلح تباين كتلة الكود.✓ تم النسخ
→ CSS محدد / تجاوز المظهر، ليس تخمين
النتيجة: توثيق يطابق فعلاً قصة حزمتك.
التركيبات
اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10
فتح PR يضيف توثيق Vitepress إلى حزمة جوليا
أنشئ الأساس للتوثيق وافتح PR إلى MyPackage.jl مع التوثيق الجديد/ وسير عمل CI.✓ تم النسخ
تعديل محتوى التوثيق جنبًا إلى جنب مع الإعداد في جلسة واحدة
قم بإعداد DocumenterVitepress، ثم اكتب index.md وصفحات البدء.✓ تم النسخ
التكلفة والحدود
تكلفة التشغيل
- حصة API
- لا شيء
- الرموز لكل استدعاء
- صغير — الإعدادات + القالب
- التكلفة المالية
- مجاني — المهارات عبارة عن ملفات محلية
- نصيحة
- عمل التوثيق يتطلب سياقًا متواضعًا؛ لا يوجد ميزانية خاصة مطلوبة.
الأمان
الصلاحيات والأسرار ونطاق الأثر
تخزين بيانات الاعتماد: لا بيانات اعتماد — مطالبات نقية فقط
نقل البيانات الخارجي: None
- المهارة محدودة بنطاق ضيق (توثيق Vitepress)؛ لا تتوقع مساعدة جوليا عامة منها.
استكشاف الأخطاء
الأخطاء الشائعة وحلولها
كلمات رئيسية محفز خاطئة — إخراج Documenter.jl البسيط
'Vitepress' هي الكلمة الرئيسية؛ بدونها، سيستخدم Claude الافتراضي HTML Documenter.
البدائل
julia-agent-skills مقابل البدائل
| البديل | متى تستخدمها | المقايضة |
| Documenter.jl البسيط | تريد مظهر توثيق جوليا الكلاسيكي بدون خطوة بناء JS | واجهة مستخدم أقل حداثة، إعداد أبسط |
| VitePress المصنوعة يدويًا | مشروع غير جوليا | لا توجد تكامل حزمة جوليا (doctests و @docs blocks) |