i18n 정합성 관리 (i18n-parity)
대시보드 UI 키·위키·미러 README·언어 스위처·로케일 포맷팅 등 5개 현지화 표면을 한 PR 안에서 모두 동일하게 유지하도록 강제하는 저장소 전용 규칙 스킬.
개발·코딩고급★ 979⑂ 229AI 점수 7/10마지막 업데이트: 2026. 9. 6.
무엇을 해주나
- 이 저장소의 현지화가 이루어지는 5개 표면(①
client/src/i18n/locales/*UI 키, ②wiki/index.html+wiki/script.js+wiki/i18n-content.js, ③README-CN/VN/KO/ES.md미러, ④ 언어 스위처 UI, ⑤format.ts로케일 포맷)을 표로 정리하고, 각 표면의 영어 원본·번역 위치·자동 검증 테스트를 명시합니다. - "영어가 항상 원본이며, 모든 지원 언어가 같은 PR에 포함되기 전까지는 완료가 아니다"라는 불변 규칙을 세우고, 변경 유형별(키 추가 / 네임스페이스 추가 / 위키 문구 추가 / README 수정 / 카운트 변경)로 반드시 함께 처리할 작업을 매핑합니다.
- 새 언어 추가 시에는 체크리스트 문서를 따라가게 하고, 흔한 실패 3가지(README 미러 축약, 영어 그대로 복사한 키, 헤딩만 번역된 위키)를 미리 경고합니다.
- 번역하지 말아야 할 것(코드, 경로, 환경변수, 훅 이벤트명,
Agent같은 툴 이름)과 반대로 번역 대상인 UI 명사를 구분해 줍니다. - 마지막에
i18n-audit.sh,npm run test:client, 위키 DOM 테스트,npm run test:server,npm run format순서의 검증 명령을 제공합니다.
이런 분께 추천
- Claude-Code-Agent-Monitor 저장소에 기여하며 UI 문구·README·위키를 건드리는 개발자
- 다국어 표면이 여러 개로 흩어진 프로젝트에서 "반쯤 번역된 상태"를 구조적으로 막는 규칙 설계 사례가 필요한 사람
- 새 언어 로케일을 추가하는 작업을 기계적으로 빠짐없이 수행하고 싶은 기여자
활용 예시
- 대시보드에 새 버튼 라벨을 추가했다 →
en네임스페이스에만 키를 넣지 않고zh/vi/ko/es까지 동일 키 경로·동일{{보간}}토큰으로 추가한 뒤npm run test:client로 확인. README.md의 설치 섹션을 고쳤다 → 같은 위치를README-CN.md,README-VN.md,README-KO.md,README-ES.md네 개 모두에 반영하고i18n-audit.sh로 헤딩 수·상호 링크 검증.- 위키에 새 단락을 넣었다 → 스캔 레이어는
T, 본문 산문은wiki/i18n-content.js, 속성은ATTRIBUTE_TRANSLATIONS에 넣고wiki/sw.js의CACHE_NAME과?v=쿼리를 함께 올려 캐시된 구버전이 노출되지 않게 함.
· · · 설치 가이드 · · ·
설치 없이 지금 한 번 써보기
아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.
이 파일의 지시를 읽고 그대로 따라서 나를 도와줘: https://raw.githubusercontent.com/hoangsonww/Claude-Code-Agent-Monitor/HEAD/.agents/skills/i18n-parity/SKILL.md 내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)
Claude가 링크를 열지 못하면, 링크를 직접 열어 내용을 복사해 붙여넣으세요.
↓ 쓸 만하면 아래에서 ZIP을 받아 설치하세요. 그러면 매번 붙여넣지 않아도 알아서 작동합니다.
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 hoangsonww/Claude-Code-Agent-Monitor 의 .agents/skills/i18n-parity 폴더를 내 ~/.claude/skills/i18n-parity/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/hoangsonww/Claude-Code-Agent-Monitor.git && mkdir -p ~/.claude/skills && cp -r Claude-Code-Agent-Monitor/.agents/skills/i18n-parity ~/.claude/skills/⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 터미널을 열고 스킬이 들어 있는 저장소를 내려받습니다:
git clone https://github.com/hoangsonww/Claude-Code-Agent-Monitor.git - 개인 스킬 폴더를 준비합니다:
mkdir -p ~/.claude/skills - 스킬 디렉터리를 복사합니다:
cp -r Claude-Code-Agent-Monitor/.agents/skills/i18n-parity ~/.claude/skills/ - 함께 참조되는
references/new-language-checklist.md,references/translation-style.md파일이 복사되었는지 확인합니다(없으면 저장소의.claude/skills/i18n-parity/에서 가져오세요). - 이 스킬은 저장소 내부 경로와
scripts/i18n-audit.sh에 의존하므로, 실제로 활용하려면 해당 저장소 안에서 Claude Code를 실행하는 것이 좋습니다. - Claude Code를 재시작한 뒤 "UI 문구를 추가했는데 i18n 정합성을 확인해줘"처럼 요청하면 스킬이 발동합니다.
GitHub에서 원본 보기 ↗라이선스: MIT