epoko77-ai/im-not-ai의 Codex 플러그인 포트입니다. 원본 공식 repo의 v2.0.0 기준으로 만들었고, 한국 번역학계 8유형 기반 taxonomy 보강과 post-editese metric layer까지 반영했습니다.
AI(ChatGPT · Claude · Gemini 등)가 쓴 한글 글을 내용은 한 글자도 건드리지 않고 문체 · 리듬 · 표현만 자연스러운 한국어로 되돌리는 Codex plugin/skill입니다.
번역투, 과도한 영어 인용, 기계적 병렬("첫째 · 둘째 · 셋째"), "결론적으로 / 시사하는 바가 크다" 같은 AI 특유 관용구, 피동태 남용, 문두 접속사 남발, 이모지·불릿 남용 등 10대 카테고리 × 60+ 서브 패턴을 심각도(S1/S2/S3)로 분류해 스팬 단위로 탐지한 뒤, 윤문합니다.
이 repo는 공식 Claude Code 스킬이 아니라, 같은 taxonomy/playbook/agent prompt를 Codex plugin/skill 구조로 옮긴 community adapter입니다.
- 원본 프로젝트:
epoko77-ai/im-not-ai - Codex plugin name:
im-not-ai-codex - Codex skill name:
humanize-korean - Plugin source path:
plugins/im-not-ai - Plugin version:
v2.0.0 - Original version:
v2.0.0 - Latest release:
v2.0.0 - Original release:
epoko77-ai/im-not-ai v2.0.0 - Last upstream sync:
8071726(v2.0.0 Korean translation scholarship + post-editese metrics)
이 Codex 포트는 원본 epoko77-ai/im-not-ai의 버전을 따라갑니다. 예를 들어 원본이 v2.0.0이면 이 plugin도 v2.0.0으로 배포합니다. 나중에 원본이 새 버전으로 올라가면, 원본 변경분을 반영한 뒤 같은 버전으로 새 release를 만듭니다.
즉 im-not-ai-codex v2.0.0은 "원본 im-not-ai v2.0.0의 taxonomy, metrics layer, fast/strict workflow를 Codex plugin 구조로 옮긴 배포판"이라는 뜻입니다. 전체 변경 내역은 RELEASE_NOTES.md를 참고하세요.
영어권 humanizer(QuillBot · Hix · Undetectable AI)는 한국어에 약합니다. 한글 AI 글의 티는 대부분 영어 번역투에서 나옵니다.
- "AI 기술을 통해 효율을 높일 수 있다" -> "AI로 효율을 높인다"
- "이에 있어서 중요한 점은" -> "여기서 중요한 건"
- "~에 의해 생성된" -> "~가 만든"
- "결론적으로, 이는 시사하는 바가 크다" -> (삭제)
이 하네스는 그 한글 고유 패턴을 SSOT로 정리하고, 탐지·윤문·내용 감사·자연스러움 검증을 역할별로 수행합니다.
- 의미 불변 — 사실 · 주장 · 수치 · 고유명사 · 직접 인용은 100% 원문 보존.
- 근거 기반 — 탐지된 span에만 수술적 수정. 탐지 없는 구간은 건드리지 않음.
- 장르 유지 — 칼럼을 문학으로, 리포트를 에세이로 옮기지 않음.
- 과윤문 금지 — 변경률 30% 초과 시 경고, 50% 초과 시 강제 중단.
원본 v2.0의 핵심은 v1.6.1 fast path를 유지하면서 한국 번역학계 8유형과 Toral식 post-editese 축을 taxonomy/metrics에 붙인 것입니다. 연결어미 뒤 쉼표 같은 v1.6 신호에 더해 영어 대명사 직역, 관계절 좌향 수식, 이중 조사, 경어법 일관성 손실 같은 번역투 신호를 보조 점수로 계산합니다. fast mode 산출물은 계속 final.md 하나로 통합하고 메타데이터를 HTML 주석 블록으로 보존합니다.
Fast 모드 (디폴트, 5,000자 이하 권장)
입력 텍스트
↓
[metrics.py + metrics_v2.py] -- KatFish/LREAD + post-editese 보조 점수 계산
↓
[humanize-monolith] -- 점수 + quick-rules 기반 탐지 -> 윤문 -> 자체검증
↓
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 -> 사람 검토 권고
원본 Claude Code판은 Agent, TeamCreate, slash command, model: opus 메타데이터를 사용합니다. 이 Codex 포트는 같은 역할 정의와 reference 문서를 유지하되, Codex plugin의 humanize-korean skill workflow 안에서 role pass로 실행하도록 바꿨습니다.
| 역할 | 모드 | 설명 |
|---|---|---|
humanize-monolith |
Fast 디폴트 | 정량 점수와 quick-rules 기반 단일 흐름 탐지·윤문·자체검증 |
ai-tell-detector |
Strict | span 단위 JSON 탐지 리포트 생성 |
korean-style-rewriter |
Strict | finding 기반 수술적 윤문, 변경률 모니터링 |
content-fidelity-auditor |
Strict | 의미 동등성 감사, 훼손 시 롤백 지시 |
naturalness-reviewer |
Strict | 잔존 AI 티 · 과윤문 · 자연도 판정 |
korean-ai-tell-taxonomist |
별도 reference | 분류 체계 유지·확장 판단 |
humanize-web-architect |
옵션 | Next.js/Vercel 웹 서비스 확장 설계 |
korean-translation-scholar |
reference | 한국 번역학계 근거 검토 |
post-editese-metric-engineer |
reference | post-editese metric 설계 |
quick-rules-integrator |
reference | 본진 taxonomy를 fast 룰북으로 압축 |
taxonomy-gap-analyzer |
reference | 신규 번역투 gap 분석 |
translationese-research-distiller |
reference | 학술 근거 요약 |
| ID | 대분류 | 대표 서브 패턴 |
|---|---|---|
| A | 번역투 | "~를 통해", "~에 대해", "~에 있어서", 이중 피동 "~되어진다", "가지고 있다", 영어 대명사 직역, 관계절 좌향 수식, 이중 조사 |
| B | 영어 인용·용어 과다 | 과도한 괄호 병기, 번역 가능한 영어 그대로 |
| C | 구조적 AI 패턴 | 기계적 "첫째/둘째/셋째", 과도한 불릿·헤딩·이모지 |
| D | AI 특유 관용구 | "결론적으로", "시사하는 바가 크다", "주목할 만하다", "혁신적인" |
| E | 리듬 균일성 | 문장 길이 표준편차 낮음, 동일 종결어미 반복, 단문 일변도, 쉼표 분절 길이, 청자 경어법 일관성 손실 |
| F | 수식·중복 | "매우", "정말", 동의어 이중 수식, "~적/~성/~화" 남발 |
| G | Hedging 남용 | "~할 수 있을 것으로 보인다" 다중 완곡, 안전 균형 lexicon |
| H | 접속사 남발 | 문두 "또한/따라서/즉/나아가" 연속 |
| I | 형식명사 과다 | "것이다", "점", "수", "바", "~할 필요가 있다" |
| J | 시각 장식 남용 | 과도한 볼드, "따옴표", 대시 남발 |
전체 60+ 서브 패턴과 처방은 plugin 내부 reference 문서에 들어 있습니다.
quick-rules.md— v2.0 fast path용 S1/S2 슬림 룰북ai-tell-taxonomy.md— strict mode용 전체 분류 체계rewriting-playbook.md— 카테고리별 윤문 처방metrics.py,baseline.json,metrics_v2.py,baseline_v2.json— KatFish/LREAD + post-editese 정량 점수 레이어scholarship.md— v2.0 학술 근거 SSOT
심각도
- S1 결정적: 한 번만 나와도 AI 확신. 무조건 제거.
- S2 강함: 1~2회 허용, 3회 이상 반복 시 제거.
- S3 약함: 다른 패턴과 중첩될 때만 문제.
품질 등급 (윤문 후)
- A: S1 0건, S2 2건 이하, 변경률 10~25%, 자체검증 6항 통과
- B: S1 0건, S2 4건 이하, 자체검증 5항 이상 통과
- C: S1 1~2건 또는 자체검증 4항 이하 → strict/2차 윤문 권고
- D: S1 3건 이상 또는 변경률 50% 초과 → 작업 중단/사람 검토
Codex plugin marketplace로 추가합니다.
codex plugin marketplace add Squirbie/im-not-ai-codex그 다음 Codex를 재시작하고, Plugins 화면에서 im-not-ai Codex를 선택한 뒤 Humanize Korean을 설치하면 됩니다.
로컬에서 먼저 테스트하려면:
codex plugin marketplace add /absolute/path/to/im-not-ai-codexCodex plugin/marketplace 구조는 공식 문서를 기준으로 맞췄습니다: https://developers.openai.com/codex/plugins/build
원본 README에는 이 Codex 포트와 별도로 opencode 기반 Web UI 포트도 안내되어 있습니다.
- Codex plugin:
Squirbie/im-not-ai-codex - Web UI:
im-not-ai-ocx.illuwa.click
Codex에서 자연어로 부르면 됩니다.
humanize-korean으로 이 글 AI 티 없애줘:
[윤문할 한글 초안]
트리거 예시:
AI 티 없애줘GPT 문체 제거해줘사람이 쓴 것처럼 윤문해줘번역투 제거한글 AI 윤문humanize-korean으로 윤문해줘
정밀하게 돌리고 싶으면 끝에 --strict를 붙입니다. 8,000자 이상 장문이나 부분 재실행 요청은 strict mode로 자동 전환됩니다.
humanize-korean으로 이 글 AI 티 없애줘 --strict:
[긴 글]
Fast 모드는 _workspace/{run_id}/ 아래에 최소 산출물을 남깁니다.
| 파일 | 내용 |
|---|---|
01_input.txt |
원문 그대로 |
00_metrics.json |
KatFish/LREAD 기반 정량 점수 (가능할 때) |
01_input_with_metrics.txt |
점수 블록 + 원문 결합 입력 |
final.md |
윤문본 + 끝부분 <!-- HUMANIZE-SUMMARY --> HTML 주석 메타 블록 |
Strict 모드는 검증 산출물을 더 자세히 남깁니다.
| 파일 | 내용 |
|---|---|
01_input.txt |
원문 그대로 |
02_detection.json |
AI 티 탐지 리포트 |
03_rewrite.md |
윤문본 |
03_rewrite_diff.json |
변경 diff |
04_fidelity_audit.json |
의미 보존 감사 |
05_naturalness_review.json |
자연스러움 리뷰 |
final.md |
최종 윤문본 |
summary.md |
점수 변화·주요 변경·등급 요약 |
그대로 말씀하시면 됩니다. 재실행·수정 명령을 따로 외울 필요 없습니다.
- "이 문단만 다시 윤문해줘" — 해당 구간만 재시도
- "번역투만 더 손봐줘" — 특정 카테고리만 재처리
- "윤문 강도 낮춰줘" — 보수적 윤문
- "원문 톤을 더 살려줘" — 변경률 상한을 낮춰 원문 유지
- "2차 윤문해줘" — 현재 결과를 한 번 더 다듬기
- 수치 · 단위 · 날짜
- 고유명사 · 인명 · 제품명 · 모델명
- 큰따옴표 내부 직접 인용
- 법률 · 규정 조문
- 학술 개념어와 업계 표준 영어 약어(LLM · GPU · MCP · API 등)
공식 v2.0은 v1.6.1의 monolith fast path와 final.md 단일 산출물 정책을 유지하면서, 번역학 근거와 post-editese 정량 신호를 본진에 붙인 릴리즈입니다.
- 신규 본진 패턴 — A-16 영어 대명사 직역, A-18 관계절 좌향 수식, A-19 이중 조사 결합, E-7 청자 경어법 일관성 손실
- 기존 패턴 보강 — A-15 추상 주어, A-7 가지고 있다, F-4 과잉 접두·접미, E-2 동일 종결어미 처방 강화
- post-editese metric layer —
metrics_v2.py와baseline_v2.json으로 simplification, normalisation, interference 축을 계산 - 학술 근거 SSOT —
scholarship.md를 추가하고 taxonomy에 한국 번역학계 8유형 메타필드를 보존 - A-17 hold — 무정물·추상명사
-들패턴은 근거와 metric은 보존하되, 본진 등재는 v2.1까지 보류
공식 v1.6은 v1.5 monolith 구조를 유지하면서 정량 점수 레이어를 추가한 릴리즈입니다.
- 본진 분류 체계 v1.6 —
C-11연결어미 뒤 쉼표,C-12쉼표 포함률,E-5/E-6쉼표 기반 리듬 지표,G-3안전 균형 lexicon 추가 - 정량 점수 레이어 —
metrics.py와baseline.json으로 8개 지표를 계산하고risk_band와 z-score를 monolith 입력에 prepend - Fast mode 도구 호출 캡 보존 — monolith가 별도 파일을 더 읽지 않도록
01_input_with_metrics.txt에 점수와 원문을 함께 넣음 - v1.6.1 hotfix — fast mode 산출물을
final.md하나로 통합하고, 변경률·등급·자체검증·하이라이트는<!-- HUMANIZE-SUMMARY -->HTML 주석 블록에 저장
공식 검증에서는 v1.5가 약하게 잡던 연결어미 뒤 쉼표 지표가 개선됐고, 5편 일괄 테스트에서 등급 A와 도구 호출 캡이 유지됐다고 README에 정리되어 있습니다.
공식 v1.5는 v1.2~v1.4의 실험을 폐기하고 v1.1 단순 구조로 롤백한 뒤, 기본 경로에 monolith fast path를 추가한 릴리즈입니다.
- v1.2~v1.4 폐기 — voice profile, candidate pool, promotion checklist, sample collection 제거
- Monolith Fast Path 신설 —
humanize-monolith가 한 흐름에서 탐지·윤문·자체검증 처리 quick-rules.md신설 — 본진 taxonomy에서 S1/S2 핵심만 추린 fast 전용 룰북- Strict 모드 보존 — 정밀 검증·장문·부분 재실행은 기존 5인 파이프라인 유지
- 분류 체계 본진 유지 — C-9, C-10, D-7, H-3, I-3, I-4 보강 등 v1.2~v1.3.1의 유효 패턴은 보존
공식 검증 결과 기준, 같은 2,604자 칼럼에서 v1.4 detector 1콜은 7분 58초였고, v1.5 monolith 1콜은 3분 28초였습니다. 5인 파이프라인 25분 대비 약 86% 단축이라는 판단으로 v1.5가 발행됐습니다.
공식 발행 직후 본질 테스트에서도 5편 모두 등급 A, 자체검증 6/6 통과, 변경률 10~25% 안전 구간을 기록했다고 README에 정리되어 있습니다.
원본은 Claude Code 프로젝트 구조를 씁니다.
.claude/skills/humanize-korean/SKILL.md.claude/agents/*.md.claude/commands/humanize.md.claude/commands/humanize-redo.md
이 포트는 원본의 taxonomy, playbook, quick rules, agent role reference는 유지하되 Codex plugin 구조로 감쌌습니다.
plugins/im-not-ai/.codex-plugin/plugin.json.agents/plugins/marketplace.jsonplugins/im-not-ai/skills/humanize-korean/SKILL.mdplugins/im-not-ai/skills/humanize-korean/references/
Claude Code의 /humanize, /humanize-redo 슬래시 커맨드는 Codex에서 그대로 쓰지 않습니다. 대신 humanize-korean 스킬 트리거와 자연어 후속 명령으로 실행합니다.
원본에는 Next.js 15 App Router + Vercel Fluid Compute + AI Gateway 기반 웹앱 설계 reference가 포함돼 있습니다. 이 Codex 포트에서도 references/web-service-spec.md를 보존합니다.
로드맵은 원본과 동일하게 v0 MVP(익명·단일 호출) -> v1(로그인·히스토리) -> v2(Pro/Team · API · 웹훅) -> v3(Chrome Extension) -> v4(일본어·중국어 확장)입니다.
Original project by @epoko77-ai, licensed under MIT. 이 포트도 MIT License를 유지하며, 원본 reference 파일은 그대로 보존하고 Codex adapter layer만 추가했습니다.
정확한 원본 commit과 파일 매핑은 SOURCE.md를 참고하세요.
이 플러그인은 Codex skill instruction과 Markdown reference 파일만 포함합니다. 별도 MCP 서버, 앱 connector, 외부 API 호출, telemetry endpoint, background service를 추가하지 않습니다.
단, Codex 자체는 사용자의 Codex/OpenAI 설정에 따라 프롬프트를 처리할 수 있습니다. 민감한 글은 현재 Codex workspace와 계정 설정이 적절한지 확인한 뒤 넣으세요.
이 community port는 MIT License로 제공됩니다. OpenAI 공식 플러그인이 아니며, epoko77-ai/im-not-ai의 공식 Claude Code edition도 아닙니다.