shu​ren​hua – 중국어 우선 "인간다운 말로" 편집 스킬

무엇인가

shu​ren​hua는 생성형 AI 채팅 어시스턴트(Claude, Grok, ChatGPT, Cursor 등)에 로드하는 텍스트 편집 스킬(프롬프트/규칙 세트)입니다. 목적은 중국어 산문을 정리하는 것입니다. 상투적인 표현, 반복적인 서두, 딱딱한 어조를 제거하면서 원래의 사실, 조건, 약속, 저자의 목소리를 유지합니다. 영어 텍스트와 다시 쓰지 않고 문제만 플래그하는 "검토 전용" 요청에도 작동합니다.

누가 사용할까

• README 파일, 릴리스 노트, 이슈 댓글 또는 내부 동기화 메시지를 작성하는 개발자.
• 간결하고 전문 용어가 없는 중국어 버전의 문서를 원하는 기술 문서 작성자 및 제품 관리자.
• 중국어 기사를 초안하고 의미를 잃지 않으면서 자동으로 "인간다운" 다듬기를 원하는 모든 사람.

작동 방식(리포지토리에서)

1. 스킬 정의 – 핵심 편집 로직은 세 개의 마크다운 파일에 있습니다:
   • SKILL.md – AI가 로드하는 진입점.
   • references/editing‑guide.md – 세부 경계(변경 가능한 것, 유지해야 할 것).
   • references/examples.md – 나란히 비교되는 전후 예시.
2. 설치 – runtime-files.json에 나열된 세 파일을 AI 어시스턴트가 스킬을 스캔하는 디렉토리에 복사합니다. 세 가지 배포 버전이 제공됩니다:
   • mini – 일회성 프롬프트용 단일 자체 포함 마크다운(dist/shuorenhua‑mini.md).
   • lite – SKILL.md만(필요 시 참조 파일로 폴백).
   • full – 가장 완전한 동작을 위한 세 파일 모두. 여러 인기 도구(Codex, Claude Code, Cursor/Windsurf, OpenClaw, ChatGPT)에 대한 설치 지침이 제공됩니다.
3. 실행 – 원본 텍스트를 짧은 지시와 함께 AI에 제공합니다. 예:

   把这段去掉套话，保留信息和我的口气：……
   

   모델은 규칙에 따라 구절을 다시 쓰고 정리된 버전(또는 "검토 전용"을 요청한 경우 문제 목록만)을 반환합니다.
4. 제어 세분성 – 스킬은 세 가지 범위를 인식합니다:
   • structural – 자유 편집, 문장 병합 또는 재정렬 가능.
   • bounded – 문장 내 정리만; 전체 문장 삭제는 허용되지만 병합은 불가.
   • in‑place – 문장 삭제나 병합 없음; 단어 수준 조정만. 사용자는 요청의 키워드로 범위를 선택합니다.
5. 안전 검사 – 규칙은 명시적으로 유지합니다:
   • 숫자, 조건, 약속, 귀속.
   • 코드 블록(주석 포함)은 사용자가 명시적으로 편집을 요청하지 않는 한 변경되지 않습니다.
   • 인용, UI 문자열, 제목.
   • 출처가 없는 진술("研究表明")은 사용자가 제거를 요청하지 않는 한 유지됩니다.

평가 및 품질

• 벤치마크: 123개 테스트 케이스(65개 "개선 대상" 텍스트, 58개 일반 텍스트) + 20개 시나리오 샘플 및 10개 장문 인간 기사.
• 모델 커버리지: Claude Opus 5는 136개 대상 케이스 통과; Grok 4.6은 56개 통과.
• 지표: 하드 실패 0건(정보 손실 또는 작업 누락), 일반 텍스트 오편집률 <10%, 긍정 샘플 편집 중 최소 5/7에서 명확한 이점.
• 자세한 결과는 evals/results‑v2.5.0.md 및 기준 파일 evals/v2.5/criteria.md에 있습니다.

적합하지 않은 경우

• 본격적인 AI 글쓰기 감지기 또는 "AI 없는" 텍스트를 보장하는 도구가 필요한 경우, 이 스킬은 제공하지 않습니다.
• 주로 중국어용입니다. 영어는 지원되지만 규칙 세트는 중국어 표현에 맞게 조정되었습니다.
• 코드 로직을 다시 쓰지 않습니다. 코드 펜스 내의 문서 스타일 텍스트만 처리합니다.

라이선스 및 커뮤니티

• MIT 라이선스로 오픈소스.
• Bad-Case 템플릿을 통한 기여를 환영합니다. 이슈에는 원본 텍스트, 요청, 모델 출력이 포함되어야 합니다.
• 리포지토리는 스타 성장을 추적하고 변경 로그를 제공합니다. 최신 안정 버전은 v2.5.1(유지보수 릴리스)입니다.

---

위의 모든 정보는 리포지토리의 README에서 직접 가져온 것입니다. 외부 가정은 추가되지 않았습니다.