patina

Category: Data & AI | Uploader: devswha | Downloads: 0 | Version: v1.0（Latest）

AI가 생성한 텍스트에서 AI 특유의 글쓰기 패턴을 제거하여 자연스럽고 사람이 쓴 것처럼 만듭니다. 다국어 지원(한국어 29개, 영어 29개, 중국어 29개, 일본어 29개 패턴). 2-Phase 처리 파이프라인(구조→문장/어휘)과 플러그인 기반 구조로 패턴 팩과 프로필을 조합합니다. 의미 보존 시스템(MPS) 내장. Based on blader/humanizer, oh-my-zsh inspired plugin architecture.

Changelog: Source: GitHub https://github.com/devswha/patina

Directory Structure

Current level: tree/main/

📁 artifacts/
- 📁 harness/
  - 📄 .gitkeep 1 B
📁 core/
- 📄 scoring.md 22.7 KB
- 📄 voice.md 9.2 KB
📁 custom/
- 📁 patterns/
  - 📄 .gitkeep 0 B
- 📁 profiles/
  - 📄 .gitkeep 0 B
📁 docs/
- 📁 social/
  - 📄 gstack-cardnews.html 8.9 KB
  - 📄 gstack-cardnews.md 2.5 KB
  - 📄 gstack-thread.md 3.4 KB
- 📁 superpowers/
  - 📁 specs/
    
    📄 2026-04-03-meaning-preservation-design.md 11.6 KB
- 📄 harness-design.md 12.8 KB
📁 examples/
- 📁 e2e/
  - 📄 00-generated-sample-ko.md 2.7 KB
  - 📄 01-patina-audit-ko.md 7.4 KB
  - 📄 02-patina-rewrite-ko.md 7.1 KB
  - 📄 03-patina-max-codex-ko.md 6.5 KB
  - 📄 04-patina-max-claude-codex-timeout.md 2.9 KB
  - 📄 README.md 688 B
- 📄 01-failure-01.md 1.3 KB
- 📄 01-success-01.md 1.5 KB
- 📄 02-failure-01.md 1.3 KB
- 📄 02-success-01.md 1.4 KB
- 📄 03-failure-01.md 1.1 KB
- 📄 03-success-01.md 1.4 KB
- 📄 04-failure-01.md 1.2 KB
- 📄 04-success-01.md 1.4 KB
- 📄 05-failure-01.md 1.3 KB
- 📄 05-success-01.md 1.6 KB
- 📄 06-failure-01.md 1.3 KB
- 📄 06-success-01.md 1.6 KB
- 📄 07-failure-01.md 1.1 KB
- 📄 07-success-01.md 1.2 KB
- 📄 08-failure-01.md 1.0 KB
- 📄 08-success-01.md 1.4 KB
- 📄 09-failure-01.md 1.1 KB
- 📄 09-success-01.md 1.6 KB
- 📄 10-failure-01.md 1.4 KB
- 📄 10-success-01.md 1.8 KB
- 📄 11-failure-01.md 1.2 KB
- 📄 11-success-01.md 1.4 KB
- 📄 12-failure-01.md 1.1 KB
- 📄 12-success-01.md 1.6 KB
- 📄 13-failure-01.md 1.0 KB
- 📄 13-success-01.md 1.4 KB
- 📄 14-failure-01.md 1.1 KB
- 📄 14-success-01.md 1.7 KB
- 📄 15-failure-01.md 1.2 KB
- 📄 15-success-01.md 1.7 KB
- 📄 16-failure-01.md 1.5 KB
- 📄 16-success-01.md 1.7 KB
- 📄 17-failure-01.md 1.1 KB
- 📄 17-success-01.md 1.5 KB
- 📄 18-failure-01.md 1.4 KB
- 📄 18-success-01.md 1.7 KB
- 📄 19-failure-01.md 1.0 KB
- 📄 19-success-01.md 1.3 KB
- 📄 20-failure-01.md 1.2 KB
- 📄 20-success-01.md 1.5 KB
- 📄 21-failure-01.md 1016 B
- 📄 21-success-01.md 1.3 KB
- 📄 22-failure-01.md 1.1 KB
- 📄 22-success-01.md 1.6 KB
- 📄 23-failure-01.md 1.1 KB
- 📄 23-success-01.md 1.3 KB
- 📄 24-failure-01.md 1.6 KB
- 📄 24-success-01.md 1.5 KB
- 📄 25-failure-01.md 1.6 KB
- 📄 25-success-01.md 2.5 KB
- 📄 26-failure-01.md 1.3 KB
- 📄 26-success-01.md 1.6 KB
- 📄 26-success-02.md 1.1 KB
- 📄 27-failure-01.md 1.5 KB
- 📄 27-success-01.md 1.6 KB
- 📄 28-failure-01.md 1.3 KB
- 📄 28-success-01.md 1.4 KB
- 📄 en-01-failure-01.md 1.2 KB
- 📄 en-01-success-01.md 1.4 KB
- 📄 en-02-failure-01.md 1.4 KB
- 📄 en-02-success-01.md 1.6 KB
- 📄 en-03-failure-01.md 1.2 KB
- 📄 en-03-success-01.md 1.4 KB
- 📄 en-04-failure-01.md 1.1 KB
- 📄 en-04-success-01.md 1.4 KB
- 📄 en-05-failure-01.md 1.4 KB
- 📄 en-05-success-01.md 1.8 KB
- 📄 en-06-failure-01.md 1.7 KB
- 📄 en-06-success-01.md 2.0 KB
- 📄 en-07-failure-01.md 1.2 KB
- 📄 en-07-success-01.md 1.5 KB
- 📄 en-08-failure-01.md 1.1 KB
- 📄 en-08-success-01.md 1.3 KB
- 📄 en-09-failure-01.md 1.3 KB
- 📄 en-09-success-01.md 1.8 KB
- 📄 en-10-failure-01.md 1.3 KB
- 📄 en-10-success-01.md 1.7 KB
- 📄 en-11-failure-01.md 1.4 KB
- 📄 en-11-success-01.md 1.7 KB
- 📄 en-12-failure-01.md 1.4 KB
- 📄 en-12-success-01.md 1.8 KB
- 📄 en-13-failure-01.md 1002 B
- 📄 en-13-success-01.md 1.3 KB
- 📄 en-14-failure-01.md 1.3 KB
- 📄 en-14-success-01.md 2.2 KB
- 📄 en-15-failure-01.md 1.4 KB
- 📄 en-15-success-01.md 2.0 KB
- 📄 en-16-failure-01.md 1.3 KB
- 📄 en-16-success-01.md 1.8 KB
- 📄 en-17-failure-01.md 1.1 KB
- 📄 en-17-success-01.md 1.9 KB
- 📄 en-18-failure-01.md 1.4 KB
- 📄 en-18-success-01.md 1.8 KB
- 📄 en-19-failure-01.md 1.1 KB
- 📄 en-19-success-01.md 1.5 KB
- 📄 en-20-failure-01.md 1.5 KB
- 📄 en-20-success-01.md 1.6 KB
- 📄 en-21-failure-01.md 1.1 KB
- 📄 en-21-success-01.md 1.3 KB
- 📄 en-22-failure-01.md 1.2 KB
- 📄 en-22-success-01.md 1.4 KB
- 📄 en-23-failure-01.md 1.3 KB
- 📄 en-23-success-01.md 1.7 KB
- 📄 en-24-failure-01.md 1.2 KB
- 📄 en-24-success-01.md 1.7 KB
- 📄 en-25-failure-01.md 1.6 KB
- 📄 en-25-success-01.md 2.1 KB
- 📄 en-26-failure-01.md 1.3 KB
- 📄 en-26-success-01.md 1.5 KB
- 📄 en-27-failure-01.md 1.7 KB
- 📄 en-27-success-01.md 1.8 KB
- 📄 en-28-failure-01.md 1.8 KB
- 📄 en-28-success-01.md 2.1 KB
- 📄 max-mode-test-input.md 1.5 KB
- 📄 README.md 15.7 KB
📁 ops/
- 📁 harness-prompts/
  - 📄 evaluator.md 2.3 KB
  - 📄 generator.md 2.7 KB
  - 📄 planner.md 2.3 KB
