주요 콘텐츠로 건너뛰기
AI 튜토리얼

STE80 Humanizer로 AI 텍스트 자연스럽게 다듬기: 설치, 모드 및 명확한 글쓰기 워크플로

지원되는 AI 코딩 에이전트에 STE80 Humanizer를 설치하고 사용하는 방법을 알아보세요. 이 튜토리얼에서는 2단계 편집 방식, Humanize·Light·Strict STE 모드, 문체 일치, 충실도 규칙, 포함된 Python 검사기를 설명합니다.

약 13분 소요
STE80 Humanizer로 AI 텍스트 다듬기: 설치, 모드 및 명확한 글쓰기 워크플로

STE80 Humanizer의 기능

STE80 Humanizer는 AI가 생성한 텍스트를 신중하게 작성한 사람의 글처럼 읽히도록 다시 작성하는 AI 에이전트 스킬입니다. 원문의 의미를 바꾸지 않고 명확성을 높이는 것이 목표입니다. AI 탐지기를 우회하려는 목적은 없습니다.

이 프로젝트는 두 가지 편집 방식을 결합합니다.

  1. Humanizer 단계: blader/humanizer의 목록과 Wikipedia의 AI 글쓰기의 징후를 바탕으로 AI 글쓰기의 일반적인 징후 26가지를 제거합니다.
  2. STE80 단계: 항공우주 정비 문서에 사용하는 통제 영어인 ASD-STE100에 약 80% 수준으로 맞추어 문장을 다시 구성합니다.

첫 번째 단계에서는 챗봇식 표현, 과장된 주장, 불필요한 한정어, 장식적인 서식, 모호한 권위 표현, 반복되는 수사 패턴 및 이와 유사한 습관을 제거합니다. 두 번째 단계에서는 더 짧은 문장, 능동태, 쉬운 단어, 문장당 하나의 주요 생각을 사용해 기본 문장 구조를 바로잡습니다.

두 단계를 사용하는 이유

눈에 띄는 AI 표현을 제거하는 것만으로는 충분하지 않습니다. 좋은 질문입니다나 원활한 경험 같은 표현을 없애도 문장이 여전히 읽기 어려울 수 있습니다. 문장에 여러 생각이 남아 있거나, 행위자가 드러나지 않거나, 설명 속에 지시가 묻혀 있을 수도 있습니다.

따라서 STE80 Humanizer는 먼저 표현을 정리한 다음 글을 다시 구성합니다. 다음과 같은 문장을 예로 들어 보겠습니다.

애플리케이션을 계속 사용할 수 있도록 kubelet이 컨테이너를 자동으로 다시 시작합니다.

두 번째 단계에서는 생각을 나누고 능동태를 사용합니다.

프로브가 실패하면 kubelet이 컨테이너를 다시 시작합니다. 이렇게 하면 애플리케이션을 계속 사용할 수 있습니다.

이 방식은 일반적인 글에 정식 Simplified Technical English의 모든 제한을 강요하지 않으면서도 결과를 직접적으로 유지하는 데 도움이 됩니다.

STE80 접근 방식 이해하기

ASD-STE100은 독자가 기술 정보를 정확하게 이해해야 하는 상황을 위해 만들어졌습니다. 이 구조는 짧은 문장, 단순한 동사 형태, 능동태, 일관된 용어, 명확하게 구분된 절차를 선호합니다.

Simplified Technical English 구조와 규칙 개요

엄격한 ASD-STE100은 어휘도 제한합니다. STE80 Humanizer는 기본적으로 이 부분을 완화합니다. 자연스럽고 일반적인 단어를 유지하면서 가독성을 높이는 구조 규칙을 적용합니다.

  • 문장마다 하나의 주요 생각만 사용합니다.
  • 능동태와 단순한 시제를 우선합니다.
  • If X, do Y.와 같이 조건을 먼저 배치합니다.
  • 지시와 설명을 구분합니다.
  • 절차와 복잡한 정보에는 목록을 사용합니다.
  • 하나의 대상에는 하나의 용어만 사용합니다.
  • 긴 명사 나열, 세미콜론, 복잡한 구두점을 피합니다.
  • 문단은 하나의 주제에 집중합니다.

기본 80% 수준에서는 문장이 더 자연스럽게 들리는 경우 권장 길이를 몇 단어 초과할 수 있습니다. check와 test 같은 일반적인 동사는 계속 사용할 수 있으며, 실제로 불확실한 경우에는 may나 should를 사용할 수 있습니다.

STE80 Humanizer 설치

skills CLI로 설치

Vercel skills CLI는 Claude Code, Codex, Cursor, OpenCode 및 기타 에이전트를 지원합니다. 스킬을 사용할 프로젝트에서 다음 명령을 실행합니다.

npx skills add Dodaios/ste80-humanizer

--global을 사용하지 않으면 현재 프로젝트에만 스킬이 설치됩니다.

특정 에이전트에 전역으로 설치하려면 다음 명령 중 하나를 사용합니다.

