스킬 routeros-command-tree
📦

routeros-command-tree

낮은 위험 🌐 네트워크 접근

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

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

지원: Claude Codex Code(CC)
⚠️ 68 나쁨
1

스킬 ZIP 다운로드

2

Claude에서 업로드

설정 → 기능 → 스킬 → 스킬 업로드로 이동

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}

보안 감사

낮은 위험
v3 • 5/9/2026

Static analysis flagged 138 potential issues, but evaluation reveals 133 are false positives (markdown documentation patterns misinterpreted as code execution). Two network fetch() calls exist but are legitimate API queries to RouterOS /console/inspect endpoint - the documented core functionality. No malicious intent, command injection vectors, or actual security vulnerabilities present. Risk assessed as LOW due to intentional network access required for skill purpose.

1
스캔된 파일
329
분석된 줄 수
1
발견 사항
3
총 감사 수

위험 요인

🌐 네트워크 접근 (2)
감사자: claude 감사 이력 보기 →

품질 점수

38
아키텍처
100
유지보수성
87
콘텐츠
23
커뮤니티
90
보안
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

참조

main

파일 구조

📄 SKILL.md