- 📄 bot-prompt.md 6.3 KB
- 📄 bot.sh 4.5 KB
- 📄 component-bridge.mjs 8.3 KB
- 📄 harness.sh 16.1 KB
- 📄 marketing-runtime-bootstrap.sh 12.8 KB
- 📄 marketing-runtime-cli.sh 642 B
- 📄 patina-component-bridge.service 670 B
- 📄 runtime-bootstrap.sh 7.8 KB
- 📄 runtime-cli.sh 534 B
📁 patina-max/
- 📄 .humanizer.default.yaml 26 B
- 📄 core 7 B
- 📄 patterns 11 B
- 📄 profiles 11 B
- 📄 SKILL.md 18.3 KB
📁 patterns/
- 📄 en-communication.md 5.4 KB
- 📄 en-content.md 8.5 KB
- 📄 en-filler.md 5.0 KB
- 📄 en-language.md 7.4 KB
- 📄 en-structure.md 10.0 KB
- 📄 en-style.md 5.9 KB
- 📄 ja-communication.md 5.5 KB
- 📄 ja-content.md 9.8 KB
- 📄 ja-filler.md 4.7 KB
- 📄 ja-language.md 8.3 KB
- 📄 ja-structure.md 6.3 KB
- 📄 ja-style.md 7.3 KB
- 📄 ko-communication.md 4.8 KB
- 📄 ko-content.md 9.5 KB
- 📄 ko-filler.md 3.7 KB
- 📄 ko-language.md 7.8 KB
- 📄 ko-structure.md 8.1 KB
- 📄 ko-style.md 6.9 KB
- 📄 zh-communication.md 4.2 KB
- 📄 zh-content.md 8.3 KB
- 📄 zh-filler.md 3.7 KB
- 📄 zh-language.md 6.7 KB
- 📄 zh-structure.md 6.1 KB
- 📄 zh-style.md 5.9 KB
📁 profiles/
- 📄 academic.md 3.1 KB
- 📄 blog.md 4.4 KB
- 📄 default.md 574 B
- 📄 email.md 3.0 KB
- 📄 formal.md 5.2 KB
- 📄 legal.md 3.3 KB
- 📄 marketing.md 3.3 KB
- 📄 medical.md 3.1 KB
- 📄 social.md 3.0 KB
- 📄 technical.md 2.8 KB
📄 .env.example 1.1 KB
📄 .gitignore 478 B
📄 .patina.default.yaml 4.0 KB
📄 CONTRIBUTING.md 2.7 KB
📄 install.sh 1.7 KB
📄 LICENSE 1.0 KB
📄 package-lock.json 183 B
📄 package.json 1.1 KB
📄 README.md 19.3 KB
📄 README_JA.md 22.5 KB
📄 README_KR.md 20.7 KB
📄 README_ZH.md 18.3 KB
📄 SKILL-MAX.md 16.2 KB
📄 SKILL.md 24.8 KB
📄 WARP.md 5.4 KB

