i18n 및 현지화
개요
이 공개 수용 사본은 https://github.com/sickn33/antigravity-awesome-skills의 plugins/antigravity-awesome-skills-claude/skills/i18n-localization 패키지를 Omni Skills 편집 형식으로 감싸되 원본 출처를 숨기지 않습니다.
운영자가 업스트림 워크플로, 지원 파일 및 저장소 컨텍스트를 그대로 유지하면서 공개 검증기와 비공개 개선기가 정상적인 다운스트림 흐름을 계속할 수 있도록 할 때 사용합니다.
이 수용 사본은 복사된 업스트림 파일을 그대로 유지하며, metadata.json의 external_source 블록과 ORIGIN.md를 검토를 위한 출처 앵커로 사용합니다.
i18n 및 현지화 > 국제화(i18n) 및 현지화(L10n) 모범 사례. ---
공개 제목에 깔끔하게 매핑되지 않은 가져온 소스 섹션은 아래 또는 지원 파일에 보존됩니다. 주요 가져온 섹션: 1. 핵심 개념, 3. 구현 패턴, 4. 파일 구조, 6. 일반적인 문제, 7. RTL 지원, 8. 체크리스트.
이 스킬을 사용해야 할 때
이 섹션을 트리거 필터로 사용하세요. 운영자가 파일을 로드하거나, 명령을 실행하거나, 풀 리퀘스트를 열기 전에 활성화 경계를 명확히 해야 합니다.
- 프로젝트 유형 - i18n 필요?
- 공개 웹 앱 - ✅ 예
- SaaS 제품 - ✅ 예
- 내부 도구 - ⚠️ 가능성 있음
- 단일 지역 앱 - ⚠️ 향후 고려
- 개인 프로젝트 - ❌ 선택 사항
운영 테이블
| 상황 | 시작 위치 | 중요성 |
|---|---|---|
| 첫 사용 | metadata.json | 복사된 워크플로를 건드리기 전에 external_source 블록을 통해 저장소, 브랜치, 커밋 및 가져온 경로를 확인합니다 |
| 출처 검토 | ORIGIN.md | 검토자에게 가져온 소스에 대한 일반 언어 감사 추적을 제공합니다 |
| 워크플로 실행 | scripts/i18n_checker.py | 실행을 실질적으로 변경하는 가장 작은 복사된 파일부터 시작합니다 |
| 지원 컨텍스트 | scripts/i18n_checker.py | 전체 패키지를 로드하지 않고 다음으로 가장 관련성 높은 복사된 소스 파일을 추가합니다 |
| 인계 결정 | ## 관련 스킬 | 작업이 변경될 때 운영자가 더 강력한 네이티브 스킬로 전환하도록 돕습니다 |
워크플로
이 워크플로는 의도적으로 편집적이면서도 운영적입니다. 가져온 소스가 운영자에게 유용하게 유지되면서도 다운스트림 개선기 흐름을 공급하는 공개 수용 표준을 충족시킵니다.
- 사용자 목표, 가져온 워크플로의 범위 및 이 스킬이 여전히 작업에 적합한 라우터인지 확인합니다.
- 복사된 업스트림 지원 파일을 로드하기 전에 개요 및 출처 파일을 읽습니다.
- 현재 요청의 결과를 실질적으로 변경하는 참조, 예제, 프롬프트 또는 스크립트만 로드합니다.
- 작업 노트에서 출처와 소스 경계를 명시적으로 유지하면서 업스트림 워크플로를 실행합니다.
- 업스트림 기대치와 복사된 파일에서 가리킬 수 있는 증거를 기준으로 결과를 검증합니다.
- 작업이 가져온 워크플로의 중심 범위를 벗어나면 관련 스킬로 에스컬레이션하거나 인계합니다.
- 병합 또는 종료 전에 무엇을 사용했는지, 무엇이 변경되었는지, 검토자가 여전히 확인해야 할 사항을 기록합니다.
가져온 워크플로 노트
가져옴: 1. 핵심 개념
| 용어 | 의미 |
|---|---|
| i18n | 국제화 - 앱을 번역 가능하게 만드는 과정 |
| L10n | 현지화 - 실제 번역 작업 |
| 로케일 | 언어 + 지역 (en-US, tr-TR) |
| RTL | 오른쪽에서 왼쪽 언어 (아랍어, 히브리어) |
예제
예제 1: 업스트림 워크플로 직접 요청
@i18n-localization을 사용하여 <작업>을 처리하세요. 복사된 업스트림 워크플로부터 시작하고, 결과를 변경하는 파일만 로드하며, 답변에서 출처를 계속 표시하세요.
설명: 운영자가 가져온 워크플로는 필요하지만 전체 저장소는 필요하지 않을 때 가장 안전한 시작점입니다.
예제 2: 출처 기반 검토 요청
@i18n-localization을 metadata.json 및 ORIGIN.md와 대조하여 검토한 후, 어떤 복사된 업스트림 파일을 먼저 로드할지와 그 이유를 설명하세요.
설명: 출처와 파일 선택에 대한 정확하고 감사 가능한 설명이 필요할 때 검토 또는 문제 해결 전에 사용합니다.
예제 3: 실행 전 복사된 지원 파일 범위 좁히기
@i18n-localization을 사용하여 <작업>을 처리하세요. 결과를 변경하는 복사된 참조, 예제 또는 스크립트만 로드하고, 진행하기 전에 파일 이름을 명시적으로 지정하세요.
설명: 기본적으로 전체 복사된 패키지를 로드하는 대신 점진적 공개에 맞춰 스킬을 유지합니다.
예제 4: 검토자 패키지 구축
@i18n-localization을 복사된 업스트림 파일과 출처를 사용하여 검토한 후, 병합 전에 발생한 차이점을 요약하세요.
설명: PR이 인간 검토를 기다리고 있고 반복 가능한 감사 패키지를 원할 때 유용합니다.
모범 사례
생성된 공개 스킬을 업스트림 저장소 주변의 검토 가능한 패키징 레이어로 취급하세요. 목표는 출처를 명시적으로 유지하고 실행을 실질적으로 개선하는 복사된 소스 자료만 로드하는 것입니다.
- 번역 키 사용, 원시 텍스트 사용 금지
- 기능별로 번역 네임스페이스 지정
- 복수형 지원
- 로케일별 날짜/숫자 형식 처리
- 처음부터 RTL 계획
- 복잡한 문자열에는 ICU 메시지 형식 사용
- 컴포넌트에서 문자열 하드코딩
가져온 운영 노트
가져옴: 5. 모범 사례
해야 할 일 ✅
- 번역 키 사용, 원시 텍스트 사용 금지
- 기능별로 번역 네임스페이스 지정
- 복수형 지원
- 로케일별 날짜/숫자 형식 처리
- 처음부터 RTL 계획
- 복잡한 문자열에는 ICU 메시지 형식 사용
하지 말아야 할 일 ❌
- 컴포넌트에서 문자열 하드코딩
- 번역된 문자열 연결
- 텍스트 길이 가정 (독일어는 30% 더 김)
- RTL 레이아웃 잊기
- 같은 파일에 언어 혼합
문제 해결
문제: 운영자가 가져온 컨텍스트를 건너뛰고 너무 일반적으로 답변함
증상: 결과가 plugins/antigravity-awesome-skills-claude/skills/i18n-localization의 업스트림 워크플로를 무시하고, 출처를 언급하지 않거나 복사된 소스 파일을 전혀 사용하지 않습니다.
해결 방법: metadata.json, ORIGIN.md 및 가장 관련성 높은 복사된 업스트림 파일을 다시 엽니다. 먼저 external_source 블록을 확인한 후, 계속하기 전에 출처를 다시 명시합니다.
문제: 검토 중 가져온 워크플로가 불완전하게 느껴짐
증상: 검토자는 생성된 SKILL.md를 볼 수 있지만 현재 작업에 어떤 참조, 예제 또는 스크립트가 중요한지 빠르게 알 수 없습니다.
해결 방법: 자신이 선택한 경로를 정당화하는 정확한 복사된 참조, 예제, 스크립트 또는 자산을 가리킵니다. 차이가 여전히 존재하면 PR에 숨기지 말고 기록합니다.
문제: 작업이 다른 전문 분야로 표류함
증상: 가져온 스킬이 올바른 위치에서 시작했지만 작업이 디버깅, 아키텍처, 디자인, 보안 또는 릴리스 오케스트레이션 등 네이티브 스킬이 더 잘 처리하는 영역으로 바뀝니다. 해결 방법: 관련 스킬 섹션을 사용하여 의도적으로 인계합니다. 가져온 출처를 계속 표시하여 다음 스킬이 빈 상태로 시작하는 대신 올바른 컨텍스트를 상속받도록 합니다.
관련 스킬
@00-andruia-consultant- 이 가져온 스킬이 컨텍스트를 설정한 후, 작업이 해당 네이티브 전문 분야에서 더 잘 처리될 때 사용합니다.@00-andruia-consultant-v2- 이 가져온 스킬이 컨텍스트를 설정한 후, 작업이 해당 네이티브 전문 분야에서 더 잘 처리될 때 사용합니다.@10-andruia-skill-smith- 이 가져온 스킬이 컨텍스트를 설정한 후, 작업이 해당 네이티브 전문 분야에서 더 잘 처리될 때 사용합니다.@10-andruia-skill-smith-v2- 이 가져온 스킬이 컨텍스트를 설정한 후, 작업이 해당 네이티브 전문 분야에서 더 잘 처리될 때 사용합니다.
추가 리소스
이 지원 매트릭스와 아래 연결된 파일을 가져온 스킬에 대한 운영자 패키지로 사용하세요. 이는 일반적인 스캐폴딩이 아닌 실제 복사된 소스 자료를 반영해야 합니다.
| 리소스 계열 | 검토자에게 제공하는 내용 | 예제 경로 |
|---|---|---|
references | 업스트림에서 복사된 참조 노트, 가이드 또는 배경 자료 | references/n/a |
examples | 업스트림에서 복사된 작업 예제 또는 재사용 가능한 프롬프트 | examples/n/a |
scripts | 실행 또는 검증을 변경하는 업스트림 도우미 스크립트 | scripts/i18n_checker.py |
agents | 가져온 패키지의 실제 일부인 라우팅 또는 위임 노트 | agents/n/a |
assets | 소스 패키지에서 복사된 지원 자산 또는 스키마 | assets/n/a |
가져온 참조 노트
가져옴: 3. 구현 패턴
React (react-i18next)
import { useTranslation } from 'react-i18next';
function Welcome() {
const { t } = useTranslation();
return <h1>{t('welcome.title')}</h1>;
}
Next.js (next-intl)
import { useTranslations } from 'next-intl';
export default function Page() {
const t = useTranslations('Home');
return <h1>{t('title')}</h1>;
}
Python (gettext)
from gettext import gettext as _
print(_("Welcome to our app"))
가져옴: 4. 파일 구조
locales/
├── en/
│ ├── common.json
│ ├── auth.json
│ └── errors.json
├── tr/
│ ├── common.json
│ ├── auth.json
│ └── errors.json
└── ar/ # RTL
└── ...
가져옴: 6. 일반적인 문제
| 문제 | 해결 방법 |
|---|---|
| 누락된 번역 | 기본 언어로 폴백 |
| 하드코딩된 문자열 | 린터/검사기 스크립트 사용 |
| 날짜 형식 | Intl.DateTimeFormat 사용 |
| 숫자 형식 | Intl.NumberFormat 사용 |
| 복수형 | ICU 메시지 형식 사용 |
가져옴: 7. RTL 지원
/* CSS 논리적 속성 */
.container {
margin-inline-start: 1rem; /* margin-left 아님 */
padding-inline-end: 1rem; /* padding-right 아님 */
}
[dir="rtl"] .icon {
transform: scaleX(-1);
}
가져옴: 8. 체크리스트
배포 전:
- 모든 사용자 대상 문자열이 번역 키를 사용합니다.
- 지원되는 모든 언어에 대한 로케일 파일이 있습니다.
- 날짜/숫자 형식이 Intl API를 사용합니다.
- RTL 레이아웃이 테스트되었습니다(해당하는 경우).
- 폴백 언어가 구성되었습니다.
- 컴포넌트에 하드코딩된 문자열이 없습니다.
가져옴: 스크립트
| 스크립트 | 목적 | 명령어 |
|---|---|---|
scripts/i18n_checker.py | 하드코딩된 문자열 및 누락된 번역 감지 | python scripts/i18n_checker.py <project_path> |
가져옴: 제한 사항
- 이 스킬은 작업이 위에서 설명한 범위와 명확히 일치할 때만 사용하세요.
- 출력물을 환경별 검증, 테스트 또는 전문가 검토를 대체하는 것으로 취급하지 마세요.
- 필수 입력, 권한, 안전 경계 또는 성공 기준이 누락된 경우 중단하고 명확히 하세요.