@vmscloud/moz-ui-migrate

custom-ui 레포를 레거시 moz-ui 패키지에서 신규 public npm 패키지로 전환하는 CLI 와 AI 에이전트 스킬입니다.

| 레거시 (GitHub Packages) | 신규 (public npm) | |---|---| | @vmscloud/moz-ui-components | @vmscloud/moz-ui-components-vue + @vmscloud/moz-ui-components-core | | @vmscloud/moz-wijmo-grid (Wijmo) | @vmscloud/moz-ui-grid-vue + @vmscloud/moz-ui-grid-wrapper | | @vmscloud/moz-ui-chart | @vmscloud/moz-ui-chart-vue |

사용법

레포 루트(frontend/ 의 상위 폴더)에서 실행합니다. 버전은 고정해서 씁니다.

npx @vmscloud/moz-ui-migrate@<버전> init     # 에이전트 스킬을 .claude/skills·.agents/skills 에 설치하고 AGENTS.md 에 안내 추가

그다음 사용하는 AI 코딩 에이전트에게 이렇게 지시합니다.

moz-ui-migrate 스킬대로 이 레포를 전환해.

에이전트는 스킬 절차에 따라 아래 명령을 실행하고, 남은 화면 코드를 참고 문서대로 옮긴 뒤 빌드와 화면을 확인합니다.

| 명령 | 하는 일 | |---|---| | apply [--dry-run] | 고치지 않은 템플릿 파일을 전환된 템플릿 버전으로 교체, package.json·.npmrc 정리, 이름만 바뀐 import·컴포넌트 치환 | | check [--json] | 남은 레거시 사용처와 설정 문제를 규칙 ID·파일·줄·참고 문서와 함께 출력. 오류가 있으면 종료 코드 1 | | show <경로> | 전환된 템플릿 버전의 파일 내용 출력 (템플릿 파일을 고쳐 쓰는 포크가 비교할 때) |

공통 옵션: --root <경로> (기본: 현재 폴더)

동작 원칙

• apply 는 포크가 고치지 않은 템플릿 파일만 바꿉니다. 판단 기준은 내용 해시이고(줄바꿈 차이는 무시), 템플릿의 과거 모든 버전과 비교합니다. 고친 파일은 바꾸지 않고 "직접 작업 필요"로 보고합니다.
• 의미가 바뀌는 변환(Wijmo 그리드를 MozGrid 로 다시 작성하는 일 등)은 자동으로 하지 않습니다. 스킬 참고 문서를 보고 에이전트나 개발자가 옮깁니다.
• 사용자 전역 설정(~/.npmrc)은 읽기만 하고 고치지 않습니다.

패키지 유지보수

• manifest.json·template/ 은 custom-ui 템플릿 git 이력에서 생성합니다. 템플릿의 전환 커밋이나 신규 패키지 하한 버전이 바뀌면 다시 만듭니다.

  node scripts/build-manifest.mjs <custom-ui 템플릿 경로> <전환 전 커밋> <전환 후 커밋>

• 점검 규칙은 src/rules.mjs 의 규칙표(데이터)에 둡니다.

• 테스트: npm test

• 게시: .github/workflows/publish-moz-ui-migrate.yml