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 로그인이 준비되지 않았다면 작업을 멈추고 설정 방법을 안내하세요.
• 짧은 한 줄 주석이나 변수명처럼 도구를 실행하는 비용이 더 큰 작업은 직접 처리하세요.

Antigravity 사전 동의

Antigravity는 추가 약관상 제3자 제품이나 도구와 연결해 사용하는 행위로 해석될 수 있으며, 계정 제한이나 정지 위험이 있습니다. 작성 요청, 표준 입력의 참고 자료와 적용되는 문체 규약이 Google에 전송되고, 상호작용이 저장되거나 검토될 수 있습니다.

--provider antigravity를 실행하기 직전에 다음 절차를 지키세요.

1. 사용자에게 약관 위험과 Google에 전송되는 범위를 알리세요.
2. 이번 한 번의 실행을 진행해도 되는지 명시적으로 물으세요.
3. 사용자가 위험을 확인하고 진행에 명확히 동의한 경우에만 --accept-antigravity-risk를 추가해 실행하세요.
4. 제공자를 Antigravity로 지정한 요청, 이전 실행에서 받은 동의, 환경변수나 저장된 설정을 현재 실행의 동의로 간주하지 마세요.
5. 사용자가 답하지 않거나 동의하지 않으면 실행하지 말고 OpenRouter 또는 Google AI Studio를 안내하세요.

로그인된 Antigravity CLI를 사용할 때의 기본 모델은 gemini-3.6-flash-low이며, 사용 가능한 모델은 agy models로 확인할 수 있습니다. --accept-antigravity-risk는 약관 준수를 보장하지 않으며, 위험 고지와 일회성 동의를 강제하는 확인 장치입니다.

결과 검증

출력 결과는 초고로만 활용하세요. 모델이 저장소의 파일 경로, 줄 수, 동작을 지어낼 수 있으므로 원본 자료와 대조하여 사실관계를 확인하세요. 숫자와 고유명사, 코드 내 플레이스홀더({name}, %s 등)가 누락되거나 바뀌지 않았는지도 함께 검증하세요.

• 입력과 참고 자료로 뒷받침되지 않은 주장, 수치, 출처, 임의의 담당 주체를 추가하지 않았는지 확인하세요.
• 주어가 빠져 수행 주체가 모호해지지 않았는지, 앞 문장에 대상이 없는 지시어(그 기준, 이를 통해 등)로 내용을 건너뛰지 않았는지 확인하세요.
• 단순히 A가 아니라 B다, A보다 B에 가깝다 같은 불필요한 대조 구문이나 내용 없는 선언형 문장(핵심은 분명합니다, 중요한 것은 ~입니다)이 남아 있지 않은지 확인하세요.
• ~를 함께 봅니다 같은 모호한 포괄 동사, 결을 살리다나 밀도를 더하다 같은 추상어 조합, 지나치게 사전적인 한자어 합성어의 반복이 없는지 확인하세요.
• 관계 설명 없는 기계적인 세 항목 나열, 조사와 어미를 떼어내고 명사만 붙여 쓴 어색한 간결체, 과도한 볼드체와 기호가 없는지 확인하세요.
• UI 문구는 실제 표시되는 화면 자리와 전후 흐름에 맞으면서도 사용자에게 필요한 친절함을 유지하는지 확인하세요.

em-dash나 en-dash가 포함되어 있으면 그대로 출력하지 마세요. 공백 하이픈, 쉼표, 콜론으로 고친 뒤 다시 검증하세요.