Communitygithub.com

AcTePuKc/bg-game-translation-qa

Codex 스킬: 불가리아어 게임 현지화 QA

bg-game-translation-qa란 무엇인가요?

이 스킬은 불가리아어 게임 현지화 작업을 위한 전문 Codex 에이전트 지침입니다. 파일 형식을 유지하면서 사용자 대상 텍스트를 개선하는 데 중점을 둡니다. 주요 기능은 파일 구조, 플레이스홀더, 서식 태그를 보존하면서 번역 또는 편집을 수행하는 것입니다. 또한 불가리아어 현지화 스타일 가이드(자연스러운 표현, 문화적 적합성, 기술 용어 처리)와 QA 체크리스트(플레이스홀더 누락, 형식 태그 손상, 불일치 용어, 번역 과잉 등)를 제공합니다. 이 스킬은 `bg-text` 스킬과 함께 사용할 수 있지만, 게임 파일의 보호된 구조를 변경하지 않도록 주의해야 합니다.

지원 대상~Claude Code✓Codex CLI~Cursor
npx skills add AcTePuKc/bg-game-translation-qa

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

불가리아어 게임 현지화 QA

텍스트 개선만큼 파일 형식 유지가 중요한 불가리아어 게임 현지화 작업에 이 스킬을 사용하세요. 사용자가 명시적으로 전체 재작성을 요청하지 않는 한, 최소한의 안전한 변경을 수행하고 전체 파일 재작성보다는 집중된 패치를 선호하세요.

핵심 작업 흐름

  1. 편집 전에 파일 형식과 번역 가능한 필드를 식별하세요.
  2. 모든 구조, 순서, 구분 기호, 따옴표, 이스케이프, 주석, 키, ID 및 메타데이터를 보존하세요.
  3. 사용자 대상 텍스트만 번역 또는 편집하세요.
  4. 사용자가 명시적으로 변경을 요청하지 않는 한, 플레이스홀더, 서식 태그, 변수, 이스케이프 시퀀스 및 줄 바꿈을 정확히 보존하세요.
  5. 사용자가 제공하거나 프로젝트에 존재하는 프로젝트 용어집, 용어베이스, 스타일 가이드 또는 기존 번역 메모리를 따르세요.
  6. 불확실한 문자열은 추측하지 말고 별도로 보고하세요.
  7. 변경된 사항, 변경되지 않은 사항, 그리고 위험이나 질문 사항을 요약하세요.

번역 불가 콘텐츠

사용자가 명시적으로 플레이어 대상 텍스트로 표시하지 않는 한, 내부 식별자, 열거형 이름, 파일 이름, 파일 경로, 클래스 이름, 함수 이름, 객체 이름, 에셋 이름, 이벤트 이름, 콘솔 명령, 구성 키, ID 또는 기술 메타데이터를 번역하거나 정규화하지 마세요.

구조화된 파일의 경우 행 수, 키 순서, 중첩, 구분 기호 및 인코딩을 그대로 유지하세요. CSV/TSV 테이블의 경우 정확한 열 구조를 유지하세요. JSON/XML/INI/PO 스타일 파일의 경우 구문과 이스케이프를 유지하세요.

플레이스홀더 및 태그

플레이스홀더와 서식 태그를 대소문자, 구두점, 중첩, 간격 및 순서를 포함하여 바이트 단위로 보존하세요. 변수 내부의 텍스트가 명확히 플레이어 대상 표시 텍스트가 아닌 이상 번역하지 마세요.

항상 다음 패턴을 보호하세요:

  • {PLAYER}
  • {0}
  • %s
  • %d
  • <color=...>
  • </color>
  • <b>
  • </b>
  • \n
  • \t
  • [br]
  • [[...]]
  • $VARIABLE
  • ${variable}

작업에 익숙하지 않은 토큰, 리치 텍스트, UI 마크업, 스크립팅 구문 또는 형식별 플레이스홀더가 포함된 경우 references/placeholders.md를 참조하세요.

불가리아어 현지화 스타일

영어 어순을 문자 그대로 따르지 말고 자연스러운 불가리아어 표현을 사용하세요. 특히 버튼, 메뉴, 업적, 도구 설명 및 전투 메시지의 경우 UI 텍스트를 간결하고 읽기 쉽게 유지하세요.

가능하면 음역보다 문화적으로 적절한 불가리아어 번역을 선호하되, 기존 게임 용어 및 프로젝트 용어집 선택은 일관되게 유지하세요. 대화에서 캐릭터의 목소리를 유지하고 캐주얼하거나 유머러스한 말투를 지나치게 격식 있게 만들지 마세요.

