스킬 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 (single) → 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 환경 변수 사용
  • REST 서버 충돌을 방지하기 위해 위험한 하위 트리(where, do, else, rule, command, on-error) 내부의 인수 구문 조회 건너뛰기
  • 명령 트리가 릴리스 간에 크게 달라지므로 RouterOS 버전별 inspect.json 캐시 유지

피하기

  • 라이브 라우터에서 모든 인수에 대한 구문 설명을 쿼리하지 마세요 - 전체 트리 탐색에 몇 시간이 소요됩니다
  • 위험 경로를 무시하지 마세요 - 해당 하위 트리의 arg 노드에서 fetchSyntax를 호출하면 HTTP 서버 프로세스가 종료됩니다
  • 트리가 RouterOS 버전 간에 동일하다고 가정하지 마세요 - 항상 대상 버전에 대해 스키마를 다시 생성하세요

자주 묻는 질문

RouterOS에서 /console/inspect란 무엇인가요?
RouterOS 명령 계층 구조를 노출하는 REST API 엔드포인트입니다. 이를 쿼리하여 모든 경로의 하위 항목을 나열하거나 명령 및 인수에 대한 도움말 텍스트를 얻을 수 있습니다.
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이 업데이트 대신 생성에 사용되나요?
RouterOS REST API는 생성 작업에 PUT을 사용합니다. PATCH는 업데이트에 사용됩니다. 이는 PUT이 멱등적 업데이트이고 POST가 생성인 표준 REST 관례와 반대입니다.
전체 트리 탐색에 얼마나 걸리나요?
라이브 라우터에서의 전체 탐색은 수천 번의 순차적 HTTP 요청으로 인해 수 분이 소요됩니다. KVM 가속 CHR에서는 더 빠르지만 여전히 시간이 많이 소요됩니다. 개발에는 캐시된 inspect.json을 사용하세요.

개발자 세부 정보

작성자

tikoci

라이선스

MIT

리포지토리

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

참조

main

파일 구조

📄 SKILL.md