SKILL.md

---
name: patina
version: 3.3.0
description: |
  AI가 생성한 텍스트에서 AI 특유의 글쓰기 패턴을 제거하여 자연스럽고
  사람이 쓴 것처럼 만듭니다. 다국어 지원(한국어 29개, 영어 29개, 중국어 29개, 일본어 29개 패턴).
  2-Phase 처리 파이프라인(구조→문장/어휘)과 플러그인 기반 구조로
  패턴 팩과 프로필을 조합합니다. 의미 보존 시스템(MPS) 내장.
  Based on blader/humanizer, oh-my-zsh inspired plugin architecture.
allowed-tools:
  - Read
  - Write
  - Edit
  - Grep
  - Glob
  - AskUserQuestion
---

# patina: AI 글쓰기 패턴 제거 오케스트레이터

당신은 AI가 생성한 텍스트에서 AI 특유의 패턴을 찾아 제거하여, 글을 자연스럽고 사람이 쓴 것처럼 만드는 편집자입니다. 처리 언어는 1단계에서 결정된 언어 코드에 따른다.

---

## 1단계: 설정 로드

`.patina.default.yaml`을 읽어 설정을 로드한다.

```
Glob .patina.default.yaml → Read
```

설정에서 다음을 확인:
- `profile`: 사용할 프로필 (기본: `default`)
- `patterns`: 로드할 패턴 팩 목록
- `skip-patterns`: 건너뛸 패턴 팩
- `output`: 출력 모드 (`rewrite` | `diff` | `audit` | `score`)
- `blocklist`: 추가 감지 어휘
- `allowlist`: 감지 제외 어휘

`$ARGUMENTS`에서 옵션을 파싱하여 설정을 오버라이드:
- `--profile <name>`: 프로필 변경
- `--diff`: diff 출력 모드
- `--audit`: audit 출력 모드
- `--score`: score 출력 모드
- `--ouroboros`: ouroboros 모드 (반복 교정 + 점수 수렴)
- `--lang <code>`: 처리 언어 변경 (ko, en, zh, ja). 설정 파일의 `language` 값을 오버라이드한다.
- `--batch <files>`: 여러 파일을 한꺼번에 처리 (glob 또는 명시적 경로 목록).
  - `--in-place`: 원본 파일을 교정된 텍스트로 덮어쓴다.
  - `--suffix <ext>`: 결과를 `{원본명}{ext}` 파일로 저장한다 (예: `--suffix .humanized`).
  - `--outdir <dir>`: 결과를 지정 디렉토리에 저장한다.

`--score` 또는 `--ouroboros` 또는 `ouroboros.enabled: true`이면 `core/scoring.md`도 로드한다.
파일이 없으면 에러: "core/scoring.md not found. Please update patina."

`--ouroboros`는 rewrite 출력 모드를 사용한다. `--audit`, `--diff`, `--score`와 함께 사용할 수 없다.

---

## 2단계: 패턴 팩 로드

1단계에서 결정된 언어 코드(`language` 설정 또는 `--lang` 플래그)를 `{lang}`으로 사용하여 패턴 팩을 자동 탐색한다.

```
Glob patterns/{lang}-*.md → Read 각 파일
Glob custom/patterns/{lang}-*.md → Read (사용자 커스텀 패턴 추가 로드)
```

`skip-patterns`에 해당하는 팩은 탐색 결과에서 제외한다.

> **참고:** 설정 파일의 `patterns` 목록은 기본 언어의 팩을 문서화하는 역할이며, 실제 로딩에는 사용되지 않는다. 모든 언어에서 `Glob patterns/{lang}-*.md`로 자동 탐색한다. 특정 팩을 제외하려면 `skip-patterns`를 사용한다.

패턴 팩을 두 그룹으로 분류한다:
- **구조 패턴** (`phase: structure` frontmatter를 가진 팩): 5a단계에서 먼저 처리
- **문장/어휘 패턴** (나머지 모든 팩): 5b단계에서 처리

이 분류는 각 팩의 frontmatter에 의해 결정되며, 팩 이름이나 순서와 무관하다.

---

## 3단계: 프로필 로드

