document-haness/.agents/skills/reducing-ai-like-korean-writing/README.md

# reducing-ai-like-korean-writing

한국어 글에서 상투적 연결어, 추상 명사화, 행위자 없는 피동, 근거 없는 일반 효용, 과잉 구조화, 반복 요약처럼 **AI 생성 글과 비슷하게 느껴질 수 있는 패턴**을 줄이는 Agent Skill이다.

이 스킬은 작성 주체를 판정하지 않는다. 목표는 AI 탐지기 우회가 아니라 문장의 직접성, 구체성, 정보 밀도와 작성자 목소리를 개선하는 것이다.

## 구성

```text
reducing-ai-like-korean-writing/
├── SKILL.md
├── README.md
├── references/
│   ├── decision-policy.md
│   ├── genre-profiles.md
│   ├── output-modes.md
│   ├── pattern-catalog.md
│   └── source-basis.md
├── scripts/
│   └── validate_skill.py
└── tests/
    ├── baseline-observations.md
    ├── cases.json
    ├── evaluation-rubric.md
    └── pressure-scenarios.md
```

## 사용 예

```text
다음 기술 블로그 초안에서 AI가 쓴 것처럼 느껴지는 추상 표현과 반복을 줄여 주세요. 사실, 기술 용어, 단정 강도는 바꾸지 마세요.
```

```text
이 설계 문서를 audit 모드로 검토하세요. AI 작성 여부는 판단하지 말고, 정보 전달을 방해하는 문체 패턴만 찾아 주세요.
```

```text
이 발표 대본을 standard 강도로 다듬되, 말하기 위한 반복과 원래 말투는 보존하세요.
```

## 문법 교정 스킬과의 순서

게시용 결과를 만들 때 권장 순서는 다음과 같다.

```text
초안 작성
→ reducing-ai-like-korean-writing
→ editing-korean-grammar-and-expression
→ 최종 사실·서식 검증
```

문법 교정을 먼저 한 뒤 문체를 다시 쓰면 재작성 과정에서 새로운 맞춤법·띄어쓰기 문제가 생길 수 있다.

## 설치

스킬 폴더를 사용하는 에이전트의 스킬 디렉터리에 그대로 복사한다. 일반적인 프로젝트 단위 위치는 다음과 같다.

```text
.agents/skills/reducing-ai-like-korean-writing/
```

클라이언트마다 개인 스킬 디렉터리는 다를 수 있다.

## 검증

```bash
python scripts/validate_skill.py
```

구조 검사는 패키지 형식과 테스트 데이터의 일관성을 확인한다. 실제 문체 개선 효과는 `tests/pressure-scenarios.md`와 `tests/cases.json`을 독립 에이전트의 스킬 전후 조건에서 실행해 검증한다.