humanize-korean

Humanize KR — 한국어 문체 품질 개선기 v2.1.0-internal

AI(ChatGPT · Claude · Gemini 등)가 쓴 한글 글을 내용은 한 글자도 건드리지 않고 문체 · 리듬 · 표현만 자연스러운 한국어로 되돌리는 Claude Code 스킬입니다.

번역투, 과도한 영어 인용, 기계적 병렬 ("첫째 · 둘째 · 셋째"), "결론적으로 / 시사하는 바가 크다" 같은 AI 특유 관용구, 피동태 남용, 문두 접속사 남발, 이모지·불릿 남용 등 10대 카테고리 × 40+ 서브 패턴을 심각도(S1/S2/S3)로 분류해 스팬 단위로 탐지한 뒤, 윤문합니다.

설치 (Install)

내부 fork 운영 주의: 우리 Hermes multi-profile 시스템에는 install.sh/update.sh 전역 심링크 설치를 바로 적용하지 않습니다. 실제 적용은 별도 Hermes profile-local skill wrapper에서 검증 후 단계적으로 진행합니다. 아래 설치 방법은 upstream 공개 사용자를 위한 참고입니다.

Claude Code와 OpenAI Codex CLI 양쪽을 지원합니다. 전체 가이드: INSTALL.md

Claude Code — 플러그인 마켓플레이스 (클론 불필요, upstream 공개 설치 기준)

/plugin marketplace add epoko77-ai/im-not-ai
/plugin install humanize-korean@im-not-ai

새 세션에서 /humanize-korean (또는 자연어로 "이 글 AI 티 없애줘").

Claude Code · Codex CLI — 클론 + 스크립트

git clone https://github.com/epoko77-ai/im-not-ai.git
cd im-not-ai
./install.sh            # 설치된 claude/codex 자동 감지 → 전역 심링크

• Claude: /humanize-korean · Codex: $humanize-korean
• 한쪽만: ./install.sh --claude-only / --codex-only · 제거: ./uninstall.sh
• 업데이트: ./update.sh — 새 버전 자동 감지 후 git pull + 재설치(--check는 감지만). 마켓플레이스 설치는 /plugin update.
• Codex는 Fast(단일 호출) 모드만 제공합니다. 정밀 strict 5인 파이프라인은 Claude Code 전용.

왜 한글 특화인가

영어권 humanizer(QuillBot · Hix · Undetectable AI)는 한국어에 약합니다. 한글 AI 글의 티는 대부분 영어 번역투에서 나옵니다.

• "AI 기술을 통해 효율을 높일 수 있다" → "AI로 효율을 높인다"
• "이에 있어서 중요한 점은" → "여기서 중요한 건"
• "~에 의해 생성된" → "~가 만든"
• "결론적으로, 이는 시사하는 바가 크다" → (삭제)

이 하네스는 그 한글 고유 패턴을 SSOT로 정리하고, 탐지·윤문·내용 감사·자연스러움 검증을 분리된 에이전트로 수행합니다.

4대 철칙

1. 의미 불변 — 사실 · 주장 · 수치 · 고유명사 · 직접 인용은 100% 원문 보존.
2. 근거 기반 — 탐지된 span에만 수술적 수정. 탐지 없는 구간은 건드리지 않음.
3. 장르 유지 — 칼럼을 문학으로, 리포트를 에세이로 옮기지 않음.
4. 과윤문 금지 — 변경률 30% 초과 시 경고, 50% 초과 시 강제 중단.

아키텍처 (v1.6)

Fast 모드 (디폴트, 5,000자 이하)

입력 텍스트
    ↓
[humanize-monolith]   ── 한 콜 안에서 탐지 → 윤문 → 자체검증 일괄
    ↓                     (도구 호출 3회 캡, opus, ~3분)
final.md (끝에 <!-- HUMANIZE-SUMMARY --> 블록 내장)

Strict 모드 (--strict 또는 8,000자+ 자동 승급)

입력 텍스트
    ↓
[ai-tell-detector]        ── 탐지 (span · category · severity)
    ↓
