Pokemon Green i18n Sync Tool
포켓몬 그린 스킬의 언어별 버전(pokemon-green-ko, pokemon-green-en) 간 구조 동기화 및 검증 도구입니다.
기능
1. 싱크 검사 (Sync Validation)
언어 스킬 간 파일 구조와 JSON 키 일치 여부를 검사합니다.
명령어: "포켓몬 스킬 싱크 검사" / "pokemon skill sync check"
검사 항목:
- •파일 존재 여부 비교 (ko에 있는 파일이 en에도 있는지)
- •JSON 파일의 키 구조 비교
- •SKILL.md 섹션 수 비교
2. 싱크 리포트 (Sync Report)
상세한 차이점 리포트를 생성합니다.
명령어: "포켓몬 스킬 싱크 리포트" / "pokemon skill sync report"
3. 구조 복사 (Structure Copy)
기준 언어의 구조를 다른 언어로 복사합니다 (값은 플레이스홀더).
명령어: "포켓몬 스킬 구조 복사 ko→en" / "pokemon skill copy structure ko to en"
4. Diff 보기 (Diff View)
특정 파일의 언어 간 차이를 보여줍니다.
명령어: "포켓몬 스킬 diff species.json" / "pokemon skill diff moves.json"
스킬 경로
| 스킬 | 경로 |
|---|---|
| 한국어 | .claude/skills/pokemon-green-ko/ |
| 영어 | .claude/skills/pokemon-green-en/ |
프로젝트 경로: /Users/jelly/personal/pukiman/
사용법
싱크 검사 실행
bash
# 검증 스크립트 실행 bash skills/pokemon-i18n-sync/scripts/validate-sync.sh
수동 키 비교 (jq)
bash
# ko 파일의 키 추출
jq -r '[paths(scalars) | join(".")] | sort | .[]' \
.claude/skills/pokemon-green-ko/data/pokemon/species.json > /tmp/keys_ko.txt
# en 파일의 키 추출
jq -r '[paths(scalars) | join(".")] | sort | .[]' \
.claude/skills/pokemon-green-en/data/pokemon/species.json > /tmp/keys_en.txt
# 차이 비교
diff /tmp/keys_ko.txt /tmp/keys_en.txt
검사 대상 파일
데이터 파일 (data/)
| 파일 | 설명 | 키 검사 |
|---|---|---|
pokemon/species.json | 151 포켓몬 | 포켓몬 ID 키 |
pokemon/learnsets.json | 레벨업 기술 | 포켓몬 ID 키 |
pokemon/evolutions.json | 진화 조건 | 포켓몬 ID 키 |
moves/moves.json | 165 기술 | 기술명 키 |
world/locations.json | 위치 데이터 | 위치 ID 키 |
world/trainers.json | 트레이너 | 트레이너 ID 키 |
messages/battle.json | 전투 메시지 | 메시지 키 |
SKILL.md
- •섹션 수 일치 여부
- •주요 섹션 존재 여부
출력 예시
code
=== Pokemon Skill i18n Sync Report === Base: pokemon-green-ko Target: pokemon-green-en [파일 검사] ✓ data/pokemon/species.json - 양쪽 존재 ✓ data/moves/moves.json - 양쪽 존재 ✗ data/items/tm-hm.json - en에 누락 [구조 검사: species.json] ✓ 151개 포켓몬 키 일치 [구조 검사: moves.json] ✗ "swift.ef.type" - ko에만 존재 [SKILL.md 검사] ✓ 섹션 수 일치 (15개) Summary: 2 errors, 0 warnings
새 언어 추가
새 언어(예: 일본어)를 추가하려면:
- •기존 스킬 복사
bash
cp -r .claude/skills/pokemon-green-ko .claude/skills/pokemon-green-ja
- •데이터 파일 번역
- •
SKILL.md번역 - •
data/messages/battle.json번역 - •
data/pokemon/species.json의 이름 번역
- •싱크 검사 실행
bash
bash skills/pokemon-i18n-sync/scripts/validate-sync.sh ja
스크립트 목록
| 스크립트 | 용도 |
|---|---|
scripts/validate-sync.sh | 전체 구조 검증 |
scripts/compare-json-keys.sh | 두 JSON 파일 키 비교 |
scripts/diff-languages.sh | 언어 간 차이점 표시 |
주의사항
- •기준 언어: ko(한국어)를 기준으로 다른 언어와 비교
- •키만 비교: 값(번역 내용)은 비교하지 않음
- •자동 수정 없음: 리포트만 생성, 자동 수정은 하지 않음