Humanize KR (im-not-ai): 한국어 AI 초안의 번역투를 다듬는 스킬
한국어 AI 초안의 사실·주장·수치·고유명사·인용을 보존하며 번역투와 기계적인 구조를 다듬는 CLI 스킬이다. 현 README는 v2.3.2이며 10개 카테고리·85개 하위 패턴(검증 대기 hold 1건 포함), 입력 상태별 light·standard·heavy 경로, 의미 보존과 과윤문 검사를 제공한다.
주요 기능
- light 1콜, standard 2콜, heavy 3+콜을 정량 route_hint로 선택. –strict는 heavy 고정
- 문자 변경률·진단 목표 달성·대구 전멸 방지·golden/수치 주입 차단 게이트
- 30% 초과 변경 경고, 50% 초과 강제 중단. 수치·직접 인용·법률 조문 등 보호
- /humanize-scan으로 6개 경험적 지표 빠른 점검, /humanize-redo로 부분 재처리
- author-context.yaml로 구조화된 필자 문체 조정. commit-ko는 별도 opt-in 부속 스킬
구조
Python 전처리 shim이 정량 지표와 route_hint를 만들고 monolith·diagnostician·finalizer 역할을 선택해요. 본체 모든 경로에 verify_gates.py 검증을 적용하며 Gemini·Copilot은 별도 단일 호출 배포예요.
누구에게 쓸모 있나요
AI 초안의 문체를 다듬고 원문 의미를 보존하려는 작성자.
설치 전 준비
- Claude Code는 플러그인 지원 버전. Codex CLI 0.121.0 이상, Gemini CLI 0.14.0 이상. Copilot CLI는 plugin 지원 필요하며 1.0.79-5에서 검증했다고 문서에 명시.
- 설치 스크립트는 macOS/Linux bash, Windows는 심링크 때문에 WSL 권장.
- 정량 전처리·게이트에 Python 3 스크립트 사용. 읽은 전처리 스크립트는 표준 라이브러리만 사용한다고 명시하며 전체 최소 Python 버전은 설치 가이드에 미명시.
- Claude·Codex는 전체 경로, Copilot은 단일 호출, Gemini는 별도 47패턴 확장.
- macOS·Linux, Windows 설치 스크립트는 WSL 권장.
설치 방법
Claude Code 권장
공식 문서의 설치 예시이며 이번 조사에서 실행하지 않았어요.
/plugin marketplace add epoko77-ai/im-not-ai
/plugin install humanize-korean@im-not-aiCodex CLI
공식 문서의 설치 예시이며 이번 조사에서 실행하지 않았어요.
git clone https://github.com/epoko77-ai/im-not-ai.git
cd im-not-ai
./install.sh --codex-onlyCLI 자동 감지 설치
공식 문서의 설치 예시이며 이번 조사에서 실행하지 않았어요.
git clone https://github.com/epoko77-ai/im-not-ai.git
cd im-not-ai
./install.shGitHub Copilot CLI
공식 문서의 설치 예시이며 이번 조사에서 실행하지 않았어요.
copilot plugin marketplace add epoko77-ai/im-not-ai
copilot plugin install humanize-korean@im-not-ai
copilot plugin listGemini CLI
공식 문서의 설치 예시이며 이번 조사에서 실행하지 않았어요.
gemini extensions install https://github.com/epoko77-ai/im-not-ai.git사용 방법
- Claude: /humanize-korean 또는 /humanize [텍스트/경로]. 자연어 ‘이 AI 글 자연스럽게 윤문해줘’도 지원.
- Codex: $humanize-korean을 사용해 이 글의 AI 티를 없애줘. 정밀 검토는 –strict 명시.
- Copilot: humanize-korean 스킬로 이 글을 자연스럽게 윤문해줘.
- 결과·원문·메트릭·진단 등은 실행 cwd의 _workspace/{실행날짜-번호}/에 저장. 최종 산출물은 final.md.
비용과 API 키
MIT 무료 배포이나 선택한 CLI/모델 비용 별도. light/standard/heavy의 콜 수가 비용에 영향, 확정 가격 없음.
라이선스
루트 LICENSE에서 MIT를 확인했어요. Copyright (c) 2026 epoko77-ai. 사용·수정·상업적 재배포가 허용되며 저작권 고지와 라이선스 사본 유지, 무보증 조건을 준수해야 해요.
주의사항과 알려진 이슈
- Claude/Codex는 전체 3경로, Copilot은 단일 호출만. Gemini는 47패턴 내장 독립 확장 v1.5.0으로 본체 85패턴·route_hint·결정적 게이트가 적용되지 않음.
- README 일부 옛 설명은 스킬 3개라 기재하지만 최신 INSTALL.md는 Claude 스킬 4개라고 명시. INSTALL.md 마지막 Gemini 문단의 ‘다콜은 Claude 전용’도 앞의 Codex 전체 경로 설명과 불일치.
- AI 작성 여부를 단일 패턴·지표로 판정할 수 없다. AI 탐지기 우회나 학술·저널리즘 진실성 보증 도구가 아님.
- 자동 업데이트는 git pull과 재설치를 수행하므로 검토하지 않은 upstream을 자동 연결. 신뢰하는 저장소에만 적용하라는 공식 경고.
- 심링크 설치는 원본 저장소 이동/삭제 시 깨짐. –copy 설치본은 uninstall.sh가 자동 삭제하지 않음. –force는 기존 파일을 백업 후 덮어씀.
- 원문과 중간 산출물이 로컬 _workspace에 남는다. 모델에 전달할 비공개 원문과 보관 디렉터리의 접근권한을 검토.
- README에 제시된 시간·토큰 절감·정확도는 자체 실측이며 환경별 보장 아님.
확인 범위
확인 날짜: 2026-11-05
확인 커밋: b37e0206d31fffd9149bf57168d4d62eb2086bee
확인한 범위: 공식 GitHub API·README·LICENSE를 읽고 main 커밋 SHA에 고정한 README와 blob 일치 확인. 설치·실행 테스트는 하지 않음. 공개·비보관 상태이며 원래 요청한 저장소 이름과 일치해요.
확인 한계: 대상 프로그램 설치·실행·모델 호출은 하지 않았어요. 호환성·품질·성능·전체 보안 감사 및 별도 배포 채널 최신성은 미검증이에요.