ko-en-translator

Korean↔English Translator

한국어↔영어 양방향 번역 전문 스킬. 기술 문서에 특화되어 있으며, 맥락을 이해하고 자연스러운 번역을 제공합니다.

번역 방향 자동 감지

입력 텍스트의 언어를 자동 감지하여 반대 언어로 번역합니다.

• 한국어 입력 → 영어 출력
• 영어 입력 → 한국어 출력
• 혼합 입력 → 사용자에게 방향 확인

번역 모드

Mode 1: 텍스트 번역 (기본)

일반 텍스트, 이메일, 메시지 등을 번역합니다.

규칙:

• 의역 우선: 직역보다 자연스러운 표현을 선택
• 문화적 맥락 반영: 한국어 존댓말 ↔ 영어 톤 매칭
• 원문의 뉘앙스와 감정을 보존

존댓말 ↔ 영어 톤 매핑:

한국어 화체	영어 톤	사용 상황
합쇼체 (-습니다)	Formal	공식 문서, 비즈니스 이메일
해요체 (-요)	Professional	일반 업무, 기술 문서
해체 (-해, -야)	Casual	채팅, 비공식 커뮤니케이션
하십시오체	Very Formal	법률, 공지사항

Mode 2: 기술 문서 번역

README, API 문서, 기술 블로그, PR 설명 등을 번역합니다.

규칙:

• 기술 용어는 원어 유지 또는 괄호 병기: "의존성 주입(Dependency Injection)"
• 코드 블록, 명령어, 파일 경로는 번역하지 않음
• 마크다운 서식 보존
• 기술 용어 사전 참조: references/tech-glossary.md

한→영 기술 문서 규칙:

• 주어 명시 (한국어는 주어 생략이 잦음)
• 능동태 우선
• "~를 합니다" → 직접적 서술 ("This function returns..." not "This function does the returning of...")

영→한 기술 문서 규칙:

• 과도한 존칭 지양: "~하겠습니다" 대신 "~합니다"
• 영어 원어를 처음 등장 시 병기: "컴포넌트(Component)"
• 불필요한 번역 금지: API, SDK, CLI, URL, JSON 등은 그대로 유지

Mode 3: 코드 주석 번역

소스 코드의 주석, docstring, JSDoc 등을 번역합니다.

규칙:

• 코드는 절대 수정하지 않음 — 주석만 번역
• 변수명, 함수명, 클래스명은 번역하지 않음
• TODO, FIXME, HACK 등 태그는 유지
• 타입 정보, 파라미터 설명의 기술 용어는 원어 유지

예시 (한→영):

// 사용자 인증 토큰을 검증합니다
// @param token - JWT 토큰 문자열
// @returns 유효한 경우 사용자 정보 반환

→

// Validates the user authentication token
// @param token - JWT token string
// @returns User info if valid

Mode 4: i18n 파일 번역

JSON, YAML, Properties 등 국제화 리소스 파일을 번역합니다.

규칙:

• 키(key)는 절대 수정하지 않음
• 플레이스홀더 보존: {name}, {{count}}, %s, %d 등
• 복수형 규칙 적용 (영어: one/other, 한국어: 복수형 불필요)
• ICU MessageFormat 구문 보존
• 문맥에 맞는 UI 용어 사용 (버튼, 라벨 등은 간결하게)

예시 (영→한):

{
  "welcome": "Welcome, {name}!",
  "items_count": "{count, plural, one {# item} other {# items}}",
  "save": "Save",
  "cancel": "Cancel"
}

→

{
  "welcome": "{name}님, 환영합니다!",
  "items_count": "{count}개 항목",
  "save": "저장",
  "cancel": "취소"
}