voice-ai-slop-detect

name: voice-ai-slop-detect description: Use when scanning Docusaurus MDX files for AI-generated writing symptoms in Korean — cliché openers ("이제부터는", "자 그럼"), overly polite indirections, empty meta-sentences, bullet-point fragmentation, pronoun overuse, emotional filler adjectives, needless analogies. Only scan ai_editable zones indicated by frontmatter ai_assisted list. Do not scan human_only component props (MemberOpinion, DevilsAdvocate, BestPickCallout, VotingBar).

voice-ai-slop-detect

Overview

AI가 쓴 티 나는 한글 문장을 잡아내는 검증 스킬. 하지만 멤버가 쓴 글은 어색해도 진정성이므로 건드리지 않는다. Zone 경계가 이 스킬의 생명줄.

스타일 기준점: writing-voice-ff 스킬이 정의한 해요체·"코드를 읽는 사람" 관점이 이 파이프라인의 목표 어투다. 이 검사는 그 목표에서 벗어난 문장을 잡는 "반대쪽" 역할을 한다.

When to Use

• mdx-writer가 MDX 생성 직후, 파이프라인 품질 게이트
• 사용자가 "슬롭 재검사" 요청
• 특정 챕터가 "뭔가 AI 같다" 피드백 받았을 때

검사 대상 결정 (가장 중요)

MDX frontmatter의 ai_assisted 목록에 있는 섹션만 검사:

ai_assisted:
  - summary         # ← 이 H2 섹션만 검사
  - code_examples   # ← 코드 블록 주석만 (v1은 skip)
  - checklist       # ← 체크리스트 텍스트만

절대 검사하지 않는 것:

• <MemberOpinion>, <DevilsAdvocate>, <BestPickCallout>, <VotingBar> 컴포넌트 props 내용
• 코드 블록 안의 코드 자체 (// 주석은 v2에서 추가)
• frontmatter 필드 값

경계가 모호하면 skip 쪽으로 판단. 오탐보다 미탐이 낫다는 원칙을 뒤집지 말 것.

AI 슬롭 카탈로그 (한글 FE 맥락)

High severity (통과 0개)

Medium severity (3개까지 허용)

Low severity (10개까지 허용)

탐지 알고리즘

1. MDX 파싱 (remark/mdast) → frontmatter + body
2. body에서 JSX 컴포넌트 블록 제거 (<MemberOpinion> 등)
3. 남은 텍스트에서 ai_assisted 섹션 경계 식별 (H2 헤딩 기준)
4. 각 섹션에 위 카탈로그 정규식/휴리스틱 적용
5. finding 수집 + severity별 카운트
6. threshold 비교 → pass/fail

Finding 포맷

{
  "severity": "high" | "medium" | "low",
  "category": "상투구 서두",
  "line": 42,
  "column": 1,
  "excerpt": "이제부터는 변수 네이밍에 대해 알아보겠습니다",
  "suggestion": "본론으로 바로: '변수 이름은 의도를 드러내야 한다.'"
}

실패 시 피드백 루프

overall_result: fail 시:

1. 어느 섹션에서 fail인지 식별:
   • summary fail → chapter-editor 재호출
   • code_examples 주석 fail → fe-content-enhancer 재호출 (v2에서)
   • checklist fail → fe-content-enhancer 재호출
2. SendMessage에 report_path 포함
3. 재작성 후 이 스킬 다시 실행
4. 최대 2회 재시도, 3회째 fail이면 사용자에게 수동 검토 요청

오탐 방지 휴리스틱

원문 인용 구간

quote 블록 (>)이나 코드 블록 주석은 원문 인용일 가능성이 높음. 문맥 단서:

• 이전 paragraph에 "원서에서는", "McConnell은"이 나오면 해당 quote는 skip
• 체크리스트 중 "원서 부록" 언급이 있으면 skip

Human-only 경계 모호할 때

MDX에서 JSX 컴포넌트가 아닌 평문으로 멤버 의견이 노출되면 ai_editable로 오인 가능. 방지책:

• mdx-writer가 <!-- @human-only --> 주석을 삽입하도록 명시
• 이 스킬은 @human-only와 @human-only-end 주석 사이를 skip

출력 파일

_workspace/validation/chXX.report.json:

{
  "file": "docs/part-02/ch05.mdx",
  "validated_at": "2026-04-18T23:15:00+09:00",
  "overall_result": "pass",
  "findings": [],
  "zones_skipped": ["human_only"],
  "summary": { "high": 0, "medium": 2, "low": 5 },
  "sections_scanned": ["summary", "checklist"],
  "sections_skipped": ["member_opinions", "devils_advocate", "best_pick"]
}

Common Mistakes