Install
git clone https://github.com/SpillwaveSolutions/design-doc-mermaid.gitلمن يناسب
يناسب من يريد رسم مخططات Mermaid وكتابة وثائق تصميم في Claude Code. رسمياً: هذه مجموعة مهارات Claude Code قوية تنشئ مخططات Mermaid ووثائق تصميم بأدلة تُحمَّل عند الحاجة، ومخططات مولَّدة من الشفرة، وأدوات Python.
أنسب إن كان لديك مسبقاً تدفق (مثل التسجيل مع التحقق بالبريد) أو شفرة وتريد رؤية مخطط أولاً. لا يناسب من لم يستعد لنسخ المستودع إلى ~/.claude/skills.
قبل البدء يجب أن تستطيع استخدام git clone وأن تقبل مسار التثبيت اليدوي الرسمي الواحد هذا. لا تخلط أمر سوق آخر من أول محاولة.
أول تجربة في 3 دقائق
اتبع تثبيت النسخ من الأصل فقط. في المرة الأولى أخرج مخططاً في الحوار؛ لا تكتب وثيقة تصميم في المستودع بعد.
المتطلبات: هذه الآلة لديها git مسبقاً، وClaude Code يحمّل المهارات من ~/.claude/skills. في المرة الأولى لا تستبدل وثائق إنتاج.
موضع التثبيت: ادخل أولاً إلى مجلد المهارات ثم انسخ المستودع الرسمي.
cd ~/.claude/skills
git clone https://github.com/SpillwaveSolutions/design-doc-mermaid.git
صفحة المستودع الرسمي:
https://github.com/spillwavesolutions/design-doc-mermaid
مشغّل منخفض المخاطر: بعد التثبيت استخدم جملة المثال من الأصل في الحوار: Create an activity diagram for user registration with email verification. اطلب أولاً Mermaid في الحوار فقط بلا كتابة ملف. رسمياً SKILL.md هو ملف التنسيق الرئيسي بشجرة قرار؛ إن بدأ المساعد باستدعاء نصوص لم تُسمَّ فأكّد الآثار الجانبية أولاً.
إشارة النجاح: يوجد ~/.claude/skills/design-doc-mermaid وفيه SKILL.md، ويظهر في الحوار Mermaid لمخطط نشاط. إن ستحفظه كوثيقة فأكّد المسار قبل الكتابة.
أمثلة استخدام
المثال 1: رسم مخطط نشاط من المثال الرسمي. قل للمساعد Create an activity diagram for user registration with email verification. يناسب من يريد وصف تدفق تسجيل والتحقق بالبريد. الدليل يعطي جملة المستخدم هذه فقط بلا اسم ملف دليل. انظر المخطط في الحوار أولاً ثم قرر الكتابة إلى القرص.
المثال 2: توليد مخطط من شفرة موجودة. القدرات الرسمية تشمل code-to-diagram generation. يناسب من لديه شفرة مسبقاً ويريد رؤية مخطط أولاً. الدليل لا يقول أي لغات تُدعم أو إن كانت المصدر تُغيَّر. ولّد للقراءة فقط من شفرتك؛ وإن كانت أداة Python ستكتب ملفاً فأكّد موضع الإخراج أولاً.
حدود الاستخدام
المسار الرئيسي هو النسخ إلى ~/.claude/skills. للأصل أيضاً skilz install SpillwaveSolutions_design-doc-mermaid/design-doc-mermaid. في المرة الأولى لا تفعل الاثنين، ولا تطبّق أمر سوق على بيئة لم تُكتب.
الملف المسمّى الوحيد هو SKILL.md (تنسيق رئيسي بشجرة قرار). لا تُكمل أسماء أدلة أو نصوص أو مسارات مهارات أخرى.
تُذكر أدلة التحميل عند الحاجة وأدوات Python بلا جرد. لا تفترض أنه يثبّت تلقائياً بيئة تشغيل Mermaid أو يرسل وثائق.
الرسمي يكتب هذه المجموعة كمهارة Claude Code فقط؛ لا خطوات لبيئات أخرى.