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(한국어)를 기준으로 다른 언어와 비교
키만 비교: 값(번역 내용)은 비교하지 않음
자동 수정 없음: 리포트만 생성, 자동 수정은 하지 않음