المهارات routeros-command-tree
📦

routeros-command-tree

آمن

إنشاء مخططات RouterOS API من شجرة الأوامر

يتطلب بناء أدوات تتفاعل مع RouterOS فهم التسلسل الهرمي للأوامر. توفر هذه المهارة القدرة على استكشاف شجرة أوامر RouterOS برمجياً عبر واجهة /console/inspect API وإنشاء مخططات RAML أو OpenAPI.

يدعم: Claude Codex Code(CC)
📊 71 كافٍ
1

تنزيل ZIP المهارة

2

رفع في Claude

اذهب إلى Settings → Capabilities → Skills → Upload skill

3

فعّل وابدأ الاستخدام

اختبرها

استخدام "routeros-command-tree". ما هي العُقد الفرعية تحت /system/script؟

النتيجة المتوقعة:

المسار /system/script يحتوي على هذه الأوامر:
- run (cmd) - تنفيذ سكريبت
- add (cmd) - إنشاء سكريبت جديد
- remove (cmd) - حذف سكريبت
- set (cmd) - تعديل خصائص السكريبت
- print (cmd) - سرد السكريبتات
- export (cmd) - تصدير مصدر السكريبت

استخدام "routeros-command-tree". كيف أقوم بتعيين أوامر /ip/address CLI إلى REST API؟

النتيجة المتوقعة:

تعيين CLI إلى REST:
- add → PUT /rest/ip/address (ينشئ إدخالاً جديداً)
- set → PATCH /rest/ip/address/{id} (يحدّث إدخالاً موجوداً)
- remove → DELETE /rest/ip/address/{id} (يحذف الإدخال)
- print → GET /rest/ip/address (يسرد الكل)
- get (فردي) → GET /rest/ip/address/{id}

التدقيق الأمني

آمن
v2 • 4/16/2026

All 138 static findings are false positives. The skill is a documentation file containing markdown with code examples. The static scanner incorrectly flagged markdown syntax (backticks for code formatting), documentation code snippets (fetch examples), relative markdown links, and misinterpreted documentation text as security issues. No executable code exists in this skill.

1
الملفات التي تم فحصها
329
الأسطر التي تم تحليلها
0
النتائج
2
إجمالي عمليات التدقيق
لا توجد مشكلات أمنية

الأنماط المكتشفة

Markdown Code Formatting Misidentified as Command ExecutionDocumentation Code Examples Misidentified as Network CallsMarkdown Links Misidentified as Path Traversal
تم تدقيقه بواسطة: claude عرض سجل التدقيق →

درجة الجودة

38
الهندسة المعمارية
100
قابلية الصيانة
87
المحتوى
32
المجتمع
100
الأمان
91
الامتثال للمواصفات

ماذا يمكنك بناءه

أدوات بناء توثيق API

إنشاء توثيق شامل لـ API من شجرة أوامر RouterOS المباشرة لإصدار RouterOS الخاص بك.

إنشاء قوالب توليد الأكواد

استخدام شجرة الأوامر لإنشاء مكتبات عملاء مُنوَّعة أو موفري Terraform لموارد RouterOS.

استكشاف الأوامر المتاحة

اكتشاف جميع خيارات التكوين المتاحة ومعاملاتها لمجموعة محددة من ميزات RouterOS.

جرّب هذه الموجهات

استكشاف شجرة الأوامر الأساسية 
ما هي الأوامر المتاحة تحت /ip/firewall في RouterOS؟
تعيين نقاط نهاية API 
قم بتعيين أوامر /interface/bridge إلى نقاط نهاية REST API وأفعال HTTP المقابلة لها.
اكتشاف الوسائط 
ما الوسائط التي يقبلها الأمر /ip/route/add؟ اعرض لي البنية لكل منها.
إنشاء المخططات 
أنشئ مخطط OpenAPI 3.0 لمورد /queue/simple بناءً على شجرة أوامر RouterOS.

أفضل الممارسات

  • استخدم متغير البيئة INSPECTFILE للاختبار لتجنب الاستعلامات المتكررة المباشرة من الراوتر أثناء التطوير
  • تخطّ عمليات البحث عن البنية داخل المسارات الفرعية الخطرة (where و do و else و rule و command و on-error) لمنع تعطل خادم REST
  • خزّن ملف inspect.json مؤقتاً لكل إصدار من RouterOS لأن شجرة الأوامر تختلف بشكل كبير بين الإصدارات

تجنب

  • لا تقم بالاستعلام عن أوصاف البنية لكل وسيط في راوتر مباشر - فهذا يستغرق ساعات لاجتياز الشجرة الكاملة
  • لا تتجاهل المسارات الخطرة - استدعاء fetchSyntax على عُقد الوسائط في تلك المسارات الفرعية ينهي عملية خادم HTTP
  • لا تفترض أن الشجرة متطابقة عبر إصدارات RouterOS - أعد دائماً إنشاء المخططات للإصدار المستهدف

الأسئلة المتكررة

ما هو /console/inspect في RouterOS؟
هو نقطة نهاية REST API تكشف التسلسل الهرمي لأوامر RouterOS. يمكنك الاستعلام عنها لسرد العناصر الفرعية لأي مسار أو الحصول على نص المساعدة للأوامر والوسائط.
كيف أتجنب تعطل خادم REST في RouterOS؟
تخطّ عمليات البحث عن البنية للوسائط داخل المسارات الفرعية التي تحتوي على: where و do و else و rule و command و on-error. هذه هي مكونات برمجية تتسبب في تعطل واجهة inspect API عند الاستعلام عن عُقد الوسائط الخاصة بها.
هل يمكنني العمل بدون جهاز RouterOS مباشر؟
نعم. اضبط متغير البيئة INSPECTFILE للإشارة إلى ملف inspect.json مخزن مؤقتاً. أدوات مثل rest2raml تدعم هذا لإنشاء المخططات دون اتصال.
ما الفرق بين مخرجات RAML و OpenAPI؟
كلاهما يمثل نفس بيانات شجرة الأوامر. يستخدم RAML 1.0 تدويناً موجهاً نحو الموارد. يستخدم OpenAPI 3.0 مصطلحات REST قياسية مع المسارات والأساليب ونصوص الطلبات.
لماذا يستخدم PUT لإنشاء الإدخالات بدلاً من تحديثها؟
يستخدم REST API في RouterOS PUT لعمليات الإنشاء. ويُستخدم PATCH للتحديث. هذا عكس اصطلاحات REST القياسية حيث يكون PUT للتحديث المتطابق و POST للإنشاء.
كم يستغرق اجتياز الشجرة بالكامل؟
على راوتر مباشر، يستغرق الاجتياز الكامل دقائق عديدة بسبب آلاف طلبات HTTP المتتالية. مع CHR المعجَّل بواسطة KVM يكون أسرع لكنه لا يزال يستغرق وقتاً. استخدم ملف inspect.json المخزن مؤقتاً للتطوير.

تفاصيل المطور

المؤلف

tikoci

الترخيص

MIT

المستودع

https://github.com/tikoci/routeros-skills/tree/main/routeros-command-tree

مرجع

main

بنية الملفات

📄 SKILL.md