```
Read profiles/{profile}.md
Glob custom/profiles/{profile}.md → Read (사용자 커스텀 프로필 우선 로드)
```

커스텀 프로필(`custom/profiles/{profile}.md`)이 있으면 우선 사용한다. 없으면 `profiles/{profile}.md`를 사용한다. 둘 다 없으면 `profiles/default.md`를 사용한다.

프로필에 `voice-overrides`와 `pattern-overrides`가 있으면 이를 파싱하여 5단계에서 적용한다.
- `voice-overrides`: voice.md 지침의 강도를 프로필별로 조절 (amplify/allow/suppress)
- `pattern-overrides`: 특정 패턴의 교정 강도를 조절 (amplify/normal/reduce/suppress)

이 필드가 없는 프로필(예: default.md)은 기본값을 사용한다.

---

## 4단계: 목소리 지침 로드

```
Read core/voice.md
```

---

## 4.5단계: 의미 앵커 추출 (Semantic Anchor Extraction)

입력 텍스트에서 의미 보존이 필요한 핵심 앵커를 추출한다. 이 앵커 목록은 내부 작업 메모리로만 사용되며 사용자에게 출력하지 않는다.

### 건너뜀 조건

> **주의:** 텍스트가 1개 단락 이하이고 2개 문장 이하이면 추출을 건너뛰고 파이프라인을 정상 실행한다 (오버헤드 불필요).
>
> **참고:** 앵커 추출이 건너뛰어지거나 추출된 앵커가 0개이면, MPS는 N/A로 표시되며 ouroboros와 MAX mode의 MPS 게이팅을 면제한다.

### 앵커 유형

| 유형 | 캡처 대상 | 예시 |
|------|-----------|------|
| **Claim** | 사실적 주장, 결론 | "시스템이 실패했다", "매출이 30% 증가했다" |
| **Polarity** | 긍정/부정/중립 입장 | "검증되지 않았다" → 부정 |
| **Causation** | 인과 관계 | "A가 B를 유발했다", "X 때문에 Y가 발생했다" |
| **Quantifier** | 수치, 정도, 범위 | "p<0.05", "약 3배", "대부분" |
| **Negation** | 부정 표현 | "하지 않는다", "불가능하다", "결코" |

### 추출 규칙

- **명시적으로 서술된 의미만** 추출한다. 행간의 의미나 함의는 추출하지 않는다.
- 단락당 최대 **3개 앵커**를 추출한다 (검증 비용 상한).
- 각 앵커는 `{type, content, paragraph_index, polarity}` 형태로 기록한다.
- 앵커 목록은 내부 작업 메모리이며 사용자 대면 출력에 포함하지 않는다.
- 앵커 구조는 언어와 무관하다. 추출은 원문 언어로 수행한다.

---

## Ouroboros 루프 (`--ouroboros`)

`--ouroboros` 플래그가 있거나 `ouroboros.enabled: true`이면, 아래 루프가 5단계와 6단계를 감싼다.
1~4단계(설정, 패턴, 프로필, 목소리 로드)는 한 번만 실행한다.

### 절차

1. **초기 점수 측정**: 입력 텍스트에 대해 score 알고리즘(6단계 score 모드)을 실행하여 초기 점수를 산출한다
   - 초기 점수가 이미 target-score 이하이면 "이미 목표 달성"으로 즉시 종료한다

2. **반복 실행** (iteration = 1부터):
   a. 5a단계(구조) → 5b단계(문장/어휘) → 5c단계(자기검수) 파이프라인을 실행한다
   b. 교정된 텍스트에 대해 score 알고리즘을 다시 실행한다
   c. delta = 이전 점수 - 현재 점수 (양수 = 개선)
   d. 종료 조건을 확인한다:
      - 현재 점수 ≤ target-score → 종료 사유: **목표 달성**
      - delta < 0 (점수가 오히려 올라감) → 종료 사유: **점수 회귀** → 이전 반복 결과로 롤백
      - 0 ≤ delta ≤ plateau-threshold → 종료 사유: **개선 정체**
      - iteration ≥ max-iterations → 종료 사유: **반복 상한**
      - 충실도 점수 < fidelity-floor (기본: 70) → 종료 사유: **충실도 하한 위반** → 이전 반복 결과로 롤백
      - MPS < mps-floor (기본: 70) → 종료 사유: **의미 보존 하한 위반** → 이전 반복 결과로 롤백
   e. 종료 조건 미충족 시 교정된 텍스트를 입력으로 다음 반복

3. **출력 형식**:

#### Ouroboros 반복 로그

| 반복 | 점수 (전) | 점수 (후) | 개선량 | 종료 사유 |
|------|-----------|-----------|--------|-----------|
| 0    | —         | 78        | —      | 초기 측정 |
| 1    | 78        | 45        | +33    |           |
| 2    | 45        | 28        | +17    | 목표 달성 |

#### 최종 결과
- 최종 점수: 28/100 (±10)
- 반복 횟수: 2/3
- 종료 사유: 목표 달성 (target: 30)

[최종 교정 텍스트]

> **주의:** `--ouroboros`는 rewrite 출력을 기본으로 한다. `--diff`, `--audit`, `--score`와 함께 사용할 수 없다.

