Blog Humanize Fast
블로그 최종 원고를 meaning-preserving 방식으로 윤문한다. 이 스킬은 초안 작성
스킬이 아니다. 이미 저자가 쓴 한국어 블로그 본문에서 번역투, 기계적 병렬,
관용구, 접속사 남발, 리듬 균일성 같은 AI 티를 보수적으로 줄인다.
입력
- 파일 경로:
.md,.mdx,.txt본문 파일. - 붙여넣은 텍스트: 8,000자 이하 권장.
- frontmatter가 있는 MDX는 가능하면 frontmatter를 제외한 임시 본문 파일을 만들어 실행한다. frontmatter 필드값은 윤문 대상이 아니다.
실행
- 이 스킬 디렉터리의
references/quick-rules.md를 룰북으로 사용한다. - Workflow 도구가 있으면
workflows/blog-humanize-fast.js를 실행한다.workflowPath:{SKILL_DIR}/workflows/blog-humanize-fast.jsargs:{ inputPath, genre: "블로그", intensity: "보수", quickRulesPath: "{SKILL_DIR}/references/quick-rules.md" }
- Workflow 도구가 없으면(Codex 등 다른 런타임 포함) 이 스킬은 실행할 수 없다.
사용자에게 Claude Code에서 실행하라고 명시하고, 현재 런타임에
humanize-korean스킬이 있으면 그 Fast Path를 대안으로 안내한다. 일반 채팅 답변으로 윤문을 흉내 내지 않는다.
동작 계약
- 의미 불변이 최상위 규칙이다. 사실, 주장, 수치, 날짜, 금액, 고유명사, 직접 인용, 코드, URL, 마크다운 구조, JSX 태그/속성은 수정하지 않는다.
- YAML frontmatter, 코드펜스(```·~~~), 4칸 이상 들여쓴 indented code 블록은 보호 청크로 격리해 byte-identical로 보존한다. 청크 사이 원본 개행은 그대로 두어 재조립이 무변경 시 원문과 동일해야 한다(무결성 게이트).
- 청크별 fidelity 검증이 실패하면 1회만 재시도하고, 다시 실패하면 해당 청크는 원문으로 롤백한다. 청크 변경률이 50%를 넘으면 fidelity와 무관하게 롤백하고, 전체 변경률이 30%를 넘으면 경고를 남긴다.
- 전역 naturalness와 잔존 S1/S2 탐지는 별도 축으로 수행한다.
- 표적 수정은 지적 span만 대상으로 1라운드만 수행하고, 수정본은 fidelity 게이트를 통과할 때만 채택한다(실패 시 수정 전 본문 유지).
- 결과는 자동 반영하지 않는다. 최종본, 변경 통계, residual count를 보고하고 사용자가 수락할 때만 원문 파일에 반영한다.
폴백
- Workflow 실행 실패, quick-rules 읽기 실패, 모델 subcall 실패 원인은 그대로 보고한다.
- 사용자가 더 정밀한 검증을 요구하거나 결과 등급이 낮으면
humanize-korean --strict로 재검증하라고 안내한다.