Natural Korean

Natural Korean

한국어 문서를 설계 → 작성 또는 수정 → 정적 탐지 → 문맥 판단 → 재검사 순서로 다듬어라. 탐지 결과는 의심 항목이지 자동 수정 명령이 아니다.

1. 작업 모드 결정

• 새 글 요청이면 독자, 목적, 핵심 메시지, 문서 장르를 먼저 정하고 작성하라.
• 기존 글 교정이면 사실, 수치, 고유명사, 인용, 사용자가 지정한 어조를 보존하라.
• 진단만 요청하면 원문을 바꾸지 말고 findings와 개선 우선순위만 보고하라.
• 입력이 불충분해 결과가 크게 달라질 때만 독자나 목적을 물어라. 그 외에는 문맥에서 합리적으로 추론하고 진행하라.

2. 필요한 참고 자료 읽기

• 모든 작업에서 references/writing-principles.md를 적용하라.
• lint finding의 의미나 수정 여부가 불분명하면 references/rules.md를 읽어라.
• 비즈니스, 기술, 블로그 문서라면 references/genres.md에서 해당 장르만 읽어라.
• 정적 탐지가 어려운 문제를 검토할 때 references/review-checklist.md를 읽어라.
• 사용자 고유 문체를 기록해 달라는 요청이 있을 때만 assets/style-profile-template.md를 복사해 작성하라.

3. 설계하고 작성하기

새 글은 본문 전에 다음을 내부적으로 확정하라.

1. 독자가 누구인지 정하라.
2. 읽은 뒤 독자가 무엇을 알거나 실행해야 하는지 정하라.
3. 핵심 메시지를 한 문장으로 적어라.
4. 결론이 드러나는 제목과 소제목을 설계하라.
5. 근거가 없는 수치·사실·인용을 만들지 마라.

기존 글은 문단별 기능을 파악한 뒤 가치가 있는 부분만 수정하라. 모든 문장을 같은 길이와 문형으로 평탄화하지 마라.

4. 정적 탐지 실행하기

대상 파일에 다음을 실행하라. SKILL_DIR은 이 SKILL.md가 있는 디렉터리의 절대 경로로 치환하라.

uv run "$SKILL_DIR/scripts/lint.py" path/to/document.md --genre business
uv run "$SKILL_DIR/scripts/lint.py" path/to/document.md --genre business --json

장르는 business, tech, blog, general 중에서 고르며 기본값은 general이다. 붙여 넣은 텍스트는 임시 파일에 저장해 검사하고 작업 후 삭제하라.

구조만 빠르게 확인할 때:

uv run "$SKILL_DIR/scripts/outline.py" path/to/document.md

영문 약어와 전문용어 후보의 첫 등장을 확인할 때:

uv run "$SKILL_DIR/scripts/terms.py" path/to/document.md

5. 판단하고 수정하기

각 finding을 다음 중 하나로 분류하라.

• 수정: 문맥상 실제로 부자연스럽거나 의미를 흐린다.
• 유지: 의도된 표현, 고유 용어, 인용, 장르상 필요한 형식이다.

수정할 때 다음 순서를 지켜라.

1. 사실과 의도를 보존하라.
2. 행위자와 행동을 구체화하라.
3. 불필요한 추상명사와 번역투를 줄여라.
4. 문체와 높임 수준을 통일하라.
5. 문장 길이와 종결형에 자연스러운 변화를 주되 억지로 바꾸지 마라.

6. 재검사하고 수렴하기

첫 JSON 결과를 저장하고 수정 후 baseline으로 전달하라.

uv run "$SKILL_DIR/scripts/lint.py" path/to/document.md \
  --genre business \
  --json > /tmp/natural-korean-before.json

uv run "$SKILL_DIR/scripts/lint.py" path/to/document.md \
  --genre business \
  --baseline /tmp/natural-korean-before.json

새 finding이 없고 모든 기존 finding을 수정 또는 유지로 판단할 때까지 반복하라. lint가 통과해도 마지막에 처음 읽는 독자의 관점으로 다음을 확인하라.

• 첫 문단에서 핵심을 파악할 수 있는가?
• 문단마다 역할이 있는가?
• 주어와 서술어가 자연스럽게 호응하는가?
• 이것, 해당, 이를이 무엇을 가리키는지 분명한가?
• 사실, 추정, 의견이 구분되는가?

7. 결과 전달하기

교정 결과와 함께 중요한 수정 이유를 짧게 요약하라. 유지한 finding이 있으면 그 이유도 밝히라. lint는 맞춤법 보증이나 AI 작성 여부 판정기가 아니므로 그런 의미로 점수나 확률을 만들지 마라.