Files
DongHyeonkaandClaude Opus 5 1099834617 chore: snapshot working tree before harness removal
미추적 파일과 미커밋 수정을 전부 담아 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>
2026-08-07 14:19:24 +09:00

4.5 KiB

name, description
name description
editing-korean-grammar-and-expression 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.jsontests/evaluation-rubric.md로 회귀 검증한다.