| name | humanize-korean |
| description | AI(ChatGPT·Claude·Gemini)가 쓴 한글 텍스트를 사람이 쓴 글처럼 윤문한다. 번역투·영어 인용 과다·기계적 병렬·관용구·피동 남용·접속사 남발·리듬 균일·이모지/불릿 과다 등 10대 카테고리 40+ AI 티 패턴을 탐지·분류해 내용은 한 글자도 건드리지 않고 문체·리듬·표현만 자연스럽게 재작성한다. 트리거 — "AI 티 없애줘", "AI 윤문", "ChatGPT 티 제거", "번역투 고쳐", "사람이 쓴 것처럼", "humanize Korean". 단순 맞춤법 교정·번역·내용 추가는 대상 아님. |
Humanize Korean — Fast Path (Codex)
5,000자 이하 한글 텍스트의 "AI 티"를 한 번에 탐지·윤문·자체검증한다. Codex는 Fast(monolith) 모드만 제공한다 — 정밀 5인 파이프라인(strict)은 Claude Code 전용이다.
철칙 (위반 시 즉시 롤백)
- 의미 불변: 사실·주장·수치·날짜·고유명사·인용문은 원문과 100% 일치.
- 근거 기반:
references/quick-rules.md에 매핑되지 않는 구간은 건드리지 않는다.
- 장르 유지: 입력 장르(칼럼·리포트·블로그·공적)에서 이탈 금지.
- register 보존: 원문 격식체면 결과도 격식체. AI 티는 문법·수사이지 격식 자체가 아니다.
- 과윤문 금지: 변경률 30% 초과 = 경고, 50% 초과 = 작업 중단·롤백.
- Do-NOT: 고유명사·수치·인용·법조문·영어 약어(LLM·GPU·API 등) 원형 보존.
절차 (단일 호출 안에서)
- 룰북 로드:
references/quick-rules.md(이 SKILL.md 디렉토리 기준 상대 경로)를 읽어 S1·S2 패턴과 자체검증 체크리스트를 내재화한다.
- 입력 확보: 사용자가 붙여넣은 텍스트를 원문으로 한다. 인자가 파일 경로(.txt/.md)면 그 파일을 읽는다. 한국어가 아니면 "한국어 텍스트만 처리 가능" 안내 후 종료.
- 장르 추정: 첫 300자로 장르 추정(사용자 명시 시 우선).
- 탐지: A~J 카테고리 패턴을 메모리에서 스캔해 (ID, span, severity, fix) 수집. Do-NOT span은 제외.
- 윤문: D(관용구 삭제) → A → I → G → H → F → B → C·J → E 순서로 문단 단위 처리. 변경률을 모니터링하며 50% 임박 시 후속 edit 보류.
- 자체검증: quick-rules "자체검증 체크리스트" 6항 점검. 위반 항목 발견 시 해당 edit 롤백 → 윤문 부분 재실행(최대 1회).
- 출력: cwd 기준
_workspace/{run_id}/final.md 작성(run_id = YYYY-MM-DD-NNN, 당일 기존 폴더 있으면 NNN+1). 본문 끝에 빈 줄 하나 두고 <!-- HUMANIZE-SUMMARY ... --> HTML 주석 블록 1개 추가:
- 원본/윤문본 글자수·변경률
- 카테고리별 탐지 건수(before → after, quick-rules ID 기준)
- 자체검증 6항 통과 여부
- 등급(A/B/C/D) + 사유 1줄
- 주요 변경 하이라이트 3~5건(before → after, 각 100자 이내)
- 응답: 사용자에게 짧게 4가지 반환 — ① 한 줄 상태(
완료. 변경률 X% / 등급 Y / 자체검증 N/6 통과) ② 핵심 카테고리 탐지 4~6건(before → after) ③ 변경 하이라이트 1건 ④ 등급 B 이하면 "정밀 검증은 Claude Code의 strict 5인 파이프라인 권장" 안내. 윤문본 본문은 응답에 인라인하지 말고 final.md에만 저장.
등급
- A: S1 0건, S2 2건 이하, 변경률 10~25%, 자체검증 6/6.
- B: S1 0건, S2 4건 이하, 자체검증 5/6 이상.
- C/D: S1 잔존 또는 과윤문 시그널 — Claude Code strict 모드 권고.
옵션 (인자 끝에 자연어로)
장르: 칼럼|리포트|블로그|공적 · 강도: 보수|기본|적극 · 최소심각도: S1|S2|S3
참고
- 슬림 룰북:
references/quick-rules.md — S1·S2 핵심 패턴 + 자체검증 체크리스트
- 분류 체계 본진:
references/ai-tell-taxonomy.md — 10대분류 × 40+ 패턴 전수
- 윤문 처방:
references/rewriting-playbook.md — 카테고리별 치환 레시피
