omd-locale-adapter - SKILL.md Agent Skill

name: omd:locale-adapter description: "한국어 본문을 EN/JP/ZH-TW로 번역이 아닌 adaptation. 문화 레퍼런스 swap, JP honorific 정합, ZH-TW 번체 idiom. KR은 항상 source of truth. '다국어 적용', 'EN 버전 만들어줘', 'JP로 옮겨줘' 류 트리거." user-invocable: true

omd:locale-adapter

KR 본문을 받아 EN/JP/ZH-TW로 adapt한다. 직역이 아니라 각 문화의 디자인 블로그 voice로 다시 쓴다.

참조: Frontitude brand-voice translation model, LINE localization playbook.

0. Source of truth

KR이 canonical. EN/JP/ZH-TW는 derivative. KR이 갱신되면 다른 locale도 무효화.

1. 대상 locale별 룰

1.1 EN (en)

Voice baseline: Stripe Press / Linear changelog / Vercel blog
문장 길이: 15~~25 words (KR 35~~50자 ≈ EN 15~25 words)
1인칭: "we" or "I" 자연스럽게
문화 swap:
- "토스" → "Toss (Korea's leading fintech)" (첫 출현만)
- "당근" → "Karrot (a hyperlocal Korean marketplace)"
- 김치/돌잔치 등 강한 KR-only ref → 영미권 equivalent or 짧은 gloss
- "안녕하세요" 인사 → "Hi, I'm [name]." 또는 informal opener
분량: KR 자수의 0.45~0.55 (영어가 짧음)
헤더: KR 짧은 헤더 → EN은 좀 더 descriptive OK ("토스 느낌의 시작" → "What gives Toss its 'feel'")

1.2 JP (ja)

Voice baseline: note.com デザインカテゴリ, クックパッド開発者ブログ
종결: です・ます 일관 (敬体)
격식 register: 영미보다 한 단계 더 정중
문화 swap:
- "토스" → "Toss (韓国最大級のフィンテック)"
- 한국 특유의 이웃문화 ref → 일본식 「ご近所」 비유
- 존경어/겸양어 자연스럽게 ("저는 ~한다고 생각해요" → "私は〜と考えています")
분량: KR 자수의 0.85~1.0
헤더: 한국어 짧은 헤더와 비슷한 호흡 ("토스 느낌の始まり")
한자: 常用漢字 위주. 어려운 한자는 仮名 병기.

1.3 ZH-TW (zh-tw)

Voice baseline: 數位時代, INSIDE 硬塞網
번체 (簡体 금지). 「設計」「顯示」「優化」.
문화 swap:
- "토스" → "Toss (南韓金融科技龍頭)"
- "당근" → "Karrot (南韓地區型二手交易平台)"
- 한국 idiom → 中華圈 idiom (가능한 경우)
분량: KR 자수의 0.6~0.75
인용부호: 「」 사용
헤더: KR 짧은 헤더와 비슷한 호흡 (「Toss 給人的感覺，從何而來」)

2. Adaptation 7단계 절차

KR canonical 본문 + 출간된 frontmatter 읽기
글 전체 thesis 한 줄로 추출 (locale 다 동일해야 함)
각 H2 섹션을 1개씩 옮김 — 문장 단위 직역 금지, 단락 단위 의역
문화 ref 발견 시 위 swap 룰 적용 + 첫 출현에 gloss
인용/코드/URL/figure src는 그대로 보존
헤더 number 일관성 유지 (KR=5 H2면 다른 locale도 5)
frontmatter title_<locale>, subtitle_<locale> 채우기

3. 보존 (절대 변경 금지)

코드 블록 내부 (변수명, 함수명, 주석 영문 유지)
URL, 파일 경로
사람 이름 / 회사명 (단, 첫 출현에 gloss는 OK)
figure src
frontmatter slug
수치 / 통계

4. 비전형 케이스

원문	대응
KR 특유의 이모지 사용 패턴 (`ㅎㅎ`, `^^`)	EN/JP/ZH-TW에서 제거. 톤은 다른 방식으로 표현.
한자어 농담	locale 등가 농담 없으면 그냥 의미만 유지하고 농담 톤 표시
`안녕하세요` 같은 의례 인사	EN은 informal greeting, JP는 「こんにちは」, ZH-TW는 「大家好」
Toss/당근 같은 회사명 인지도 차이	첫 등장에서 1줄 gloss, 이후 그대로

5. 출력 형식

content/posts/<slug>/index.ko.md    ← source
content/posts/<slug>/index.en.md    ← this skill 생성
content/posts/<slug>/index.ja.md
content/posts/<slug>/index.zh-tw.md

각 파일 frontmatter에:

locale: en
source_locale: ko
source_revision: <git sha of ko at time of adaptation>
adapted_at: <ISO date>

6. 품질 체크 (self-audit)

각 locale 생성 후 writer가 직접 검증:

H2 카운트가 KR과 일치
인용 / 통계 누락 0건
figure src 경로 일치
분량이 위 1.x의 비율 범위
첫 출현 회사명 모두 gloss 처리됨
코드 블록 변경 0건

미달 시 동일 locale 재작성 (orchestrator round 카운터 증가).

7. KR 갱신 시 staleness

KR이 수정되면 EN/JP/ZH-TW의 source_revision이 outdated. orchestrator가 다시 호출. 부분 갱신 가능 (수정된 H2 섹션만 re-adapt).

8. Anti-patterns

❌ Google Translate 톤 — 직역 흔적
❌ KR-only ref를 그대로 둠 (예: "강남에서 일하는데" → 영어판에 그대로)
❌ 분량 mismatch (EN이 KR과 같은 자수)
❌ 헤더 number 불일치
❌ KR 없이 EN을 먼저 작성 (KR=canonical 원칙 위배)