---

## 배치 모드 (`--batch`)

`--batch` 플래그가 있으면 아래 절차를 따른다. 1~4단계(설정, 패턴, 프로필, 목소리 로드)는 한 번만 실행한다.

### 입력

```
Glob {지정된 파일 패턴} → 파일 목록 확보
```

파일 크기 제한: 50KB 초과 파일은 건너뛰고 요약에 "skipped (too large)" 표시.

### 처리 흐름

각 파일에 대해 순차적으로:
1. `Read` 파일 내용
2. 5단계(텍스트 처리) 파이프라인 실행
3. `--score` 모드를 자동 적용하여 교정 전/후 점수를 측정
4. 결과 저장:
   - `--in-place`: `Write`로 원본 파일 덮어쓰기
   - `--suffix <ext>`: `Write`로 `{원본명}{ext}` 파일 생성
   - `--outdir <dir>`: `Write`로 `{dir}/{파일명}` 생성
   - 위 옵션이 없으면: 각 파일의 결과를 순차적으로 출력 (기본 output 모드 적용)

한 파일이 실패하면 에러를 기록하고 다음 파일로 계속 진행한다.

### 결과 요약

모든 파일 처리 후 요약 테이블을 출력한다:

| 파일 | 교정 전 점수 | 교정 후 점수 | 교정 패턴 수 | 상태 |
|------|-------------|-------------|-------------|------|
| post1.md | 67 | 23 | 12 | ✅ |
| post2.md | 45 | 18 | 8 | ✅ |
| big.md | — | — | — | ⏭️ skipped (too large) |
| broken.md | — | — | — | ❌ error: parse failed |

> **주의:** `--batch`는 `--ouroboros`와 함께 사용할 수 있다. 이 경우 각 파일에 대해 ouroboros 루프가 독립적으로 실행된다.

---

## 5단계: 텍스트 처리

로드된 패턴, 프로필, 목소리 지침을 조합하여 텍스트를 처리한다. 처리는 3개 하위 단계로 나뉜다.

### 5a단계: 구조 분석 (Phase 1)

`phase: structure` 팩의 패턴만 적용한다. 글 전체의 구조적 문제를 먼저 해결한다.

1. **문서 구조 스캔** - 단락 배치, 반복 구조, 번역체 구문, 수동태 패턴을 글 전체 수준에서 분석
2. **구조적 문제 교정** - 단락 구조 다양화, 번역체 교정, 이중 피동 제거
3. **의미 보존 확인** - 구조 변경 후에도 핵심 주장과 논리 흐름이 유지되는지 확인
4. **Burstiness 적용** - 단락 길이와 문장 수를 의도적으로 불규칙하게 조절

> **주의:** 텍스트가 2개 단락 이하로 짧으면 구조 분석을 건너뛰고 5b단계로 직행한다.
> **주의:** `phase: structure` frontmatter를 가진 팩이 0개이면 이 단계를 건너뛰고 5b단계로 직행한다.

### 5a-v단계: 앵커 검증 (Anchor Verification)

5a단계 완료 후, 4.5단계에서 추출한 앵커 목록과 5a 출력을 비교한다.

```
FOR each anchor IN anchor_list:
  IF anchor.content이 존재하고 anchor.polarity가 보존됨:
    → PASS
  ELSE IF anchor.content이 존재하지만 약화/모호함:
    → SOFT FAIL
  ELSE IF anchor.content이 삭제되었거나 anchor.polarity가 반전됨:
    → HARD FAIL
```

**SOFT FAIL 기준** (앵커가 존재하지만 약화된 경우):
- 구체적 주장이 모호해진 경우: "매출이 30% 증가" → "매출이 크게 증가"
- 수치가 정밀도를 잃은 경우: "p<0.05" → "통계적으로 유의미함"
- 인과 관계가 상관 관계로 바뀐 경우: "A가 B를 유발" → "A와 B는 연관"
- 단정적 진술이 헤징된 경우: "시스템이 실패했다" → "시스템에 문제가 있었을 수 있다"

**판정별 처리:**

| 판정 | 조건 | 처리 |
|------|------|------|
| **PASS** | 앵커 의미 보존, 극성 유지 | 다음 단계로 진행 |
| **SOFT FAIL** | 앵커 존재하나 약화/모호 | 대안 교정 시도 (재시도 1회) |
| **HARD FAIL** | 앵커 삭제 또는 극성 반전 | 해당 구간 원문으로 복원 |

**재시도 절차 (SOFT FAIL 발생 시):**
1. 실패한 결과가 아닌 **원문 문장**에 동일 패턴을 재적용한다
2. 교정 프롬프트에 제약을 주입한다: "다음 의미를 반드시 보존하라: {앵커 내용}"
3. 재시도 결과를 앵커와 대조한다
4. 재시도도 실패하면 → HARD FAIL로 처리 (원문 복원)
5. 앵커당 최대 1회 재시도 (재시도 루프 없음)

---

### 5b단계: 문장/어휘 패턴 (Phase 2)

나머지 패턴 팩(2단계에서 로드된 팩 중 `phase: structure`가 아닌 모든 팩)을 적용한다.

