MrGeDiao/shuorenhua

shuorenhua (说人话) – 중국어 AI 스타일 "인간화" 스킬

무엇인가 – Codex, Claude Code, Cursor, ChatGPT 등 LLM 기반 에이전트에 삽입 가능한 경량 스킬. 중국어 텍스트를 일반적인 AI 생성 응답처럼 들리지 않도록 재작성합니다. 과도한 정중한 인사, 엔지니어링 용어, 마케팅 용어, 번역 풍 표현, 근거 없는 권위 주장과 같은 전형적인 "AI 톤" 패턴을 제거하지만, 모든 사실 정보 (숫자, 버전, 명령어, 에러 메시지, 출처, 타임스탬프)는 정확히 그 자리에 그대로 유지합니다.

왜 사용할까

시나리오	shuorenhua의 기능
캐주얼 채팅	불필요한 인사와 영업적인 마무리 문구를 제거해 자연스러운 대화 유지.
기술적 상태 업데이트	사실, 버전 번호, 명령어 스니펫, 에러 로그는 그대로 유지하되, 빈 텍스트의 "진행 상황" 표현은 제거.
README / 릴리스 노트	명확한 변경 목록, 버전, 검증 단계, 제한 사항을 표시. 프로모션용 허풍은 없음.
포럼 게시물 / 이슈 응답	기계적인 공지가 아니라, 성실한 유지보수자처럼 읽힘.
장문의 중국어 기사	빈 문장 제거, 인간의 승인을 위한 "제안 삭제" 목록으로 표시. 원래 길이와 핵심 정보는 완전히 보존.

작동 방식

1. 장면 탐지 – 입력이 채팅, 상태, 문서, 공개 글인지 판단하고, 적절한 장면 팩 (README, 릴리스노트, 포럼게시물 등)을 로드.
2. 보호 구간 추출 – 숫자, 버전 문자열, 파일 경로, 명령어 라인, 에러 추적, 이름, 책임 진술 등을 자동으로 잠금.
3. 강도 등급 분류 – 텍스트를 Tier 1/2/3로 분류하고, 재작성 강도(최소/표준/강력)와 범위(구조적/제한적/현장 내) 선택.
4. 패턴 기반 재작성 – 중국어 AI 스타일 패턴의 정교한 사전을 적용. 단순 찾기-바꾸기 아님.
5. 정확도 검사 – 출력을 다시 읽어 보고, 모든 보호 구간과 사실 관계가 변경되지 않았는지 확인.
6. 잔여 감사 – 두 번째, 가벼운 단계에서 남은 "AI 풍" 잔재만 수정.

규칙 세트는 references/에 위치 (긍정적 스타일 가이드, 보호 구간 목록, 장면 팩 정의). 의도적으로 엄격: 숫자는 대상과 연결된 상태로 유지, 관계는 변경 불가, 시간 범위는 단축 불가, 새로운 사실은 창출 불가.

시작하기 (약 30초)

• ChatGPT (Plus/Pro) – 호스팅된 "说人话 GPT" 링크 사용. 텍스트를 붙여넣고 "把这段去 AI 味" 요청.
• Claude Code – README에 표시된 두 개의 플러그인 명령어 실행 후 把这段去 AI 味 입력.
• Codex – 리포지토리 복제 후 다음과 같은 단일 명령어 실행:

  codex exec -C . "读取 ./SKILL.md，按其中规则改写以下文本：…"
  

• 기타 에이전트 – npx skills add MrGeDiao/shuorenhua (또는 플랫폼별 install/*.md 문서 따름).

장문 문서의 경우, 주석 모드 (只标注不改写)를 요청해 실제 변경 없이 제안 삭제 목록만 받을 수 있음.

평가

• evals/benchmark.md에 103개 사례 (57개 "변경 필수", 46개 "유지 필수")의 공개 벤치마크 제공.
• 모델별 결과 보고 (Codex, Claude), 하드 제약 위반(L1), 거짓 양성률(SNF), 스타일 목표 메트릭(L2). 최신 릴리스(v2.3.0)는 블라인드 테스트 세트에서 하드 제약 위반 0건, 거짓 양성률 <10%.
• 자동화 스크립트 (automation/eval/hard_metrics.py)는 장문 처리 시 길이 보존, 대시 밀도, 보호 구간 무결성 계산.

설치

플랫폼	문서
Codex	install/codex.md
Claude Code	install/claude-code.md
Cursor / Windsurf	install/cursor.md
OpenClaw	install/openclaw.md
ChatGPT / 커스텀 GPT	install/chatgpt.md

스킬의 핵심은 단일 파일 SKILL.md; 장면 팩, 보호 구간 목록을 포함한 기능 사용 시 references/ 디렉터리 포함 필요.

라이선스 – MIT.

---

TL;DR – shuorenhua는 LLM 기반 에이전트용 중국어 "인간화" 스킬로, AI 스타일의 반복 표현을 제거하면서도 사실의 정확성을 보장합니다. 규칙 기반 패턴 매칭, 장면 인식 기반 강도 설정, 이중 검증 파이프라인을 통해 작동하며, 주요 AI 어시스턴트 플랫폼용 철저한 벤치마크와 간편한 설치를 제공합니다.