npx skills add Dodaios/ste80-humanizer --global --agent claude-code
npx skills add Dodaios/ste80-humanizer --global --agent codex
npx skills add Dodaios/ste80-humanizer --global --agent cursor

지원되는 모든 에이전트에서 사용할 수 있도록 하려면 다음을 실행합니다.

npx skills add Dodaios/ste80-humanizer --global --agent '*'

Claude Code 플러그인으로 설치

저장소의 마켓플레이스를 추가한 다음 플러그인을 설치합니다.

/plugin marketplace add Dodaios/ste80-humanizer
/plugin install ste80-humanizer@ste80-humanizer

Claude.ai 또는 Claude Desktop에 설치

  1. GitHub 저장소를 열고 Code를 선택합니다.
  2. 저장소를 ZIP 파일로 다운로드합니다.
  3. Settings, Capabilities, Skills 순서로 엽니다.
  4. ZIP 파일을 업로드합니다.

첫 번째 다시 작성 실행

설치한 후 스킬을 호출하고 명령 아래에 텍스트를 붙여 넣습니다.

/ste80-humanizer
다시 작성할 텍스트를 여기에 붙여 넣으세요.

에이전트에 텍스트를 사람답게 만들기, 단순화하기, AI 느낌 없애기 또는 STE 스타일로 다시 작성하기를 요청하면 스킬이 자동으로 시작될 수도 있습니다.

표준 방식으로 다시 작성하려면 다음과 같이 요청합니다.

This sounds like ChatGPT wrote it. Make it sound like a person.

기술 설명을 요청하려면 다음과 같이 입력합니다.

Explain how TLS handshakes work in STE.

파일을 지정할 수도 있습니다.

Rewrite this README 80% of the way to ASD-STE100.

Light touch: just remove the AI stuff from docs/intro.md.

Convert docs/runbook.md to strict STE.

스킬을 사용해 텍스트를 편집하지 않고 평가할 수도 있습니다. 다음과 같이 요구 사항을 직접 명시합니다.

Does this email sound like AI? Just tell me, don't rewrite it.

올바른 편집 모드 선택

Humanize 모드

Humanize는 일반적인 요청에 사용하는 기본 모드입니다. AI 표현 징후 26가지를 모두 검사한 다음, 완화된 80% 수준으로 구조 편집을 적용합니다. 이 모드는 작성자의 문체를 유지하면서 텍스트를 더 쉽게 읽을 수 있도록 하는 것을 목표로 합니다.

라이트 모드

라이트 모드는 원문이 이미 잘 작성되어 있고 약간의 정리만 필요할 때 유용합니다. 가볍게 다듬어 달라고 요청하거나 AI 티만 제거해 달라고 말하면 됩니다. 이 스킬은 1차 작업을 적용하고 가장 문제가 큰 문장만 재구성합니다.

엄격한 STE 모드

엄격한 STE는 전체 구조 작업을 100% 적용합니다. 일관된 표현이 대화체보다 중요한 절차서, 런북, 안전 참고 사항에 적합합니다.

엄격한 모드는 문장 길이와 어휘 선택을 더 엄격하게 제한합니다. 또한 축약형을 사용하지 않습니다. 하지만 이 스타일로 작성한 결과가 공식 ASD-STE100 표준을 자동으로 준수하는 것은 아닙니다.

번호가 매겨진 규칙이 편집 검토에 도움이 되는 방식

프로젝트의 SKILL.md 파일에는 번호가 매겨진 두 가지 규칙 집합이 있습니다. §1부터 §26까지의 규칙은 AI 문체의 징후를 다룹니다. S1부터 S15까지의 규칙은 STE80 구조를 다룹니다.

이 스킬은 §1, §8, S2와 같은 참조를 포함하여 편집 내용을 보고할 수 있습니다. 이를 통해 not-X-but-Y 구조를 제거한 이유, 반복되는 대시를 바꾼 이유, 문장을 짧게 만든 이유를 확인할 수 있습니다.

일부 패턴은 단독으로는 약한 근거로 표시됩니다. 여기에는 반복되는 문장 시작, 수식어의 연속 사용, 하이픈으로 연결된 쌍, 일부 수동태 표현이 포함됩니다. 이 스킬은 주변의 근거가 편집을 뒷받침할 때만 이러한 패턴을 문제로 간주합니다.

의미와 문체 보존

충실성은 이 작업 흐름의 핵심 요소입니다. 이 스킬은 사실과 불확실성을 그대로 유지하도록 설계되었습니다. may를 may로 유지하고, 40+와 같은 값을 보존하며, 근거 없는 주장을 추가하지 않고, 원문의 모순을 표시해야 합니다.

스킬이 여러분의 문체에 맞추도록 요청할 때 자신의 글 샘플을 포함하세요.

STE80 Humanizer를 사용하여 초안을 다시 작성하세요. 다음 글 샘플에 사용된 문장 길이, 어휘, 구두점을 따르세요.

여기에 자신의 글 샘플을 붙여 넣으세요.

초안:
여기에 초안을 붙여 넣으세요.

