i18n & Localization은(는) 무엇을 하나요?
개요
이 공개 인트레이크 복사본은 https://github.com/sickn33/antigravity-awesome-skills의 plugins/antigravity-awesome-skills/skills/i18n-localization 패키지를 Omni Skills 편집 형식으로 포장하면서 원본 출처를 숨기지 않습니다.
운영자가 업스트림 워크플로, 지원 파일, 리포지토리 컨텍스트를 그대로 유지하면서 공개 유효성 검사기와 비공개 강화기가 정상적인 다운스트림 흐름을 계속하도록 해야 할 때 사용하세요.
이 인트레이크는 복사된 업스트림 파일을 그대로 유지하고 metadata.json의 external_source 블록과 ORIGIN.md를 리뷰를 위한 출처 앵커로 사용합니다.
i18n & Localization > 국제화(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 | 지역화 - 실제 번역 |
| Locale | 언어 + 지역 (en-US, tr-TR) |
| RTL | 오른쪽에서 왼쪽 언어 (아랍어, 히브리어) |
예제
예제 1: 업스트림 워크플로 직접 요청
@i18n-localization-v2를 사용하여 <작업>을 처리하세요. 복사된 업스트림 워크플로에서 시작하고, 결과를 변경하는 파일만 로드하며, 출처를 답변에 표시하세요.
설명: 운영자가 가져온 워크플로는 필요하지만 전체 리포지토리는 필요하지 않을 때 가장 안전한 시작점입니다.
예제 2: 출처 기반 리뷰 요청
@i18n-localization-v2를 metadata.json 및 ORIGIN.md와 함께 검토하고, 어떤 복사된 업스트림 파일을 먼저 로드할지와 그 이유를 설명하세요.
설명: 정확하고 감사 가능한 출처 및 파일 선택 설명이 필요할 때 리뷰 또는 문제 해결 전에 사용하세요.
예제 3: 실행 전 복사된 지원 파일 범위 좁히기
@i18n-localization-v2를 사용하여 <작업>을 처리하세요. 결과를 변경하는 복사된 참조, 예제 또는 스크립트만 로드하고, 진행 전에 파일 이름을 명시적으로 지정하세요.
설명: 기본적으로 전체 복사 패키지를 로드하는 대신 점진적 공개와 스킬을 일치시킵니다.
예제 4: 리뷰어 패킷 만들기
@i18n-localization-v2를 복사된 업스트림 파일과 출처를 사용하여 검토하고, 병합 전에 누락된 부분을 요약하세요.
설명: PR이 인간 리뷰를 기다리고 있고 반복 가능한 감사 패킷을 원할 때 유용합니다.
모범 사례
생성된 공개 스킬을 업스트림 리포지토리 주변의 검토 가능한 패키징 레이어로 취급하세요. 목표는 출처를 명시적으로 유지하고 실행을 실질적으로 개선하는 복사된 소스 자료만 로드하는 것입니다.
- 번역 키 사용, 원시 텍스트 사용 금지
- 기능별로 번역 네임스페이스 지정
- 복수형 지원
- 로케일별 날짜/숫자 형식 처리
- 처음부터 RTL 계획
- 복잡한 문자열에 ICU 메시지 형식 사용
- 컴포넌트에 문자열 하드코딩 금지
가져온 운영 노트
가져옴: 5. 모범 사례
해야 할 일 ✅
- 번역 키 사용, 원시 텍스트 사용 금지
- 기능별로 번역 네임스페이스 지정
- 복수형 지원
- 로케일별 날짜/숫자 형식 처리
- 처음부터 RTL 계획
- 복잡한 문자열에 ICU 메시지 형식 사용
하지 말아야 할 일 ❌
- 컴포넌트에 문자열 하드코딩 금지
- 번역된 문자열 연결 금지
- 텍스트 길이 가정 금지 (독일어는 30% 더 길어짐)
- RTL 레이아웃 잊지 않기
- 같은 파일에 언어 혼용 금지
문제 해결
문제: 운영자가 가져온 컨텍스트를 건너뛰고 너무 일반적인 답변을 제공함
증상: 결과가 plugins/antigravity-awesome-skills/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> |
가져옴: 제한 사항
- 이 스킬은 작업이 위에서 설명한 범위와 명확하게 일치할 때만 사용하세요.
- 출력을 환경별 검증, 테스트 또는 전문가 리뷰를 대체하는 것으로 취급하지 마세요.
- 필수 입력, 권한, 안전 경계 또는 성공 기준이 누락된 경우 멈추고 명확히 요청하세요.