majiayu000 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 skills/pokemon-i18n-sync/scripts/validate-sync.sh
수동 키 비교 (jq)
# 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
- 섹션 수 일치 여부
- 주요 섹션 존재 여부
출력 예시
=== 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
새 언어 추가
새 언어(예: 일본어)를 추가하려면:
- 기존 스킬 복사
cp -r .claude/skills/pokemon-green-ko .claude/skills/pokemon-green-ja
- 데이터 파일 번역
SKILL.md번역data/messages/battle.json번역data/pokemon/species.json의 이름 번역
- 싱크 검사 실행
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(한국어)를 기준으로 다른 언어와 비교
- 키만 비교: 값(번역 내용)은 비교하지 않음
- 자동 수정 없음: 리포트만 생성, 자동 수정은 하지 않음