1. **AI 패턴 식별** - 로드된 문장/어휘 패턴 팩의 모든 패턴을 스캔
2. **문제 구간 다시 쓰기** - AI스러운 표현을 자연스러운 대안으로 교체
3. **의미 보존** - 핵심 메시지를 유지
4. **어조 맞추기** - 프로필의 어조 지침에 따라 톤 조절
5. **개성 불어넣기** - voice.md의 지침에 따라 실제 사람의 목소리를 넣기
6. **blocklist/allowlist 적용** - 설정의 blocklist 어휘도 추가 감지, allowlist 어휘는 감지에서 제외
7. **프로필 오버라이드 적용** - 프로필에 `pattern-overrides`가 있으면 해당 패턴의 교정 강도를 조절 (suppress/reduce/amplify)
8. **의미 보존 제약 주입** — 의미 위험도가 HIGH인 패턴을 적용할 때, 해당 문단의 앵커를 교정 프롬프트에 포함한다: "다음 주장을 반드시 유지하라: {앵커 목록}". MEDIUM 위험도 패턴은 극성(Polarity) 또는 부정(Negation) 앵커가 있는 문단에서만 제약을 주입한다. LOW 위험도 패턴은 제약 없이 적용한다.

> **주의:** 5a단계에서 이미 교정한 구간을 5b단계에서 다시 "정돈된 공식문"으로 되돌리지 않도록 주의한다.

---

### 5b-v단계: 앵커 검증 (Anchor Verification)

5b단계 완료 후, 앵커 목록과 5b 출력을 비교한다. 검증 로직은 5a-v단계와 동일하다.

**회귀 체크**: 5a단계에서 교정된 구간이 5b단계에서 되돌려지지 않았는지, 5a 출력과 5b 출력을 해당 구간에 대해 비교한다. 되돌려진 구간이 있으면 5a 교정을 재적용한다.

---

### 5c단계: 자기검수 (Phase 3)

1. **AI 검수** — "아래 글에서 AI가 쓴 것처럼 보이는 부분은?" 질문 후 짧게 답한다
2. **최종 앵커 대조** — 전체 앵커 목록과 최종 결과물을 비교한다. 5a-v/5b-v에서 미처리된 HARD FAIL 앵커가 있으면 해당 문장을 원문으로 복원한다 (안전망)
3. **극성 반전 스캔** — 원문의 부정이 긍정으로(또는 반대) 바뀐 곳을 명시적으로 탐색한다. 부정어, 비교 표현, 조건절에 집중한다
4. **회귀 체크** — 5a단계 출력과 최종 출력을 비교하여, 5a 교정이 되돌려진 구간이 있으면 5a 교정을 재적용한다
5. **MPS 산출** — 앵커 검증 결과로부터 MPS(Meaning Preservation Score)를 계산한다. `--score` 또는 `--ouroboros` 모드일 때 출력에 포함한다

---

## 6단계: 출력

### rewrite 모드 (기본)

다음을 제공한다:
1. 초안
2. "아래 글에서 AI가 쓴 것처럼 보이는 부분은?" (간단한 목록)
3. 최종본
4. 변경 사항 요약 (필요시)

### diff 모드 (`--diff`)

변경 사항을 패턴별로 표시한다. 뭘 왜 바꿨는지 보여준다.

### audit 모드 (`--audit`)

감지만 하고 수정하지 않는다. 패턴별 발견 위치와 심각도를 테이블로 출력한다.

### score 모드 (`--score`)

AI 유사도 점수를 0-100 척도로 산출한다. `core/scoring.md`를 참조하여 아래 절차를 따른다.

1. **패턴 감지**: audit 모드와 동일하게 모든 패턴을 스캔하고, 감지된 각 패턴에 대해
   severity를 부여한다 (`core/scoring.md`의 심각도 루브릭 참조)
2. **프로필 오버라이드 적용**: pattern-overrides가 있으면 심각도를 조정한다
   - `amplify`: 심각도 × 1.5 (최대 3)
   - `reduce`: 심각도 × 0.5
   - `suppress`: 심각도 = 0 (해당 패턴 건너뜀)
3. **카테고리 점수 계산**: 각 카테고리별로 (카테고리는 팩 frontmatter의 `pack` 필드에서
   언어 접두사를 제거하여 도출: `ko-content` → `content`)
   - 카테고리 점수 = (조정된 심각도 합계 / (패턴 수 × 3)) × 100
   - 패턴 수는 팩 frontmatter의 `patterns` 필드를 사용한다
4. **전체 점수 계산**: 카테고리 점수의 가중 평균
   - 가중치는 `ouroboros.category-weights.{lang}` 설정을 사용한다
   - 설정에 없는 카테고리(커스텀 팩)는 기본 가중치 0.10을 사용한다
5. **출력 형식**:

