Fähigkeiten routeros-command-tree
📦

routeros-command-tree

Sicher

RouterOS-API-Schemata aus der Befehlshierarchie generieren

Der Aufbau von Tools, die mit RouterOS interagieren, erfordert das Verständnis der Befehlshierarchie. Diese Skill vermittelt das Wissen, um die RouterOS-Befehlshierarchie über die /console/inspect-API programmatisch zu erkunden und RAML- oder OpenAPI-Schemata zu generieren.

Unterstützt: Claude Codex Code(CC)
📊 71 Angemessen
1

Die Skill-ZIP herunterladen

2

In Claude hochladen

Gehe zu Einstellungen → Fähigkeiten → Skills → Skill hochladen

3

Einschalten und loslegen

Teste es

Verwendung von "routeros-command-tree". Was sind die untergeordneten Knoten unter /system/script?

Erwartetes Ergebnis:

Der Pfad /system/script enthält diese Befehle:
- run (cmd) - Skript ausführen
- add (cmd) - Neues Skript erstellen
- remove (cmd) - Skript löschen
- set (cmd) - Skripteigenschaften ändern
- print (cmd) - Skripte auflisten
- export (cmd) - Skriptquelltext exportieren

Verwendung von "routeros-command-tree". Wie ordne ich die /ip/address-CLI-Befehle der REST-API zu?

Erwartetes Ergebnis:

CLI-zu-REST-Zuordnung:
- add → PUT /rest/ip/address (erstellt neuen Eintrag)
- set → PATCH /rest/ip/address/{id} (aktualisiert vorhandenen)
- remove → DELETE /rest/ip/address/{id} (löscht Eintrag)
- print → GET /rest/ip/address (listet alle auf)
- get (einzelner) → GET /rest/ip/address/{id}

Sicherheitsaudit

Sicher
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
Gescannte Dateien
329
Analysierte Zeilen
0
befunde
2
Gesamtzahl Audits
Keine Sicherheitsprobleme gefunden

Erkannte Muster

Markdown Code Formatting Misidentified as Command ExecutionDocumentation Code Examples Misidentified as Network CallsMarkdown Links Misidentified as Path Traversal
Auditiert von: claude Audit-Verlauf anzeigen →

Qualitätsbewertung

38
Architektur
100
Wartbarkeit
87
Inhalt
32
Community
100
Sicherheit
91
Spezifikationskonformität

Was du bauen kannst

API-Dokumentationstools erstellen

Generiere umfassende API-Dokumentation aus der Live-RouterOS-Befehlshierarchie für deine spezifische RouterOS-Version.

Codegenerierungs-Templates erstellen

Nutze die Befehlshierarchie, um typisierte Client-Bibliotheken oder Terraform-Provider für RouterOS-Ressourcen zu generieren.

Verfügbare Befehle erkunden

Entdecke alle verfügbaren Konfigurationsoptionen und ihre Parameter für einen bestimmten RouterOS-Funktionsumfang.

Probiere diese Prompts

Grundlegende Befehlshierarchie-Erkundung
Welche verfügbaren Befehle gibt es unter /ip/firewall in RouterOS?
API-Endpunkt-Zuordnung
Ordne die /interface/bridge-Befehle ihren entsprechenden REST-API-Endpunkten und HTTP-Verben zu.
Argument-Erkennung
Welche Argumente akzeptiert der Befehl /ip/route/add? Zeig mir die Syntax für jedes.
Schema-Generierung
Generiere ein OpenAPI 3.0-Schema für die Ressource /queue/simple basierend auf der RouterOS-Befehlshierarchie.

Bewährte Verfahren

  • Verwende die INSPECTFILE-Umgebungsvariable zum Testen, um wiederholte Live-Router-Abfragen während der Entwicklung zu vermeiden
  • Überspringe Syntax-Recherchen für Argumente in gefährlichen Teilbäumen (where, do, else, rule, command, on-error), um Abstürze des REST-Servers zu verhindern
  • Cache inspect.json pro RouterOS-Version, da sich die Befehlshierarchie zwischen Releases erheblich unterscheidet

Vermeiden

  • Keine Syntax-Beschreibungen für jedes Argument an einem Live-Router abfragen – dies dauert Stunden für die vollständige Baumdurchlaufung
  • Gefährliche Pfade nicht ignorieren – das Aufrufen von fetchSyntax für Argumente in diesen Unterstrukturen terminiert den HTTP-Server-Prozess
  • Nicht davon ausgehen, dass der Baum zwischen RouterOS-Versionen identisch ist – Schemas immer für die Zielversion neu generieren

Häufig gestellte Fragen

Was ist /console/inspect in RouterOS?
Es ist ein REST-API-Endpunkt, der die RouterOS-Befehlshierarchie exponiert. Du kannst ihn abfragen, um Kinder jedes Pfads aufzulisten oder Hilfstext für Befehle und Argumente zu erhalten.
Wie vermeide ich Abstürze des RouterOS REST-Servers?
Überspringe Syntax-Recherchen für Argumente in Unterstrukturen, die enthalten: where, do, else, rule, command, on-error. Dies sind Skripting-Konstrukte, die die inspect API zum Absturz bringen, wenn ihre arg nodes abgefragt werden.
Kann ich ohne ein Live-RouterOS-Gerät arbeiten?
Ja. Setze die INSPECTFILE-Umgebungsvariable auf eine gecachte inspect.json-Datei. Tools wie rest2raml unterstützen dies für die Offline-Schema-Generierung.
Was ist der Unterschied zwischen RAML- und OpenAPI-Ausgabe?
Beide repräsentieren dieselben Befehlshierarchiedaten. RAML 1.0 verwendet ressourcenorientierte Notation. OpenAPI 3.0 verwendet Standard-REST-Terminologie mit Pfaden, Methoden und Request-Bodies.
Warum erstellt PUT Einträge statt PUT zu aktualisieren?
Die RouterOS REST-API verwendet PUT für Erstellungsoperationen. PATCH wird für Updates verwendet. Dies ist das Gegenteil der Standard-REST-Konventionen, wobei PUT für idempotente Updates und POST für Erstellung steht.
Wie lange dauert die vollständige Baumdurchlaufung?
Gegenüber einem Live-Router dauert die vollständige Durchlaufung wegen tausender sequentieller HTTP-Anfragen viele Minuten. Mit KVM-beschleunigtem CHR ist es schneller, aber immer noch zeitaufwendig. Verwende gecachte inspect.json für die Entwicklung.

Entwicklerdetails

Dateistruktur

📄 SKILL.md