| name | korean-tone-review |
| description | 한국어 산출물(README·문서·공유 메시지·긴 응답)의 AI 직역체·기계 번역체를 mechanical 패턴 매칭으로 검수한다. 출력 직전 또는 사용자가 명시 요청 시 호출. Use when finishing a long Korean deliverable (README, doc, message draft, structured long response), or when user requests review with phrases: 톤 봐줘, 어색한 거 잡아줘, 직역체 체크, korean-tone-review, /korean-tone-review. |
korean-tone-review
긴 한국어 산출물을 출력 직전에 self-check 가 아닌 mechanical 패턴 매칭으로 검수한다. 자기 작성 컨텍스트 안의 self-check 는 직역체를 잡지 못한다는 것이 이번 도입 배경.
언제 트리거하나
- README · 기술 문서 · 공유 메시지 · 보고서 같은 긴 한국어 산출물 작성 직후
- 사용자 명시 요청: "톤 봐줘", "어색한 거 잡아줘"
짧은 응답·코드·영어 텍스트는 면제.
검수 절차 (5단계)
1. 텍스트 수집
검수 대상 텍스트를 모은다. 코드 블록(```)·인용·링크 텍스트는 제외하고 자연어 본문만.
2. S1 패턴 — mechanical 매칭, 한 건도 통과 X
references/ai-tell-taxonomy.md 의 S1 카테고리를 정규식 수준으로 매칭한다. 발견 시 무조건 패치.
핵심 매칭 룰 (전체는 taxonomy 참고):
| 패턴 | 정규식 (개념) | 예 |
|---|
| Rhetorical 헤딩 | `^#+\s.+(인가 | 하는가 |
| 콜론 헤딩 | ^#+\s[^#:]+:\s\S | ### 빠르게: /guardrail-config 스킬 |
| Slash 헤딩 | ^#+\s.+\s/\s.+$ | ### 시크릿 스캔 끄기 / 패턴 추가 |
| 영어 직역 단어 | (레시피|알아둘 것|한 번에 보기|~인지 여부) | "자주 쓰는 설정 레시피" |
| "default" 한국어 본문 혼용 | `default\s(로 | 으로 |
| 이중 피동 | \w되어진다\b | "판단되어진다" |
| "~에 대해/~를 통해" 남발 | `에\s대(해 | 하여)\b, 를\s통(해 |
| "가지고 있다" | 가지고\s있다\b | "경쟁력을 가지고 있다" |
3. S2 패턴 — 밀도 검사 (3회 이상이면 패치)
문서 전체에서 카운트하고 임계값 넘으면 패치.
| 패턴 | 임계값 | 예 |
|---|
~구조입니다 / ~식으로 설계되어 있어요 어미 | 한 문서 1회 이하 | "~한 줄로 적용하는 구조입니다" |
것이다 종결 | 한 문서 2회 이하 | "~한 것이다" |
정도부사 (매우, 정말, 극히) | 한 문서 2회 이하 | "매우 중요합니다" |
또한·따라서·즉 문두 접속사 | 70% 이상 삭제 | "또한 ~. 또한 ~." |
~적·~성·~화 추상 접미사 | 한 문서 12회 이하 | "기술적·구조적·근본적" |
Hype 어휘 (혁신적, 획기적, 압도적) | 0 회 | "혁신적인 솔루션" |
4. 변경률 가드 (과윤문 방지)
원본 대비 변경률 추정:
- 5~30%: 정상 범위
- 30% 초과: 과윤문 의심 — 원본 톤·의미 훼손 위험. 패치 범위 축소
- 5% 미만: 저윤문 — S1 패턴 재확인
5. 판정 출력
다음 중 하나로 결론:
verdict: accept # S1 0건, S2 임계값 이내
verdict: patch_needed # S1 또는 S2 임계초과. findings 와 함께 patch 안 제시
verdict: rewrite # S1 5+ 건 또는 다수 카테고리 동시 위반. 섹션 단위 재작성 권고
verdict: hold_and_report # 자연어 판단이 모호한 경우 사용자에게 결정 위임
findings 형식:
- [S1] 카테고리: Rhetorical 헤딩
위치: "## 차단되면 어떻게 보이나"
대안: "## 차단 예시"
- [S2] 카테고리: 어미 어색 ('구조입니다')
위치: "...적용하는 구조입니다."
대안: "...적용합니다."
핵심 원칙
- mechanical 매칭 우선 — 주관 판단은 마지막에만. taxonomy 의 정규식 룰부터 적용.
- 국소성 — 전체 재작성 X, S1/S2 발견 구간만 수정 안 제시.
- 의미·톤 보존 — 변경률 30% 초과 시 의심.
- 누적 학습 — 새로 발견한 어색 패턴은
references/local-additions.md 에 누적.
출력 가이드
검수 결과는 drafter (메인 Claude) 가 바로 patch 할 수 있는 형태로:
- BAD/GOOD 페어 명시
- 위치는 헤딩 텍스트나 짧은 quote 로 식별 가능하게
- 한 번에 다 보여주고 drafter 가 일괄 패치하게 (왔다갔다 X)
참고
