Skills

msw-map-ui-edit

Installation
SKILL.md

MSW .map / .ui 에셋 읽기·분석

실행 방식 — 에이전트 위임

이 스킬이 트리거되면 직접 VFS를 실행하지 말고, msw-blob-vfs-reader 에이전트에 위임한다.

Agent(
  subagent_type="msw-devtools:msw-blob-vfs-reader",
  description="맵/UI 분석",
  prompt="<사용자 요청 + 대상 파일 경로를 포함한 구체적 지시>"
)

이유: .map/.ui VFS 출력은 대량이며 메인 컨텍스트를 오염시킨다. 에이전트가 sonnet 모델로 분석 후 요약만 돌려주므로 컨텍스트 효율이 높다.

예외 — 에이전트 위임 없이 직접 실행하는 경우:

  • 사용자가 명시적으로 "여기서 직접 해줘"라고 요청한 경우
  • 분석 결과를 바탕으로 즉시 편집 작업이 이어지는 경우 (편집 컨텍스트가 필요)

직접 실행 시 VFS 명령 상세: docs/vfs-commands.md (ls/grep/glob/stat/read/tree/summary + lazy 탐색 워크플로).

파일 포맷

확장자 내용 Summary 고유 필드
.map 맵 에셋 — 타일맵, Foothold, 스폰, 엔티티 배치 tile_map_mode (MapleTile / RectTile / SideViewRectTile)
.ui UI 에셋 — 캔버스 그룹, 버튼, 텍스트, 조이스틱, 스프라이트 ui_group_type, buttons, texts, sprites

하나의 도구(map_vfs.py)가 둘 다 처리한다.

⚠️ 현재 상태 — 읽기 전용

  • 읽기/분석: map_vfs.py로 완전 지원 (ls / grep / glob / stat / read / tree / summary) — docs/vfs-commands.md
  • 편집: 현재 스킬이 제공하는 편집 API는 없음 (복원 예정).
    • Edit 도구로 .map/.ui를 라인 단위 수정하지 말 것 — 단일 거대 JSON이라 부분 수정에 취약.
    • 수동 편집이 필요하면: docs/manual-editing.md (4가지 접근법 + origin/modelId 규칙 + 렌더링 요건 + .ui 신뢰도 경고)

참고 문서

Installs
1
Repository
choigawoon/choi…-plugins
First Seen
Apr 21, 2026