korean-prose

한국어 산문을 작성하기 전에 적용할 문체 규약을 확인하세요.

1. 현재 작업 디렉터리에 docs/korean-style.md가 있으면 해당 규약을 우선 적용하세요.
2. 저장소 규약이 없으면 기본 문체 규약을 적용하세요.
3. 한 문서 안에서 해요체와 습니다체를 섞지 마세요.

코드 및 로직 관련 문장 리서치

코드 안에서 사용되거나 코드 및 로직과 맞물려 있는 문장(예: i18n 다국어 문구, UI 컴포넌트 텍스트, 에러 및 유효성 검증 메시지, CLI 출력, 여러 줄 주석, 코드 변경을 설명하는 기술 문서와 PR 본문)을 작성하거나 수정할 때는 문장만 단독으로 넘기지 마세요. scripts/prose.ts를 호출하기 전에 저장소에서 아래 맥락을 먼저 조사해 함께 전달하세요.

1. 실제 사용 위치와 UI 요소 확인: 해당 문구나 i18n 키, 상수가 실제로 호출되거나 렌더링되는 컴포넌트와 함수 위치를 검색하세요. 버튼 라벨, 모달 제목과 본문, 토스트 알림, 입력창 하단 오류, 빈 화면 안내 중 어디에 표시되는지 파악해 --medium에도 구체적으로 지정하세요.
2. 발생 조건과 전후 동작 파악: 어떤 분기 조건(권한 부족, 네트워크 실패, 입력값 초과, 저장 완료 등)에서 노출되는 문구인지, 사용자가 직전에 무엇을 했고 직후에 어떤 행동을 해야 하는지 코드 로직을 확인하세요.
3. 보간 변수와 단위 확인: {name}, {count}, %s, ${limit} 같은 플레이스홀더에 실제로 어떤 값과 단위가 들어가는지 확인하세요. 들어가는 값에 따라 조사와 서술어가 자연스럽게 이어져야 합니다.
4. 주변 문구와 용어 통일: 같은 화면이나 인접한 i18n 키에서 이미 사용 중인 용어, 호칭, 어미 형태(해요체, 습니다체, 명사형)를 수집해 일관성을 유지하세요.

Gemini로 초고 받기

번역투를 교정하거나 산문을 작성할 때는 이 스킬 폴더의 scripts/prose.ts를 실행하세요. 스크립트 경로는 이 SKILL.md의 위치를 기준으로 정하고, 현재 작업 디렉터리는 대상 저장소로 지정하세요.

node <skill-directory>/scripts/prose.ts --medium 'GitHub PR 본문' "이 변경의 PR 본문"
git diff --stat | node <skill-directory>/scripts/prose.ts --medium 'GitHub PR 본문' "이 변경의 PR 본문"

# 코드 및 i18n 문구를 수정할 때는 리서치한 사용 위치 예제와 주변 맥락을 표준 입력으로 함께 전달하세요.
cat <<'EOF' | node <skill-directory>/scripts/prose.ts --medium '결제 실패 토스트 알림' "payment.error.limit_exceeded 문구를 자연스럽게 다듬어 줘"
[원본 i18n]
"payment.error.limit_exceeded": "일일 한도({limit}원)에 의해 결제가 거부되었습니다."

[사용 위치: src/features/checkout/PaymentForm.tsx]
if (error.code === 'DAILY_LIMIT_EXCEEDED') {
  toast.error(t('payment.error.limit_exceeded', { limit: formatCurrency(error.dailyLimit) }));
}

[인접한 i18n 문구]
"payment.error.expired_card": "유효기간이 지난 카드예요. 다른 카드를 선택해 주세요."
EOF

• 인자에는 작성 요청을, 표준 입력에는 리서치한 코드 사용 예제와 참고 자료를 전달하세요.
• --medium 옵션에는 GitHub PR 본문, 회원 탈퇴 확인 모달 본문, 결제 실패 토스트 알림, 버튼 이름, SNS 스레드, 내부 개발 문서처럼 실제 출력 매체와 UI 자리를 구체적으로 지정하세요.
• openrouter와 google-ai-studio 제공자를 사용할 때는 prose.ts에 저장소 탐색용 읽기 전용 도구(search_code, read_file, list_files)가 내장되어 있어, Gemini가 필요할 때 현재 작업 디렉터리에서 i18n 키의 사용 위치나 주변 코드를 추가로 조회할 수 있습니다. 도구 호출을 끄려면 --no-tools 옵션을 지정하세요.
• 기본 제공자는 OpenRouter이며 OPENROUTER_API_KEY가 필요합니다.
• Google AI Studio를 직접 사용하려면 --provider google-ai-studio와 GEMINI_API_KEY를 사용하세요. 빠르고 저렴한 초고에는 기본값인 gemini-3.5-flash-lite를 사용하고, 더 높은 품질이 필요하면 --model gemini-3.7-flash를 지정하세요.
• KOREAN_PROSE_PROVIDER와 KOREAN_PROSE_MODEL 환경변수로 기본 제공자와 모델을 바꿀 수 있습니다. 명령줄의 --provider와 --model이 환경변수보다 우선합니다.
• 선택한 제공자의 API 키나 CLI 로그인이 준비되지 않았다면 작업을 멈추고 설정 방법을 안내하세요.
• 짧은 한 줄 주석이나 변수명처럼 도구를 실행하는 비용이 더 큰 작업은 직접 처리하세요.