화자나 플레이어의 성별을 알 수 없는 경우 불가리아어에서 중립적인 표현이 가능한 경우 강제로 성별을 표시하는 표현을 피하세요. 프로젝트 스타일에서 요구하지 않는 한, 영어 제목, 항목 이름 또는 UI 레이블에서 복사된 불필요한 대문자 사용을 피하세요.

기술 용어 및 차용어

소스에 표시된다고 해서 기술 용어를 기계적으로 번역하지 마세요. 먼저 내부 식별자인지, 확립된 전문 용어인지, 아니면 플레이어 대상 텍스트인지 확인하세요.

  • API 이름, 명령, 구성 키, 클래스 이름 및 기타 식별자는 변경하지 않고 유지하세요.
  • 플레이어 대상 텍스트의 경우 문자 그대로 차용하기보다는 해당 기능에 대한 자연스러운 불가리아어 설명을 선호하세요.
  • 소스가 기술적 역할을 정확히 명시하지 않은 경우 임의로 만들지 마세요. 중립적인 기능적 구문을 사용하거나 문자열을 불확실하다고 보고하세요.
  • 프로젝트 용어집에서 용어를 정의하는 경우 다른 불가리아어 옵션이 가능하더라도 용어집을 따르세요.

예시:

원천 용어플레이어 대상 텍스트기술적 설명가정하지 마세요
hookмеханизъм / точка за включванеобработчик / точка за разширяване모듈 또는 „кука“를 의미한다고 가정
compatibility hookмеханизъм за съвместимостобработчик за съвместимост 또는 точка за включване за съвместимостмодул, кука 또는 прихващач가 항상 올바르다고 가정
fixпоправка / корекцияпоправка за съвместимост속어 фикс가 대상에 적합하다고 가정
handler필요한 경우 해당 동작 설명обработчикхендлър로 음역되어야 한다고 가정

예를 들어, The journal level label was corrected through the compatibility hook.를 플레이어 대상 변경 로그의 경우 Надписът за нивото в дневника е коригиран чрез механизма за съвместимост.로 번역하세요. 기본적으로 кука за съвместимост를 사용하지 마세요.

반복 게임 용어

게임 메커니즘이나 UI 개념이 반복되는 경우, 첫 번째 명확한 발생 시점에 불가리아어 이름을 결정하고 프로젝트 용어집에 기록하세요. 영어에서 비슷하게 들린다는 이유만으로 관련 용어를 하나의 불가리아어 단어로 통합하지 마세요.

구별해야 할 원천 용어가능한 불가리아어 선택QA 위험
skill, ability, perk, trait, featумение, способност, привилегия, черта다른 진행 시스템이 구별 불가능해짐
buff, debuff, status effectположителен ефект, отрицателен ефект, ефект на състояние플레이어가 보너스와 상태를 구분할 수 없음
cooldown, charge, stackвреме за изчакване, заряд, натрупване타이밍, 리소스 및 누적 메커니즘이 혼동됨
loot, dropплячка, изпуснат предмет보상 풀이 이벤트나 적이 생성한 아이템과 혼동됨
spawn, despawn, triggerпоявяване, изчезване, задействане세계 이벤트와 상호 작용 조건이 모호해짐
crafting, recipe, blueprint, upgradeизработка, рецепта, чертеж, подобрение제작, 잠금 해제 및 업그레이드의 기계적 구분이 사라짐
save, load, save slotзапазване, зареждане, място за запазена игра동작, 저장된 게임 및 위치가 혼동됨

또한 support, state, patch, build, release 및 slot과 같은 문맥에 민감한 기술 단어를 검토하세요. 예를 들어 support는 съвместимост, поддръжка 또는 помощ를 의미할 수 있습니다. patch는 поправка, корекция 또는 обновление일 수 있습니다.

호칭 및 레지스터

플레이어 대상 게임 UI, 튜토리얼, 프롬프트, 목표 또는 일반 시스템 메시지에 대해 기본적으로 격식체 Вие / -те 표현을 사용하지 마세요. 프로젝트 용어집, 캐릭터 목소리, 설정 또는 소스 컨텍스트에서 격식체가 명확히 요구되지 않는 한, 비격식 단수형 ти / -ш 또는 자연스러운 중립적 구성을 선호하세요.

일치하지 않는 호칭/레지스터를 QA 문제로 표시하세요. 특히 영어 you가 게임에서 격식체 플레이어 호칭을 사용한다는 증거 없이 격식체 불가리아어로 번역된 경우에 그렇습니다.

