pokemon-i18n-sync

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

---

새 언어 추가

새 언어(예: 일본어)를 추가하려면:

1. 기존 스킬 복사

cp -r .claude/skills/pokemon-green-ko .claude/skills/pokemon-green-ja

2. 데이터 파일 번역

• SKILL.md 번역
• data/messages/battle.json 번역
• data/pokemon/species.json의 이름 번역

3. 싱크 검사 실행

bash skills/pokemon-i18n-sync/scripts/validate-sync.sh ja

---

스크립트 목록

스크립트	용도
scripts/validate-sync.sh	전체 구조 검증
scripts/compare-json-keys.sh	두 JSON 파일 키 비교
scripts/diff-languages.sh	언어 간 차이점 표시

---

주의사항

1. 기준 언어: ko(한국어)를 기준으로 다른 언어와 비교
2. 키만 비교: 값(번역 내용)은 비교하지 않음
3. 자동 수정 없음: 리포트만 생성, 자동 수정은 하지 않음