OpenParable
Skip to content
← Back to skills

Add Translation

Development
add-translation

Add Translation is an Agent Skill for development published in the pinpoint-apm/pinpoint repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

영어와 한국어 로케일 파일 모두에 i18n 번역 키를 추가합니다. 사용자 노출 문자열을 추가하거나, 번역 키가 누락되었거나, 새 UI 텍스트를 국제화할 때 반드시 이 스킬을 사용하세요.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/pinpoint-apm/pinpoint/blob/HEAD/web-frontend/src/main/v3/.claude/skills/add-translation/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/add-translation, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

번역 키 추가

영어 텍스트 $1과 한국어 텍스트 $2를 가진 번역 키 $0을 추가합니다.

단계

  1. packages/ui/src/constants/locales/en.json 읽기
  2. packages/ui/src/constants/locales/ko.json 읽기
  3. 키 접두사를 기반으로 올바른 섹션 결정 (COMMON, SERVER_MAP, TRANSACTION 등)
  4. 올바른 섹션의 두 파일 모두에 키 추가, 섹션 내 알파벳 순서 유지
  5. 한국어 텍스트가 제공되지 않은 경우, 나중에 쉽게 찾아 바꿀 수 있도록 [TODO] 접두사를 붙인 영어 텍스트를 플레이스홀더로 추가 (예: "[TODO] English text")

키 네이밍

  • 점으로 구분된 섹션을 사용하는 SCREAMING_SNAKE_CASE
  • 예시: COMMON.SAVE, SERVER_MAP.NODE_COUNT, ERROR_ANALYSIS.CHART_TITLE

가이드라인

  • 항상 en.json과 ko.json을 동시에 업데이트
  • 한국어 번역은 직역 금지, 자연스러운 한국어로 작성
  • 동적 값은 이중 중괄호로 보간: "Hello, {{name}}!" / "안녕하세요, {{name}}님!"
  • 복수형에는 i18next 복수 접미사 사용: _one, _other