技能 routeros-command-tree
📦

routeros-command-tree

安全

從命令樹生成 RouterOS API 結構描述

建構與 RouterOS 互動的工具需要了解命令層級結構。本技能提供透過 /console/inspect API 以程式方式探索 RouterOS 命令樹的知識,並生成 RAML 或 OpenAPI 結構描述。

支援: Claude Codex Code(CC)
📊 71 充足
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}

安全審計

安全
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 文件工具

從即時 RouterOS 命令樹為您的特定 RouterOS 版本生成全面的 API 文件。

建立程式碼生成範本

使用命令樹為 RouterOS 資源生成型別用戶端函式庫或 Terraform 提供者。

探索可用命令

探索特定 RouterOS 功能集的所有可用設定選項及其參數。

試試這些提示

基本命令樹探索
RouterOS 中 /ip/firewall 下有哪些可用命令?
API 端點映射
將 /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 版本之間的樹是相同的——務必為目標版本重新生成結構描述

常見問題

RouterOS 中的 /console/inspect 是什麼?
這是一個 REST API 端點,公開了 RouterOS 命令層級結構。您可以查詢它來列出任何路徑的子項目,或取得命令和引數的說明文字。
如何避免 RouterOS REST 伺服器當機?
跳過包含以下內容的子樹中引數的語法查詢:where、do、else、rule、command、on-error。這些是腳本結構,當查詢它們的 arg 節點時會導致 inspect API 當機。
我可以不使用即時 RouterOS 裝置嗎?
可以。將 INSPECTFILE 環境變數設為指向快取的 inspect.json 檔案。rest2raml 等工具支援離線結構描述生成。
RAML 和 OpenAPI 輸出有什麼區別?
兩者代表相同的命令樹資料。RAML 1.0 使用資源導向標記法。OpenAPI 3.0 使用標準 REST 術語,包括路徑、方法和要求主體。
為什麼 PUT 建立項目而不是 PUT 更新?
RouterOS REST API 使用 PUT 進行建立操作。使用 PATCH 進行更新。這與標準 REST 慣例相反,標準慣例中 PUT 是等冪更新,POST 是建立。
完整樹遍歷需要多長時間?
對著即時路由器,完整遍歷由於數千個順序 HTTP 請求需要數分鐘。使用 KVM 加速的 CHR 會更快,但仍耗時。開發時使用快取的 inspect.json。

開發者詳情

檔案結構

📄 SKILL.md