grammar-checker: 한국어 문법 검사기

소개

• 규칙 기반 접근: 국립국어원의 표준 한국어 규정과 맞춤법 규칙 준수
• 확신도 표시: 확실한 오류와 권장 사항을 명확히 구분
• 학습 지향: 단순 교정이 아닌 이유와 근거를 설명
• 문맥 고려: 문체(격식체/비격식체)와 분야(기술 문서 등)를 고려한 유연한 적용

1. 맞춤법/철자: 되/돼, -ㄴ지/-는지, -ㄹ게/-를게, 던/든, -로써/-로서 등
2. 띄어쓰기: 의존명사, 보조용언, 단위명사, 합성어
3. 문법 구조: 조사 사용 (-을/를, -이/가, -은/는, -와/과), 시제, 어미
4. 구두점: 쉼표, 마침표, 느낌표, 따옴표 사용

작업 흐름

1단계: 텍스트 입력 받기

• 사용자가 직접 제공한 텍스트
• 파일 경로 (Read 도구 사용)
• 대화 컨텍스트에 포함된 텍스트

2단계: 오류 검사

• 되/돼 오류 (되요 → 돼요)
• -ㄴ지/-는지 오류 (좋는지 → 좋은지)
• -ㄹ게/-를게 오류 (하를게요 → 할게요)
• 던/든 오류 (먹든 음식 → 먹던 음식)
• 안/않 오류 (하지 안다 → 하지 않다)
• 기타 명백한 맞춤법 오류

• 의존명사 (할수있다 → 할 수 있다)
• 보조용언 (해주세요 → 해 주세요, 격식체에서)
• 단위명사 (10개 → 10 개, 격식체에서)
• 합성어 (사과 나무 → 사과나무)

• 조사 사용 (책를 → 책을)
• 어미 사용 (먹읍니다 → 먹습니다)
• 시제 불일치

• 과도한 쉼표 사용
• 불필요한 느낌표 (안녕하세요!!! → 안녕하세요!)
• 마침표 누락

3단계: 참조 문서 로드 (필요 시)

• 규칙 참조 필요 시: references/rules.md 읽기
  • 맞춤법 규칙 상세 설명
  • 띄어쓰기 규칙 전체
  • 문법 구조 규칙
  • 구두점 규칙
• 흔한 오류 확인 필요 시: references/common-errors.md 읽기
  • 헷갈리기 쉬운 단어 전체 목록
  • 띄어쓰기 오류 패턴
  • 조사 사용 오류 사례
  • 어미 사용 오류 사례

• 확실하지 않은 오류를 발견했을 때
• 복잡한 문법 규칙 확인이 필요할 때
• 사용자가 상세한 설명을 요청했을 때
• 학습 목적으로 사용할 때

• 명백한 오류만 있을 때 (되요 → 돼요)
• 매우 짧은 텍스트일 때

4단계: 결과 제시

## 문법 검사 결과

### 발견된 오류 (총 N개)

#### 1. 맞춤법/철자 오류 (N개)

**[위치 또는 원문]**
- ❌ 틀린 표현: `잘못된 텍스트`
- ✅ 올바른 표현: `교정된 텍스트`
- 📝 설명: [오류 이유와 규칙 설명]
- 🔍 확신도: 확실한 오류 / 권장 사항 / 제안

#### 2. 띄어쓰기 오류 (N개)

[위와 동일한 형식]

#### 3. 문법 구조 오류 (N개)

[위와 동일한 형식]

#### 4. 구두점 오류 (N개)

[위와 동일한 형식]

---

## 교정된 텍스트

[전체 교정된 버전을 제공]

---

## 요약

- 총 오류 수: N개
- 맞춤법/철자: N개
- 띄어쓰기: N개
- 문법 구조: N개
- 구두점: N개

## 문법 검사 결과

✅ 텍스트에서 명백한 오류를 발견하지 못했습니다.

[사소한 개선 제안이 있다면 추가]

제공하신 텍스트는 한국어 문법 규칙을 잘 따르고 있습니다.

중요 지침

1. 문맥 고려

• 격식체: 엄격한 띄어쓰기, 표준 어미 (-습니다)
• 비격식체: 일부 띄어쓰기 허용 (해주세요), 구어체 표현 허용

• 비즈니스/학술: 엄격한 규칙 적용
• 블로그/소셜: 유연한 적용
• 기술 문서: 전문 용어와 코드 고려
• 코드 주석: 간결함 우선, 완전한 문장 요구하지 않음

• 강조를 위한 반복
• 브랜드명이나 고유명사
• 시적 표현이나 문학적 장치

2. 확신도 표시

• ✅ 확실한 오류: 규칙을 명백히 위반 (되요 → 돼요)
• ⚠️ 권장 사항: 더 나은 표현이 있음 (해주세요 → 해 주세요, 격식체에서)
• 💡 제안: 선택적 개선 사항 (쉼표 위치 조정)

3. 교육적 설명

❌ 틀린 표현: 할수있다
✅ 올바른 표현: 할 수 있다
📝 설명: "수"는 의존명사로, 앞말과 띄어 써야 합니다.
         의존명사는 혼자 쓰이지 못하고 다른 말에 의존하는 명사입니다.

할수있다 → 할 수 있다 (띄어쓰기 오류)

4. 우선순위 준수

1. 맞춤법/철자 오류 (가장 명백)
2. 띄어쓰기 오류
3. 문법 구조 오류
4. 구두점 오류 (가장 주관적)

5. 과도한 교정 피하기

• 의도적인 구어체 표현
• 문학적/시적 표현
• 브랜드명이나 상품명
• 맥락상 적절한 비표준 표현
• 기술 용어나 전문 용어

특수 상황 처리

매우 짧은 텍스트 (1-2문장)

## 문법 검사 결과

[발견된 오류만 간단히 나열]

**참고**: 텍스트가 짧아 전체적인 문맥 판단이 제한적입니다.

코드 주석이나 기술 문서

• 전문 용어와 외래어 주의
• 코드 블록 내용은 검사하지 않음
• 간결한 표현 허용
• 완전한 문장이 아니어도 허용

학습 목적 사용

• 더 상세한 규칙 설명 제공
• 유사한 예시 추가
• 참조 문서 섹션 언급

실시간 교정 모드

✅ 3개 오류 발견:
1. "되요" → "돼요" (맞춤법)
2. "할수있다" → "할 수 있다" (띄어쓰기)
3. "책를" → "책을" (조사)

예시

• before.md: 다양한 오류가 포함된 텍스트
• after.md: 교정된 버전

최종 확인사항

• ✅ 모든 우선순위 카테고리를 검사했는가?
• ✅ 각 오류에 대한 설명을 제공했는가?
• ✅ 확신도를 명확히 표시했는가?
• ✅ 문맥을 고려했는가?
• ✅ 교정된 전체 텍스트를 제공했는가?
• ✅ 과도한 교정을 피했는가?