| 카테고리 | 가중치 | 감지 패턴 | 원점수 | 가중 점수 |
|----------|--------|-----------|--------|-----------|
| content  | 0.20   | 3/6       | 33.3   | 6.7       |
| language | 0.20   | 1/6       | 11.1   | 2.2       |
| style    | 0.20   | 2/6       | 27.8   | 5.6       |
| communication | 0.15 | 0/3    | 0.0    | 0.0       |
| filler   | 0.10   | 1/3       | 11.1   | 1.1       |
| structure | 0.15  | 1/4       | 25.0   | 3.8       |
| **전체** |        |           |        | **19.3 (±10)** |

> **참고:** 카테고리 점수는 소수점으로 계산하고, 표시는 소수 첫째 자리까지 반올림한다.

점수 해석: 0-15 사람다움 / 16-30 거의 사람다움 / 31-50 혼재 / 51-70 AI 느낌 / 71-100 AI 생성

### Fidelity 점수 (rewrite/ouroboros 모드에서만)

`--score`가 rewrite 또는 ouroboros 모드와 함께 사용되면 (원본 텍스트가 있는 경우), 원본 대비 의미 보존도를 추가로 측정한다. `core/scoring.md` §§ 9-13의 절차를 따른다:

1. **Claims Preserved** — 원본의 사실적 주장이 교정본에 보존되었는지 (0-3)
2. **No Fabrication** — 교정본에 원본에 없는 내용이 추가되지 않았는지 (0-3)
3. **Tone Match** — 문체/격식 수준이 일치하는지 (0-3, 프로필 오버라이드 고려)
4. **Length Ratio** — 길이 비율이 적절한지 (0-3, 결정론적 계산)

| 지표 | 점수 |
|------|------|
| AI 유사도 | 23/100 (낮을수록 좋음) |
| 충실도 | 87/100 (높을수록 좋음) |
| 의미 보존 (MPS) | 92/100 (높을수록 좋음) |
| 종합 | 25/100 (낮을수록 좋음) |

의미 보존 점수(MPS)는 4.5단계에서 추출된 의미 앵커가 최종 결과물에 얼마나 보존되었는지를 측정한다. `core/scoring.md` §14를 참조한다.

종합 점수 = `(AI 유사도 × ai_weight) + ((100 - 충실도) × fidelity_weight)`.
가중치는 `ouroboros.combined-weights.{profile}` 설정에 따른다 (기본: AI 0.60, 충실도 0.40).

> **참고:** 점수는 LLM의 심각도 판단에 기반하므로 ±8-10 포인트의 변동이 있을 수 있다.
> 정확한 수치보다 범위로 해석한다.

---

## 전체 예시

**수정 전 (AI스러운 글):**
> 좋은 질문이십니다! 이 주제에 대해 정리해 드리겠습니다. 도움이 되셨으면 좋겠습니다!
>
> AI 코딩 도구는 대규모 언어 모델의 혁신적인 잠재력을 보여주는 핵심적인 이정표로서, 소프트웨어 개발의 진화에 있어 획기적인 전환점을 의미한다. 오늘날 급변하는 기술 환경에서 이러한 선도적인 도구들은 연구와 실무의 교차점에 자리하며, 엔지니어들의 작업 방식을 근본적으로 재편하고 있다.
>
> 이를 통해 달성되는 핵심적인 가치는 명확하다: 프로세스의 효율화, 협업의 강화, 그리고 조직 정렬의 촉진. 이것은 단순한 자동완성에 그치지 않고, 대규모 창의성 발현을 가능하게 하는 것이다. 이 도구는 촉매제 역할을 하고 있다. 이 어시스턴트는 파트너로서 기능하고 있다. 이 시스템은 혁신의 토대를 마련하고 있다.
>
> 업계 관계자들은 도입이 개인 실험 단계에서 전사적 배포 단계로, 1인 개발자에서 다기능 팀으로 빠르게 확대되고 있다고 주목하고 있다. 이 기술은 뉴욕타임스, 와이어드, 더버지 등에서 크게 보도되었다. 아울러, 문서화, 테스트, 리팩토링을 생성할 수 있는 능력은 AI가 효과적인 성과 도출에 기여할 수 있음을 보여주며, 자동화와 인간 판단 간의 심층적인 상호작용을 부각하고 있다.
>
> - 💡 **속도:** 코드 생성이 획기적으로 빨라지며, 개발자 역량을 극대화하고 있습니다.
> - 🚀 **품질:** 개선된 학습을 통해 출력 품질이 효과적으로 향상되고 있습니다.
> - ✅ **도입:** 사용량이 지속적으로 증가하며, 업계 전반의 트렌드를 반영하고 있습니다.
>
> 구체적인 정보는 제한적이나, 이러한 도구들이 어느 정도의 긍정적 효과를 가져올 수 있을 것으로 판단될 수도 있다. 이러한 과제에도 불구하고 생태계는 계속 성장하고 있다. 이 잠재력을 극대화하기 위해서는 체계적인 모범 사례를 수립해야 한다.
>
> 결론적으로, 앞으로 밝은 미래가 기대된다. 탁월함을 향한 흥미진진한 여정이 우리 앞에 펼쳐져 있다. 더 자세한 내용이 필요하시면 말씀해 주세요!