이렇게 하면 스킬이 막연한 인간적인 글쓰기 개념을 모방하는 대신 여러분이 선호하는 리듬에 대한 근거를 얻을 수 있습니다.

Python 린터로 파일 확인

저장소에는 외부 의존성이 없는 Python 린터인 scripts/ste_check.py가 포함되어 있습니다. 다음 명령으로 파일을 검사하세요.

python scripts/ste_check.py README.md

절차서나 런북에는 엄격한 검사를 사용하세요.

python scripts/ste_check.py --strict docs/runbook.md

표준 입력으로 텍스트를 전달할 수도 있습니다.

cat draft.txt | python scripts/ste_check.py -

이 검사기는 두 작업에서 확인할 수 있는 여러 측정 가능한 패턴을 표시합니다. 여기에는 챗봇 표현, 단계적으로 구성된 도입부, 완곡한 표현의 연속 사용, 모호한 권위 표현, 과장된 주장, 곡선형 따옴표, 긴 문장, 긴 문단, 세미콜론, 대시, 수동태, 진행형 또는 완료형 시제, -ing 형태, 구동사가 포함됩니다.

이 검사기는 휴리스틱 방식으로 작동합니다. AI 탐지기나 공식 ASD-STE100 준수 검사기가 아니며, 텍스트가 정확하다는 증거도 아닙니다.

고급 작업 흐름 팁

독자와 문서 유형을 명시하세요

README, 이메일, 설명문, 런북, 안전 참고 사항, 소셜 게시물 중 무엇을 편집하는지 스킬에 알려 주세요. 문서 유형에 따라 유용한 구조의 정도가 달라집니다. 엄격한 STE는 절차에 적합하지만, 일반적인 게시물에는 보통 더 가벼운 작업이 필요합니다.

변경하면 안 되는 내용을 지정하세요

그대로 유지해야 하는 정확한 사실, 숫자, 제품명, 조동사, 인용문을 나열하세요. 이렇게 하면 프로젝트의 충실성 우선 동작을 강화할 수 있습니다.

보고된 규칙 번호를 검토하세요

편집으로 인해 문체가 지나치게 바뀌었다면 인용된 규칙을 확인하세요. 필요한 명확성 개선만 유지하고 원래 문체를 복원하도록 에이전트에 요청하세요.

수동 편집 후 검사기를 실행하세요

유용한 작업 흐름은 다시 작성된 결과를 생성하고 직접 편집한 다음 ste_check.py를 실행하는 것입니다. 각 경고를 자동 오류가 아니라 검토를 위한 신호로 취급하세요.

창작 작업에는 적절한 작업 단계를 사용하세요

STE 구조는 명확한 설명문을 위해 설계되었습니다. 소설, 연설문, 브랜드 문구에는 프로젝트가 1차 작업만 적용합니다. 이렇게 하면 문체, 리듬, 의도적인 모호성에 의존하는 글이 단조롭게 바뀌는 것을 방지할 수 있습니다.

언어의 한계를 고려하세요

ASD-STE100은 영어 표준입니다. 다른 언어의 경우 이 스킬은 일반적인 표현의 징후 제거 원칙과 구조 원칙을 적용할 수 있지만, 영어 어휘 목록을 그대로 적용할 수는 없습니다.

포함된 평가 실행

evals/ 디렉터리에는 Claude 플러그인 평가 형식으로 작성된 네 가지 사례가 있습니다. README 다시 쓰기, 원본 설명문, 엄격한 런북, STE를 언급하지 않는 일반적인 LinkedIn 게시물입니다.

다음 명령으로 실행하세요.

claude plugin eval . --allow-tools Write,Edit,Bash

저장소에서는 이러한 테스트를 증명이 아니라 작은 신호로 설명합니다. 테스트 사례에서 보고된 가장 큰 이점은 충실성이었습니다. 이 스킬은 일반적인 프롬프트보다 사실, 수량, 불확실성을 더 안정적으로 보존했습니다.

중요한 제한 사항

  • 이 스킬은 주로 설명문과 기술 문서 작성에 사용됩니다.
  • 영어 이외의 언어에서는 영어 STE 어휘 목록을 사용할 수 없습니다.
  • STE와 유사한 문체로 작성한다고 해서 문서가 공식적으로 STE를 준수하게 되는 것은 아닙니다.
  • 공식적인 준수를 위해서는 ASD-STE100 사전, 교육받은 작성자, 검토가 필요합니다.
  • 이 프로젝트에는 공식 ASD-STE100 사양이나 사전이 포함되어 있지 않습니다.

결론

STE80 Humanizer는 표면 정리와 구조 편집을 결합합니다. 에이전트 스킬 또는 Claude Code 플러그인으로 설치한 다음 Humanize, Light 또는 Strict STE 모드를 선택하고 명확한 충실도 요구 사항을 제시하세요. 파일 기반 워크플로에서는 포함된 Python 검사기를 사용해 추가 검토가 필요한 패턴을 찾을 수 있습니다. 결과는 원문의 사실과 의도를 유지하면서 더 명확해진 텍스트여야 합니다.