예시:

  • You have to do this. -> 문맥에 따라 Трябва да направиш това. 또는 Това трябва да се направи. 선호
  • 일반 플레이어 대상 UI에서 기본적으로 Вие трябва да направите това. 사용 금지
  • 귀족, 공무원, 고객 서비스 유형 UI, 의도적으로 거리를 둔 내레이션 또는 Вие를 사용하는 확립된 스타일의 프로젝트에는 격식체 유지

번역 과잉

기술적으로는 번역되었지만 불가리아어 UI 텍스트에 불필요한 부담을 추가하는 소스 구문을 표시하세요. 자동 수정이 아닌 수동 검토를 위한 QA 경고로 처리하세요.

가능한 번역 과잉에 대해 심각도 low 및 조치 manual review를 사용하세요. 실제 게임플레이, 공간, 대상 지정, 타이밍 또는 기계적 정보를 전달하는 구문은 유지하세요.

일반적인 예시:

  • shoot, fire, throw 또는 launch와 같은 동사 뒤의 through the air
    • shoots arrows through the air -> изстрелва стрели
    • 공중 이동이 기계적으로 관련이 없는 한 изстрелва стрели във въздуха와 같은 지나치게 문자 그대로의 변형 표시
  • 불가리아어 문장에서 이미 근접성이 암시된 경우 nearby
    • when enemies are nearby -> когато има врагове наблизо
    • when senses lifeforms nearby -> когато усети живи същества наблизо
    • 탐지 범위, 대상 지정, 트리거 범위 또는 위치를 정의하는 경우 наблизо 유지
  • 이미 부서짐을 암시하는 동사 뒤의 into pieces / apart
    • smashing things apart -> разбиване на неща
    • 조각/파편이 중요한 경우가 아니라면 разбиване на неща на парчета와 같은 강제된 표현 피함
  • on the ground, in front of you, with your hands 또는 by hand (불가리아어 동사나 문맥이 이미 정보를 암시하는 경우)
    • 실제 위치, 입력, 제작 또는 상호 작용 제약 조건을 전달하는 경우 유지

실용적인 불가리아어 스타일 지침은 references/bg-text.md를 참조하고, 프로젝트 용어집을 만들거나 확장할 때는 references/glossary-template.md를 참조하세요.

bg-text와의 관계

bg-text 스킬을 사용할 수 있거나 사용자가 사용을 요청한 경우, 불가리아어 타이포그래피, 명확성, 구두점, 문법 및 일반 편집 품질에 대한 참고 자료로 사용하세요. 먼저 이 스킬의 게임 현지화 제약 조건을 적용하세요. 타이포그래피나 스타일 정리가 보호된 구조, 키, ID, 플레이스홀더, 태그, 이스케이프 시퀀스, 줄 바꿈 또는 프로젝트 용어를 변경하지 않도록 하세요.

게임 파일의 경우 bg-text를 언어 품질 지침으로 취급하고, 전체 파일을 재작성하거나 엔진별 구문을 정규화할 수 있는 권한으로 간주하지 마세요.

QA 체크리스트

최종 출력 전에 다음을 확인하세요:

  • 손상되거나, 변경되거나, 재정렬되거나, 누락된 플레이스홀더
  • 누락되었거나, 잘못 구성되었거나, 균형이 맞지 않는 서식 태그
  • 변경된 키, ID, 파일 이름, 경로 또는 메타데이터
  • 누락된 행 또는 변경된 테이블 모양
  • 중복 ID 도입 또는 누락
  • 번역된 필드의 번역되지 않은 영어
  • 우크라이나어 잔재
  • 러시아어 잔재
  • 불일치 용어집 용어
  • 기계적으로 또는 불일치하게 번역된 기술 용어
  • 용어집 결정 없이 하나의 용어로 통합된 관련 게임 메커니즘
  • 지나치게 문자 그대로의 불가리아어
  • 일치하지 않는 격식/비격식 호칭, 특히 플레이어 대상 UI에서 불필요한 Вие
  • 수동 검토가 필요한 가능한 번역 과잉/문자 그대로의 구문
  • 해당 컨트롤에 비해 분명히 너무 긴 UI 텍스트

실용적인 최종 검토 과정은 references/qa-checklist.md를 참조하세요.

출력 기대 사항

패치 스타일의 변경과 집중된 수정을 선호하세요. 의미 있는 번역 또는 QA 변경 사항을 간략히 설명하세요. 불확실한 문자열은 키/ID 또는 위치, 문제 및 가장 안전한 제안 처리 방법과 함께 별도로 나열하세요.

파일이 큰 경우 용어 표류를 피하기 위해 충분한 주변 컨텍스트를 검사한 다음 요청된 범위만 편집하세요. 요청된 변경이 구조나 플레이스홀더를 손상시킬 위험이 있는 경우 중단하고 설명을 요청하세요.

관련 스킬