routeros-command-tree
RouterOSコマンドツリーからAPIスキーマを生成する
RouterOSと対話するツールを構築するには、コマンド階層を理解する必要があります。このスキルは、/console/inspect API経由でRouterOSコマンドツリーをプログラム的に探索し、RAMLまたはOpenAPIスキーマを生成する知識を提供します。
スキルZIPをダウンロード
Claudeでアップロード
設定 → 機能 → スキル → スキルをアップロードへ移動
オンにして利用開始
テストする
「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}
セキュリティ監査
安全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.
検出されたパターン
品質スコア
作れるもの
APIドキュメントツールの構築
特定のRouterOSバージョン用のライブRouterOSコマンドツリーから包括的なAPIドキュメントを生成します。
コード生成テンプレートの作成
コマンドツリーを使用して、RouterOSリソース用の型付きクライアントライブラリまたはTerraformプロバイダを生成します。
利用可能なコマンドの探索
特定のRouterOS機能セットに対して、利用可能なすべての設定オプションとそのパラメータを発見します。
これらのプロンプトを試す
RouterOSの/ip/firewallの下に利用可能なコマンドは何ですか？
/interface/bridgeコマンドを対応するREST APIエンドポイントとHTTP動詞にマッピングしてください。
/ip/route/addコマンドが受け入れる引数は何ですか？それぞれの構文を表示してください。
RouterOSコマンドツリーに基づいて/queue/simpleリソースのOpenAPI 3.0スキーマを生成してください。
ベストプラクティス
- 開発中にライブルータへの繰り返しのクエリを避けるため、テストにはINSPECTFILE環境変数を使用してください
- 危険なサブツリー（where、do、else、rule、command、on-error）内の引数の構文参照をスキップし、RESTサーバのクラッシュを防ぐ
- RouterOSバージョンごとにinspect.jsonをキャッシュしてください。コマンドツリーはリリース間で大きく異なります
回避
- ライブルータですべての引数の構文説明にクエリを実行しないでください。フルツリー走査には何時間もかかります
- 危険なパスを無視しないでください。これらのサブツリーのargノードでfetchSyntaxを呼び出すとHTTPサーバプロセスが終了します
- ツリーがRouterOSバージョン間で同一だと想定しないでください。対象バージョン用に必ずスキーマを再生成してください