블로그 번역, SEO 최적화 블로그 번역은(는) 무엇을 하나요?
기존 블로그 게시글을 하나 이상의 대상 언어로 번역합니다. 일반 번역과 달리, 이 스킬은 SEO 최적화되어 출판 가능한 콘텐츠를 생성하며, 현지화된 키워드, 메타 태그, 문화적으로 올바른 형식을 제공합니다.
주요 참조
필요 시 로드:
references/translation-rules.md, 형식 보존, 로캘별 숫자/날짜/통화 형식, 인용 처리, 품질 기준.references/cultural-adaptation.md, 로캘별 문화 프로필 (DACH, 프랑스어권, 히스패닉, 일본어, 사용자 정의). 이 파일은blog-localize와 공유됩니다 (중복 금지).
워크플로우
1단계: 입력 파싱
- 소스 파일 (마크다운, MDX, 또는 HTML)을 읽습니다.
- 소스 언어를 자동 감지합니다. 우선 순위:
- 프론트매터
lang필드. - HTML
lang속성. - 콘텐츠 분석 (스크립트, 일반적인 불용어).
- 프론트매터
--to에서 대상 언어를 쉼표로 구분된 ISO 639-1 코드 (de,fr,es,ja,pt-BR)로 파싱합니다.--to가 없으면 사용자에게 한 번 질문합니다: "어떤 언어로 번역할까요? ISO 639-1 코드를 입력하세요 (예: de, fr, es, ja, pt-BR)."- 각 코드의 유효성을 검증합니다. 잘못된 코드는 제안과 함께 거부합니다 (
jp는 "일본어를 의미하는ja를 의도하셨나요?"). 대상 언어가 소스 언어와 같으면 알림과 함께 건너뜁니다.
2단계: 콘텐츠 분석
번역 가능한 표면을 추출합니다:
- 프론트매터:
title,description,tags,author(번역 가능한 경우에만, 예: 역할 레이블, 이름 제외). - 모든 제목 (H1, H2, H3).
- 본문 단락.
- 이미지
alt텍스트 및<figcaption>콘텐츠. - 차트
<text>및<tspan>콘텐츠; 모든 SVG 속성 (x,y,font-size,fill,transform)을 보존. - FAQ 질문과 답변.
- 인용 캡슐 텍스트.
- 주요 요점 또는 요약 상자.
- CTA 텍스트.
- 내부 링크 영역 앵커 텍스트.
변경 없이 보존:
- 마크다운 및 HTML 구조, 태그, 속성.
- 이미지 URL, 링크 URL, 프론트매터 키.
- 코드 블록 (의미 있는 경우에만 인라인 주석 번역).
- 내부 링크 영역 마커 (
[INTERNAL-LINK: ...]). - 인용 내 소스 조직 이름 (Gartner, McKinsey 등).
- 사람 이름.
- 스키마 JSON-LD 블록 (사용자 대상 문자열 값만 번역).
3단계를 위해 기본 및 보조 키워드를 식별합니다.
3단계: 키워드 현지화
각 대상 언어에 대해:
- 소스 키워드가 대상 시장에서 정립된 용어인지 결정합니다. 그렇다면 (예: "Content Marketing"이 독일어로 유지), 그대로 둡니다.
- 로컬 동의어가 실제 검색 동작을 보이는 경우, 해당 동의어로 교체합니다.
- 보조 키워드에도 동일한 로직을 적용합니다.
- 매핑을 기록합니다. 번역 에이전트는 이를 사용하여 제목, 메타 설명, H2 제목을 일관되게 업데이트합니다.
4단계: 번역
각 대상 언어에 대해 blog-translator 에이전트 (Task를 통해)를 생성합니다:
- 소스 콘텐츠.
- 3단계의 키워드 현지화 맵.
- 대상 언어 코드.
- 대상 로캘에 대한
references/translation-rules.md및references/cultural-adaptation.md의 문화 프로필이 있는 경우 포인터.
여러 언어로 번역할 때 에이전트를 병렬로 실행합니다.
에이전트는 입력과 동일한 형식으로 완전히 번역된 게시글을 반환합니다.
5단계: 후처리
각 번역 버전에 대해:
- 로캘 프론트매터를 추가하거나 업데이트합니다:
lang: "de" translatedFrom: "en" translatedDate: "YYYY-MM-DD" slug: "wie-man-ki-slop-vermeidet" - 구조적 무결성 확인:
- 원본과 동일한 수의 H2 및 H3 섹션.
- 모든 이미지가 번역된 alt 텍스트와 함께 존재.
- 모든 SVG 차트가 번역된 텍스트 레이블과 함께 존재 (길이 조정: 독일어 +30%, 프랑스어 +15%, 일본어 -20%, 기타는
references/translation-rules.md참조). - FAQ 개수 일치.
- 각 H2에 인용 캡슐 존재.
- 번역된 파일 저장:
translations/ {lang}/{localized-slug}.{ext}blog-multilingual에서 호출된 경우, 대신multilingual/{lang}/{localized-slug}.{ext}에 저장합니다.
6단계: 번역 품질 보호 장치
완료 보고 전에 출력에서 기계 번역 흔적을 스캔합니다:
- 문자 그대로의 관용구 (영어 관용구가 적응되지 않고 음역됨).
- 부자연스러운 어순 (SOV가 비-SVO 언어로 SVO로 번역되거나 그 반대).
- 혼합 언어 문장 (정착된 외래어 제외).
- 여전히 소스 형식의 숫자, 날짜 또는 통화 문자열.
- 여전히 소스 언어의 프론트매터 문자열.
모든 문제를 인라인으로 플래그합니다 (파일 경로, 줄 번호, 수정 제안). 번역 에이전트는 전달 전에 플래그된 모든 구절을 재처리해야 합니다.
7단계: 전달
## 번역 완료: [원본 제목]
### 소스
- 언어: [source]
- 파일: [source path]
### 번역
| 언어 | 파일 | 적응된 키워드 | 상태 |
|------|------|----------------|-------|
| de | translations/de/{slug}.md | [N] | 성공 |
| fr | translations/fr/{slug}.md | [N] | 성공 |
### 품질 검사
- 구조적 무결성: 언어별 통과/실패
- 메타 태그 현지화: 언어별 통과/실패
- 숫자, 날짜, 통화 로캘별 형식: 통과/실패
- 키워드 현지화: [N] 개 키워드 적응
- 기계 번역 흔적 플래그: [N] 개 (위의 참고 사항 참조)
### 다음 단계
- 문화적 심층 적응을 위해 `/blog localize <file> --locale <code>` 실행.
- 완전성 확인을 위해 `/blog locale-audit translations/` 실행.
- 쓰기, 번역, 현지화, hreflang을 하나의 명령으로 결합하려면 `/blog multilingual` 사용.
오류 처리
| 시나리오 | 조치 |
|---|---|
| 지원되지 않는 언어 코드 | 올바른 ISO 639-1 코드 제안 |
| 소스가 대상과 동일 | "소스가 이미 [lang]입니다"와 함께 건너뜀 |
| 파일을 찾을 수 없음 | 제안된 경로와 함께 오류 보고 |
| 번역 에이전트 시간 초과 | 한 번 재시도 후 부분 결과 보고 |
| 바이너리 또는 비텍스트 파일 | 오류 보고, 올바른 파일 제안 |
상호 참조
- 다음 단계 (문화적 심층):
/blog localize <file> --locale <code> - 모든 언어 버전 QA 검사:
/blog locale-audit <directory> - 원클릭 파이프라인:
/blog multilingual <topic> --languages <codes>