DongHyeonkaandClaude Opus 5
1099834617
미추적 파일과 미커밋 수정을 전부 담아 pre-harness-removal 태그의 복구 범위를 확보한다. .agents/skills/writing-natural-korean 9개와 korean-technical-blog-skills-bundle-v1 61개가 여기 포함된다. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
86 lines
4.5 KiB
Markdown
86 lines
4.5 KiB
Markdown
---
|
|
name: editing-korean-grammar-and-expression
|
|
description: Use when revising Korean text that may contain spelling, spacing, grammar, honorific, register, or expression problems, especially when meaning, formatting, terminology, code, quotations, and intentional voice must remain unchanged.
|
|
---
|
|
|
|
# 한국어 문법·표현 윤문
|
|
|
|
## 개요
|
|
|
|
한국어 문장을 **보수적으로 교정하고 필요한 범위만 윤문**한다. 핵심 원칙은 다음과 같다.
|
|
|
|
> 맞는 표현을 틀렸다고 바꾸지 않는다. 의미·사실·문체를 바꿀 위험이 있으면 수정하지 않고 보류한다.
|
|
|
|
이 스킬은 표준어 기반의 일반 한국어를 기본 대상으로 한다. 맞춤법·띄어쓰기·문법 오류는 교정하지만, 자연스러움·간결성·문체 취향은 사용자가 요청하지 않는 한 제안으로만 다룬다.
|
|
|
|
## 기본 입력
|
|
|
|
가능하면 다음 정보를 사용한다. 없으면 문맥에서 추론하되, 교정을 막는 중의성이 있을 때만 경고한다.
|
|
|
|
- 원문
|
|
- 목적: 교정, 윤문, 표준화, 학습용 설명
|
|
- 문서 유형과 독자
|
|
- 보존할 용어·고유 명칭·말투
|
|
- 출력 모드
|
|
|
|
## 필수 절차
|
|
|
|
1. **범위 결정:** 강제 규범 교정과 선택적 문체 개선을 분리한다.
|
|
2. **보호 구간 식별:** 코드, URL, 전자 우편, 경로, 명령어, 식별자, 직접 인용, 사용자가 잠근 구간을 읽기 전용으로 둔다.
|
|
3. **문맥 판정:** 표면 문자열만 보지 말고 품사·뜻·앞뒤 문장을 함께 본다.
|
|
4. **최소 수정:** 같은 정확성을 얻을 수 있다면 공백 수정, 한 어절 수정, 문장 재작성 순으로 선호한다.
|
|
5. **불변식 검증:** 부정, 조건, 시제, 양태, 수치, 고유 명칭, 기술 용어, 높임 등급, 마크다운 구조가 유지됐는지 확인한다.
|
|
6. **보류:** 복수 해석이 남거나 전문 용어·고유 명칭 가능성이 있으면 원문을 유지하고 경고한다.
|
|
|
|
## 판정 기준
|
|
|
|
| 등급 | 조건 | 처리 |
|
|
|---|---|---|
|
|
| A | 공식 규범을 직접 적용할 수 있고 해석이 하나임 | 자동 교정 |
|
|
| B | 품사·뜻·문맥이 일치하고 경쟁 분석이 없음 | 자동 교정 + 필요 시 근거 |
|
|
| C | 한 해석이 우세하지만 다른 해석도 가능함 | 제안 |
|
|
| D | 의미·지시 대상·전문 용어 여부가 불명확함 | 보류 또는 질문 |
|
|
| E | 보호 구간·의도적 문체·허용형임 | 유지 |
|
|
|
|
세부 우선순위와 충돌 규칙은 `references/decision-policy.md`를 따른다. 띄어쓰기·활용·높임 등의 최소 대조 사례는 `references/rule-catalog.md`를 필요할 때만 읽는다.
|
|
|
|
## 절대 규칙
|
|
|
|
- 원문에 없는 사실·효용·감정·인과관계를 추가하지 않는다.
|
|
- 가능성을 확정으로, 권고를 의무로, 일부를 전체로 강화하지 않는다.
|
|
- 조사·의존 명사·어미가 갈릴 수 있는 표현을 일괄 치환하지 않는다.
|
|
- 규범상 허용되는 표현을 오류로 표시하거나 한 형태로 강제 통일하지 않는다.
|
|
- 방언·신조어·캐릭터 말투는 표준화 요청이 없으면 보존한다.
|
|
- 근거 없이 “더 자연스럽다”, “보통 이렇게 쓴다”라고 단정하지 않는다.
|
|
|
|
## 출력
|
|
|
|
기본값은 `brief`다. 교정문을 먼저 제시하고, 의미 있는 수정과 경고만 짧게 덧붙인다. 사용자가 결과만 요구하면 `silent`, 학습을 원하면 `teaching`, 중의성이 핵심이면 `review`를 사용한다. 형식은 `references/output-modes.md`를 따른다.
|
|
|
|
## 대표 예시
|
|
|
|
**입력**
|
|
|
|
> 문서의 `할수있다` 필드는 변경하지 말고, 이 일은 할수있다. 비가 올듯하다.
|
|
|
|
**교정**
|
|
|
|
> 문서의 `할수있다` 필드는 변경하지 말고, 이 일은 할 수 있다. 비가 올듯하다.
|
|
|
|
- 인라인 코드는 보호한다.
|
|
- 일반 문장의 의존 명사 `수`는 띄어 쓴다.
|
|
- `올듯하다`는 허용형이므로 오류로 고치지 않는다.
|
|
|
|
## 흔한 실패
|
|
|
|
| 실패 | 올바른 대응 |
|
|
|---|---|
|
|
| 모든 `뿐·만큼·대로·지`를 같은 방식으로 띄움 | 품사와 의미를 먼저 판정 |
|
|
| 한 오류 때문에 문단 전체를 다시 씀 | 오류 범위만 최소 수정 |
|
|
| 허용형을 선호형으로 강제 변경 | 맞는 입력은 유지 |
|
|
| 윤문하면서 단정 강도나 주체를 변경 | 원문의 명제와 양태 보존 |
|
|
| 코드·URL·제품명 내부를 교정 | 보호 구간으로 제외 |
|
|
| 문맥이 부족한데 확신하는 설명을 생성 | 원문 유지 + 경고 |
|
|
|
|
배포 전에는 `tests/cases.json`과 `tests/evaluation-rubric.md`로 회귀 검증한다.
|