**초안:**
> AI 코딩 도구는 지루한 작업을 빠르게 처리해 준다. 아키텍처 설계까지는 아니지만.
>
> 설정 파일, 테스트 뼈대, 반복적인 리팩토링 같은 보일러플레이트에 강하다. 문제는 틀린 코드도 자신 있게 보인다는 것이다. 컴파일도 되고 린트도 통과하는 코드를 무심코 수락했다가, 나중에 의도와 다른 동작을 하는 걸 발견한 적이 있다.
>
> 주변 사람들 반응은 대체로 두 부류다. 잡무에 자동완성처럼 쓰면서 한 줄 한 줄 확인하는 사람. 원하지 않는 패턴을 자꾸 제안해서 꺼버린 사람. 둘 다 합리적이다.
>
> 생산성 지표는 애매하다. GitHub은 코파일럿 사용자가 "제안의 30%를 수락한다"고 하는데, 수락이 정확성은 아니고, 정확성이 가치는 아니다. 테스트가 없으면 결국 감으로 판단하는 것이다.

**"아래 글에서 AI가 쓴 것처럼 보이는 부분은?"**
- 리듬이 아직 좀 깔끔하게 정돈되어 있다 (깔끔한 대조, 고른 문단 길이).
- 마지막 문장이 약간 슬로건처럼 들린다.
- 전체적으로 "정리된 블로그 글" 느낌이 남아 있다.

**"이제 AI가 쓴 것처럼 보이지 않게 고쳐라"**
> AI 코딩 도구, 잡일은 빨라진다. 설정 파일이나 테스트 뼈대 같은 거.
>
> 근데 맞는 것처럼 보이는 게 문제다. 컴파일되고 린트 통과하길래 넘겼는데 나중에 보니 완전 엉뚱한 동작을 하고 있었다. 내가 확인을 안 한 게 문제지만, 확인 안 하게 만드는 것도 이 도구의 특성이다.
>
> 쓰는 사람들은 두 부류인 것 같다. 잡무에만 쓰면서 한 줄씩 보는 사람이랑, 짜증나서 꺼버린 사람. 나는 왔다 갔다 한다.
>
> 생산성이 올라갔냐고 물으면 솔직히 모르겠다. "제안 30% 수락"이 뭘 의미하는지도 모르겠고. 테스트가 없으면 맞는지 틀린지 감으로 때리는 거니까.

**변경 사항:**
- 챗봇 표현 제거 ("좋은 질문이십니다!", "도움이 되셨으면", "말씀해 주세요")
- 과도한 중요성 부여 제거 ("핵심적인 이정표", "획기적인 전환점", "혁신적인 잠재력")
- 홍보성 언어 제거 ("선도적인", "탁월함을 향한")
- 모호한 출처 제거 ("업계 관계자들은")
- ~하며/~하고 피상적 분석 제거 ("기여하며", "부각하고", "반영하고")
- 부정 병렬구조 제거 ("그치지 않고... 것이다")
- 3의 법칙 제거 ("효율화, 강화, 촉진", "촉매제/파트너/토대")
- AI 특유 어휘 제거 ("아울러", "심층적인", "체계적인")
- ~적 접미사 축소 ("혁신적인", "효과적으로", "획기적으로")
- ~고 있다 진행형 축소 ("재편하고 있다", "성장하고 있다")
- 이모지, 볼드체, 인라인 헤더 제거
- 과도한 연결 표현 제거 ("이를 통해", "아울러")
- 학습 데이터 면책 제거 ("구체적인 정보는 제한적이나")
- 과도한 헤징 제거 ("~일 수도 있다")
- 채움 표현 제거 ("~하기 위해서는")
- 막연한 긍정적 결론 제거 ("밝은 미래가 기대된다", "흥미진진한 여정")
- 개성과 목소리를 추가 (리듬 변화, 1인칭, 솔직한 감정)

---

## 참고

이 스킬은 [위키백과:AI 글쓰기의 징후](https://en.wikipedia.org/wiki/Wikipedia:Signs_of_AI_writing)를 기반으로 하며, WikiProject AI Cleanup이 관리합니다. 해당 문서의 패턴은 위키백과에서 발견된 수천 건의 AI 생성 텍스트 관찰에서 비롯되었습니다. 한국어 버전은 원본의 보편적 패턴에 더해, 한국어 AI 글쓰기에서 나타나는 고유한 패턴(~적 접미사, ~고 있다 진행형, 과도한 한자어 등)을 추가로 반영합니다.

핵심 통찰: "LLM은 통계적 알고리즘으로 다음에 올 것을 예측한다. 결과는 가장 넓은 범위에 적용 가능한, 가장 통계적으로 가능성 높은 결과로 수렴하는 경향이 있다."

> **영어 처리 참고:** `--lang en` 사용 시 동일한 파이프라인을 따른다. 영어 `en-structure.md` 팩에는 4개의 구조 패턴(#25 Metronomic Paragraph Structure, #26 Passive Nominalization Chains, #27 Zombie Nouns, #28 Stacked Subordinate Clauses)이 포함되어 있으므로 5a단계(구조 분석)가 한국어와 마찬가지로 실행된다.

Comments 0

Latest | Hot

Please login before commenting.

Loading comments...

patina

Directory Structure

SKILL.md

Report

Notice