[korean-style-rewriter]   ── finding 기반 수술적 윤문
    ↓
[병렬 검증 팀]
    ├─ [content-fidelity-auditor]  ── 13항 체크리스트로 의미 동등성 감사
    └─ [naturalness-reviewer]      ── 탐지 재실행으로 잔존·과윤문 판정
    ↓
[오케스트레이터 종합]
    ├─ accept              → final.md + summary.md
    ├─ rewrite_round_2     → 2차 윤문 (최대 3회)
    ├─ rollback_and_rewrite → 문제 edit 롤백
    └─ hold_and_report     → 사람 검토 권고

7인 에이전트

에이전트	모드	역할
humanize-monolith	Fast 디폴트	단일 호출 윤문 (탐지·윤문·자체검증 일괄, 도구 호출 4~5회 캡)
ai-tell-detector	Strict	span 단위 JSON 탐지 리포트 생성
korean-style-rewriter	Strict	finding 기반 수술적 윤문, 변경률 모니터링
content-fidelity-auditor	Strict	의미 동등성 감사 (13항), 훼손 시 롤백 지시
naturalness-reviewer	Strict	잔존 AI 티 · 과윤문 · 자연도 판정, 품질 등급 A~D
korean-ai-tell-taxonomist	별도 명령	분류 체계(SSOT) 관리, 신규 패턴 심사 승격
humanize-web-architect	옵션	Next.js 15 + Vercel 웹 서비스 확장 설계

AI 티 분류 체계 (요약)

ID	대분류	대표 서브 패턴
A	번역투	"~를 통해", "~에 대해", "~에 있어서", 이중 피동 "~되어진다", "가지고 있다", "그/그녀" 강박적 사용 (A-16), 관계절 좌향 수식 (A-18), "~에서의/~에로의" 이중 조사 (A-19)
B	영어 인용·용어 과다	과도한 괄호 병기, 번역 가능한 영어 그대로
C	구조적 AI 패턴	기계적 "첫째/둘째/셋째", 과도한 불릿·헤딩·이모지, 연결어미 뒤 쉼표 (C-11), 가운데점(·) 결합도 무시 나열 (C-13)
D	AI 특유 관용구	"결론적으로", "시사하는 바가 크다", "주목할 만하다", "혁신적인"
E	리듬 균일성	문장 길이 표준편차 낮음, 동일 종결어미 반복, 청자 경어법 일관성 손실 (E-7)
F	수식·중복	"매우", "정말", 동의어 이중 수식, "~적/~성/~화/-tion/-ment" 남발
G	Hedging 남용	"~할 수 있을 것으로 보인다" 다중 완곡
H	접속사 남발	문두 "또한/따라서/즉/나아가" 연속
I	형식명사 과다	"것이다", "점", "수", "바", "~할 필요가 있다"
J	시각 장식 남용	과도한 볼드, "따옴표", 대시(—) 남발

전체 60+ 서브 패턴과 처방: ai-tell-taxonomy.md · rewriting-playbook.md · 학술 인용 외부 SSOT: scholarship.md (v2.0 신규)

심각도 & 품질 등급

심각도

• S1 결정적: 한 번만 나와도 AI 확신. 무조건 제거.
• S2 강함: 1~2회 허용, 3회+ 반복 시 제거.
• S3 약함: 다른 패턴과 중첩될 때만 문제.

품질 등급 (윤문 후)

• A: S1 0건, S2 ≤2건, 점수 개선 70%+
• B: S1 0건, S2 ≤4건, 개선 50%+
• C: S1 1~2건 or 과윤문 시그널 2개 → 2차 윤문
• D: S1 3건+ or 심각한 과윤문 → 사람 검토

사용법 — 5분이면 따라합니다

전역 설치(설치)를 마쳤다면 1~2단계(클론·폴더 진입)는 건너뛰고, 아무 폴더에서나 바로 3단계로 가세요. 아래는 설치 없이 리포에서 곧바로 체험하는 흐름입니다.

0. 전제

Claude Code가 설치돼 있어야 합니다. Mac · Windows · Linux 모두 지원합니다.

설치 확인:

claude --version