Install
python3 "$SKILL_ROOT/scripts/fireworks.py" versionلمن يناسب
إذا أردت وصف بنية أو مسار باللغة الطبيعية والحصول على SVG مُراجع هندسيًا مع PNG عالي الدقة، فهذا Agent Skill أنسب. المهارة نفسها تعمل في Codex وClaude Code دون تعديل. ويمكنها أيضًا عمل رسوم دلالية من SVG إلى GIF بعد التحقق، وHTML تفاعلي دون اتصال.
تحتاج أن تكون قادرًا أصلًا على استدعاء المهارة في مساعدي الترميز المذكورين، وأن يتوفر python3 على جهازك وأن يُعثر على $SKILL_ROOT/scripts/fireworks.py. من يريد الرسم يدويًا فقط ولا ينوي أن يكتب الوكيل ملفاتًا، فائدته محدودة. الصفحة تسمّي Codex وClaude Code فقط، بلا عملاء آخرين. ولا تغطِّ بعدد أنماط ربما أقدم في عنوان المستودع ما في المتن: 11 نمط مولّد زائد نمط كتابة ذكاء اصطناعي واحد (Dark Luxury).
أول محاولة في 3 دقائق
الصفحة لا تعطي أمر تثبيت سوق منفصل. ابدأ بمراجعة للقراءة فقط: عندما يكون جذر المهارة جاهزًا نفّذ
python3 "$SKILL_ROOT/scripts/fireworks.py" version
علامة النجاح أن الأمر يمرّ ويعطي معلومات الإصدار. لا يكتب ملفات مخطط. إن لم يوجد $SKILL_ROOT بعد، قف: النص المتاح من الصفحة لا يقول كيف تُدخل المهارة إلى Codex أو Claude Code؛ لا تخترع مثبّتًا.
بعد نجاح الإصدار، نفّذ إخراجًا مضبوطًا مرة واحدة. المثال الرسمي أن يقول المستخدم “Generate a Mem0 memory architecture diagram, dark style”. تصنّف المهارة ذلك Memory Architecture Diagram، Style 2، تولّد SVG بمسارات سباحة وأسطوانات وأسهم دلالية، ثم تصدّر PNG بعرض 1920px، وتبلّغ mem0-architecture.svg / mem0-architecture.png. قبل الكتابة اجعل الوكيل يعيد هذين المسارين، ولا تولّد إلا بعد تأكيدك. لا تبدأ بـ GIF أو HTML: النص المتاح يذكر هذه النواتج بلا أوامر فرعية مقابلة.
حالات الاستخدام
الحالة الأولى: إخراج مخطط بنية من اللغة الطبيعية. استخدم مثال Mem0 أعلاه للتحقق من السلسلة كلها: تصنيف → SVG → PNG بعرض 1920px → الإبلاغ عن أسماء الملفات. لم يكتب كل معاملات Style 2 البصرية، ولا مصدر معرفة مجال Mem0. لذا القبول ينظر فقط: أن يُقال التصنيف، وأن يظهر الاسمان في التقرير. إن بدأ الوكيل بتغيير شيفرة عملك فقد غادر مهمة الرسم.
الحالة الثانية: تصدير PNG من SVG موجود. واجهة الأوامر الرسمية هي
python3 "$SKILL_ROOT/scripts/fireworks.py" export-png diagram.svg diagram.png --width 1920
هذا يستبدل أو ينشئ diagram.png. أكّد أولًا وجود SVG الإدخال وأن مسار الإخراج قابل للكتابة. لتفادي قصّ النص أضف "text_policy": "strict" إلى الإعداد: يرفض القطع الظاهر قبل الكتابة، يبقي تسميات المصدر كاملة في التقرير ويشرح الاستعادة؛ الأوصاف الصينية تستخدم السطر الثاني المتاح. النص المتاح لا يعطي اسم ملف JSON كاملًا. يمكنك فقط تأكيد هذا الحقل والسطر الصيني الثاني؛ لا تخترع قيم سياسة أخرى.
حدود الاستخدام
عدد الأنماط يتبع المتن: 11 نمط مولّد، زائد Dark Luxury. وهناك أربعة أنماط أقرب للهندسة تعطي اتفاقيات قابلة للتنفيذ لمراجعة C4، والنشر السحابي، وتدفقات الأحداث، وتشخيص الاعتمادية، إضافة إلى أنماط مجال AI/Agent العميقة وجميع أنواع مخططات UML الأربعة عشر. الصفحة لا تسمّي أنواع UML الأربعة عشر ولا الأسماء القصيرة لتلك الأنماط الهندسية الأربعة. إن غاب الاسم فلا تستدعه.
الأوامر القابلة للنسخ هي version وexport-png فقط. GIF وHTML التفاعلي مكتوبان كقدرات بلا سطر أوامر. لا تضع مثبّتًا ثانيًا إلى جانبهما. العملاء مكتوبون حتى Codex وClaude Code فقط.
التوقف الأول هو version أو PNG واحد تأكدت من مساره. أي إخراج دفعي، أو حقل مجهول غير text_policy، أو توليد GIF/HTML، يجب أن يشرح الوكيل أولًا المستند والملفات التي سيكتبها، وتؤكّد أنت ثم يكمل.