Compétences routeros-command-tree
📦

routeros-command-tree

Sûr

Générer des schémas RouterOS API depuis l'arborescence de commandes

La création d'outils interagissant avec RouterOS nécessite de comprendre la hiérarchie des commandes. Cette compétence fournit les connaissances nécessaires pour explorer programmatiquement l'arborescence de commandes RouterOS via l'API /console/inspect et générer des schémas RAML ou OpenAPI.

Prend en charge: Claude Codex Code(CC)
📊 71 Adéquat
1

Télécharger le ZIP du skill

2

Importer dans Claude

Allez dans Paramètres → Capacités → Skills → Importer un skill

3

Activez et commencez à utiliser

Tester

Utilisation de "routeros-command-tree". What are the child nodes under /system/script?

Résultat attendu:

The /system/script path contains these commands:
- run (cmd) - Execute a script
- add (cmd) - Create a new script
- remove (cmd) - Delete a script
- set (cmd) - Modify script properties
- print (cmd) - List scripts
- export (cmd) - Export script source

Utilisation de "routeros-command-tree". How do I map the /ip/address CLI commands to REST API?

Résultat attendu:

CLI to REST mapping:
- add → PUT /rest/ip/address (creates new entry)
- set → PATCH /rest/ip/address/{id} (updates existing)
- remove → DELETE /rest/ip/address/{id} (deletes entry)
- print → GET /rest/ip/address (lists all)
- get (single) → GET /rest/ip/address/{id}

Audit de sécurité

Sûr
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
Fichiers analysés
329
Lignes analysées
0
résultats
2
Total des audits
Aucun problème de sécurité trouvé

Motifs détectés

Markdown Code Formatting Misidentified as Command ExecutionDocumentation Code Examples Misidentified as Network CallsMarkdown Links Misidentified as Path Traversal
Audité par: claude Voir l’historique des audits →

Score de qualité

38
Architecture
100
Maintenabilité
87
Contenu
32
Communauté
100
Sécurité
91
Conformité aux spécifications

Ce que vous pouvez construire

Construire des outils de documentation API

Générer une documentation API complète depuis l'arborescence de commandes RouterOS active pour votre version spécifique de RouterOS.

Créer des modèles de génération de code

Utiliser l'arborescence de commandes pour générer des bibliothèques clientes typées ou des fournisseurs Terraform pour les ressources RouterOS.

Explorer les commandes disponibles

Découvrir toutes les options de configuration disponibles et leurs paramètres pour un ensemble de fonctionnalités RouterOS spécifique.

Essayez ces prompts

Exploration basique de l'arborescence de commandes 
What are the available commands under /ip/firewall in RouterOS?
Mapping des points de terminaison API 
Map the /interface/bridge commands to their corresponding REST API endpoints and HTTP verbs.
Découverte des arguments 
What arguments does the /ip/route/add command accept? Show me the syntax for each.
Génération de schémas 
Generate an OpenAPI 3.0 schema for the /queue/simple resource based on the RouterOS command tree.

Bonnes pratiques

  • Utiliser la variable d'environnement INSPECTFILE pour les tests afin d'éviter des requêtes répétées vers le routeur actif pendant le développement
  • Ignorer les recherches de syntaxe pour les arguments dans les sous-arborescences dangereuses (where, do, else, rule, command, on-error) pour empêcher les plantages du serveur REST
  • Mettre en cache le fichier inspect.json par version de RouterOS car l'arborescence de commandes varie significativement entre les versions

Éviter

  • Ne pas interroger les descriptions de syntaxe pour chaque argument sur un routeur actif - cela prend des heures pour un parcours complet de l'arborescence
  • Ne pas ignorer les chemins dangereux - appeler fetchSyntax sur des nœuds arg dans ces sous-arborescences termine le processus du serveur HTTP
  • Ne pas supposer que l'arborescence est identique entre les versions de RouterOS - toujours régénérer les schémas pour votre version cible

Foire aux questions

Qu'est-ce que /console/inspect dans RouterOS ?
Il s'agit d'un point de terminaison API REST qui expose la hiérarchie des commandes RouterOS. Vous pouvez l'interroger pour lister les enfants de n'importe quel chemin ou obtenir le texte d'aide pour les commandes et les arguments.
Comment éviter de faire planter le serveur REST RouterOS ?
Ignorez les recherches de syntaxe pour les arguments dans les sous-arborescences contenant : where, do, else, rule, command, on-error. Ce sont des constructions de script qui font planter l'API inspect lorsque leurs nœuds arg sont interrogés.
Puis-je travailler sans appareil RouterOS actif ?
Oui. Définissez la variable d'environnement INSPECTFILE pour pointer vers un fichier inspect.json en cache. Des outils comme rest2raml prennent en charge cela pour la génération de schémas hors ligne.
Quelle est la différence entre les sorties RAML et OpenAPI ?
Les deux représentent les mêmes données d'arborescence de commandes. RAML 1.0 utilise une notation orientée ressources. OpenAPI 3.0 utilise une terminologie REST standard avec des chemins, des méthodes et des corps de requête.
Pourquoi PUT crée-t-il des entrées au lieu de les mettre à jour ?
L'API REST RouterOS utilise PUT pour les opérations de création. PATCH est utilisé pour les mises à jour. C'est l'inverse des conventions REST standard où PUT est une mise à jour idempotente et POST est une création.
Combien de temps prend le parcours complet de l'arborescence ?
Sur un routeur actif, le parcours complet prend plusieurs minutes en raison des milliers de requêtes HTTP séquentielles. Avec un CHR accéléré par KVM, c'est plus rapide mais toujours chronophage. Utilisez un fichier inspect.json en cache pour le développement.

Détails du développeur

Auteur

tikoci

Licence

MIT

Dépôt

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

Réf

main

Structure de fichiers

📄 SKILL.md