| 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 3550자 ≈ 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 원칙 위배)
