● مجتمع
Agents365-ai
⚡ فوري
excalidraw-skill
بواسطة Agents365-ai · Agents365-ai/excalidraw-skill
مهارة Claude Code لتحويل أوصاف الأنظمة باللغة الطبيعية إلى رسوم بيانية Excalidraw مرسومة بخط اليد — تصدير SVG/PNG/.excalidraw قابل للتحرير
مهارة Excalidraw من Agents365-ai تكتشف تلقائياً عندما تحتاج النقاشات إلى رسم بياني (3+ مكونات، أنظمة متعددة الطبقات، سير عمل) وتنشئ الصحيح: مخطط تدفق، معمارية، تسلسل، خريطة ذهنية، أو حارة سباحة. التصدير عبر Kroki API (بدون تثبيت) أو excalidraw-brute-export-cli محلي مع Firefox. يمكن فتح ملفات .excalidraw القابلة للتحرير مباشرة على excalidraw.com
لماذا تستخدمه
الميزات الأساسية
- خمسة أوضاع رسوم بيانية برقم قواعد تخطيط متخصصة (مخطط تدفق، معمارية، تسلسل، خريطة ذهنية، حارة سباحة)
- تُستدعى تلقائياً عندما يكتشف Claude نقاشات تستحق معمارية
- ثلاث طرق تصدير: Kroki (curl، بدون تثبيت)، CLI محلي (PNG/SVG)، .excalidraw قابل للتحرير
- يقبل إدخال باللغة الطبيعية الصينية أو الإنجليزية
- الجمالية المرسومة بخط اليد تتجنب مشكلة الرسوم البيانية ذات المظهر العقيم من الذكاء الاصطناعي
عرض مباشر
كيف يبدو في الممارسة
excalidraw-skill.replay
▶ جاهز
حالات الاستخدام
استخدامات عملية: excalidraw-skill
متى تستخدمه: عندما تكتب RFC وتريد رسم بياني بدون فتح أداة منفصلة
الخطوات
-
وصف النظام
استخدم مهارة excalidraw — ارسم معمارية e-commerce microservices مع عملاء وبوابة API و4 خدمات وRabbitMQ وقواعد بيانات لكل خدمة✓ تم النسخ
→ ينشئ Claude تخطيط ويصدره SVG عبر Kroki
-
تعديل وإعادة تصدير
أضف Redis أمام خدمة المنتج وأعد الإنشاء✓ تم النسخ
→ رسم بياني محدث مع Redis مُدرج، التخطيط معاد التوازن
-
حفظ النسخة القابلة للتحرير
احفظ كـ .excalidraw حتى أتمكن من تحريره على excalidraw.com✓ تم النسخ
→ الملف محفوظ في CWD
النتيجة: رسم معمارية بأسلوب مرسوم بخط اليد في وثيقتك في أقل من 5 دقائق
المزالق
- الرسم البياني مكتظ ل10+ مكونات — اطلب من Claude تجميعها حسب الطبقة أولاً؛ المهارة لديها قواعد تخطيط لذلك
متى تستخدمه: عندما تفهم أخيراً رقصة OAuth ذات 5 خدمات وتريد توثيقها
الخطوات
-
الصق السجل أو صف التدفق
مهارة Excalidraw — رسم تسلسلي: مستخدم → frontend → خدمة المصادقة → موفر الهوية → رد الاتصال → الجلسة✓ تم النسخ
→ رسم تسلسلي بأسهم صحيحة ورسائل الإرجاع
-
تحسين
أضف مسار الخطأ عندما يعود IdP 401✓ تم النسخ
→ تم عرض التدفق البديل بشكل واضح
النتيجة: رسم تسلسلي يمكنك إسقاطه في وصف PR
التركيبات
اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10
احفظ الرسوم البيانية المنتجة مباشرة في مجلد الوثائق الخاصة بك
أنشئ رسم المعمارية واحفظه في docs/architecture/v2.svg✓ تم النسخ
الإرفاق بالرسم البياني في PR بالالتزام به جنباً إلى جنب مع المواصفات
قم بإنشاء الرسم البياني والالتزام به في docs/، والإشارة إليه في نص PR✓ تم النسخ
التكلفة والحدود
تكلفة التشغيل
- حصة API
- Kroki ليس لديه حصة صريحة لكن لا تحطمه
- الرموز لكل استدعاء
- مواصفات الرسم البياني مضغوطة (<2k tokens عادة)
- التكلفة المالية
- مجاني — المهارات هي ملفات محلية. Kroki مجاني
- نصيحة
- استخدم Kroki للحالات الفردية، ثبت excalidraw-brute-export-cli فقط إذا احتجت إلى وضع بلا اتصال
الأمان
الصلاحيات والأسرار ونطاق الأثر
تخزين بيانات الاعتماد: لا توجد بيانات اعتماد — توجيهات نقية
نقل البيانات الخارجي: مسار Kroki يرسل مواصفات الرسم البياني الخاص بك إلى kroki.io. مسار CLI المحلي لا يرسل أي شيء
- إذا كانت الرسوم البيانية تتسرب الداخليات من النظام، استخدم مسار CLI المحلي بدلاً من Kroki
استكشاف الأخطاء
الأخطاء الشائعة وحلولها
كلمات المفاتيح الخاطئة — Claude يكتب Mermaid بدلاً من ذلك
قل 'excalidraw' صراحة؛ 'draw a diagram' وحده يمكن أن يختار أدوات أخرى
البدائل
excalidraw-skill مقابل البدائل
| البديل | متى تستخدمها | المقايضة |
|---|
| Mermaid via markdown | وثائقك بالفعل تعرض Mermaid بشكل محلي (GitHub، إلخ.) | لا جمالية مرسومة بخط اليد، تحكم تخطيط أقل |
| drawio via desktop app | تريد تخطيط يدوي ثقيل النقرات | ليس موجه من قبل الوكيل |