Claude Code 제로보드4→라이믹스 이전 스킬 — "제로보드 이전" (zb4-rhymix-migration)

스킬 파일 제공

구매하시면 SKILL.md(이전 절차·함정)와 설치 안내 README 가 담긴 압축 파일을 받으실 수 있습니다. ~/.claude/skills/ 에 폴더째 두면 자동으로 인식됩니다.

Claude Code 제로보드4→라이믹스 이전 스킬 —

오래된 제로보드4 사이트를 라이믹스로 옮기려고 찾아보면, 공식 경로는 "XE 1.4.5.7 + PHP 5.3 을 먼저 세운 뒤 XE 로 이전"입니다. 지금 그 환경을 재현하기는 어렵고, 최신 XE 1.11 의 importer 는 제로보드4 XML 복원을 지원하지 않습니다.

왜 만들었나

실제 이전 프로젝트에서 라이믹스가 XE 의 importer 모듈을 그대로 이어받았다는 점을 이용해 XE 를 건너뛰고 라이믹스로 직행했습니다. 그 과정에서 인코딩, CSRF, 시퀀스, 도메인, 스킨변수에서 한 번씩 막혔고, 막힌 지점과 해법을 다음 이전에서 다시 헤매지 않도록 순서대로 적어 둔 스킬입니다.

무엇을 하나

DB 인코딩 — DDL 은 CHARSET=euckr 인데 내용은 이미 UTF-8 로 떠진 덤프를 그대로 복원하면 깨집니다. DDL 치환 + utf8 커넥션 복원 후 한글 SELECT 로 검증합니다. 소스 파일 변환은 iconv -f cp949.
옛 사이트 PHP8 구동(필요할 때) — 단축태그, mysql_*, 무따옴표 배열 키, call-time 참조 네 가지 막힘과 opcache 가 옛 컴파일본을 붙잡는 함정. 스킨 패치는 정규식이 아니라 PHP 토크나이저로.
데이터 이전 — XE-XML(모든 값 base64)을 라이믹스 importer 에 넣는 3단계 호출, 기본 설정에서 필요한 Sec-Fetch-Site: same-origin 헤더, 게시판 생성 필수 값.
회원·첨부·쪽지 — 옛 비밀번호 해시는 로그인 불가(전 회원 재설정 안내), 첨부는 base64 임베드가 서버 간 이전에 안전, 쪽지는 회원 숫자 ID 로 조인, 답글 트리는 평탄화.
라이믹스 배포 함정 — 아래 표의 세 가지와 캐시 정리.
레이아웃·스킨 — 레이아웃과 게시판 스킨의 역할 구분, 동적 이미지 경로는 자동 리라이트되지 않는 점, 표시 모드 분기.

배포에서 막힌 세 가지

함정	증상	해법
rx_sequence 누락	DB 를 행 단위로 부분 복제하면 srl 재사용 충돌(관리자 메뉴가 대시보드만 보임)	시퀀스를 원본 최대값 이상으로 올린다
도메인 미등록	접속 호스트가 `rx_domains` 에 없으면 게시판 설정이 화면에 반영 안 됨	`rx_domains.domain` 을 운영 도메인으로
스킨변수 위치	`rx_module_extra_vars` 에 넣으면 관리자 스킨 설정이 먹통	`rx_module_skins` 로 일원화

설정을 바꾼 뒤에는 files/cache/* 삭제와 opcache 초기화까지 해야 반영됩니다.

실행 툴킷은 별도 상품입니다

이 스킬은 Claude 가 이전 작업을 할 때 따르는 절차와 함정 목록(지침서)입니다. 변환 스크립트 등 실행 툴킷은 별도 상품인 제로보드4 → 라이믹스 이전 툴킷에 있습니다.

구성

파일	역할
`zb4-rhymix-migration/SKILL.md`	이전 워크플로우 — 대원칙, 인코딩, PHP8 구동, 데이터 이전, 회원·첨부·쪽지, 배포 함정, 레이아웃·스킨, 검증
`zb4-rhymix-migration/README.md`	설치와 쓰는 법

설치

구매 후 전체 프롬프트 확인 가능

유료 프롬프트의 전문과 복사용 프롬프트는 구매자에게만 제공됩니다. 공개 본문에서는 구성, 활용 범위, 업데이트 내역만 확인할 수 있습니다.

요구 사항

Claude Code
이전 대상 제로보드4 DB 덤프·파일
라이믹스 설치 환경(PHP 8, MySQL/MariaDB)

이런 분께

아직 제로보드4 로 운영 중인 커뮤니티를 라이믹스로 옮기려는 분
XE 를 거치는 옛 이전 경로를 재현하다 막힌 분
라이믹스로 옮긴 뒤 게시판 설정·스킨 설정이 반영되지 않아 헤매는 분