| name | write-natural-korean |
| description | 블로그 글, 칼럼, 에세이형 설명문, 사용 후기, 가이드, 정보성 콘텐츠를 기획하고 자연스럽고 명확한 한국어 완성본으로 작성하는 스킬. 주제나 메모만으로 새 글을 써 달라는 요청, 자료를 바탕으로 초안을 구성하는 요청, 기존 초안을 사람다운 흐름으로 다시 쓰는 요청, "블로그 글로 써 줘", "읽기 편한 글로 만들어 줘", "AI 티 없이 작성해 줘", "자연스러운 한국어로 쓰면서 교정해 줘" 같은 요청에 사용한다. 독자·목적·핵심 메시지 설계, 근거와 추정 구분, 제목·소제목 구성, 초안 작성, 번역투·상투 표현·문체 반복 검사와 재교정을 한 흐름으로 수행한다. |
Write Natural Korean
주제나 자료를 곧바로 문장으로 늘이지 말고 글 설계 → 근거 정리 → 구조 작성 → 초안 → 문체·구조 검사 → 재작성 순서로 완성하라.
1. 요청 해석하기
다음 항목을 확인하거나 문맥에서 추론하라.
- 독자
- 글을 읽은 뒤 기대하는 변화
- 핵심 메시지
- 글 유형
- 목표 분량과 어조
- 반드시 포함하거나 피할 내용
- 사용할 수 있는 사실·수치·사례·출처
결과를 크게 바꾸는 정보만 질문하라. 일반적인 블로그 요청은 합리적인 독자와 분량을 정해 바로 진행하라.
글 유형을 정할 때 references/article-types.md에서 해당 유형만 읽어라. 사용자 문체 샘플이 있거나 특정 어조를 요구하면 references/voice-and-style.md도 읽어라.
2. 글 설계하기
assets/article-brief-template.md의 항목을 내부 작업 메모로 채워라. 사용자가 기획안도 요구한 경우에만 노출하라.
- 핵심 메시지를 한 문장으로 쓴다.
- 독자가 이미 아는 것과 새로 알게 될 것을 나눈다.
- 각 소제목이 답할 질문을 정한다.
- 제목과 소제목만 읽어도 논지가 이어지게 구성한다.
- 중요한 답을 도입부 뒤로 불필요하게 미루지 않는다.
키워드나 검색 노출은 사용자가 요청했을 때만 반영한다. 키워드를 반복하기 위해 한국어 문장을 훼손하지 마라.
3. 근거 관리하기
references/evidence-integrity.md를 적용하고 재료를 다음으로 구분하라.
- 사용자 제공 사실
- 직접 확인한 사실
- 합리적인 추론
- 확인할 수 없는 정보
경험하지 않은 일을 1인칭 체험담처럼 쓰지 마라. 확인하지 않은 통계, 인용, 제품 사양, 날짜를 만들지 마라. 최신 사실이나 외부 근거가 필요한 글이면 조사한 뒤 출처를 기록하라. 확인할 수 없으면 범위를 줄이거나 불확실성을 명시하라.
4. 초안 작성하기
references/authoring-workflow.md와 references/voice-and-style.md를 적용하라.
- 첫 문단에서 독자가 얻을 답이나 글의 문제의식을 드러낸다.
- 각 문단에는 하나의 중심 기능을 둔다.
- 추상적인 평가보다 장면, 행동, 수치, 사례를 사용한다.
- 같은 길이, 같은 문형, 같은 종결어미로 모든 문단을 맞추지 않는다.
- 목록은 실제로 병렬인 정보에만 사용한다.
- 결론에서 본문을 요약하는 데 그치지 말고 판단이나 다음 행동으로 연결한다.
파일 결과물이 필요하면 assets/article-template.md를 복사해 작성하되 남은 자리표시자는 모두 제거하라.
5. 구조와 문체 검사하기
SKILL_DIR을 이 파일이 있는 디렉터리의 절대 경로로 치환하고 초안에 다음을 실행하라.
uv run "$SKILL_DIR/scripts/article_check.py" path/to/article.md
uv run "$SKILL_DIR/scripts/lint.py" path/to/article.md --genre blog --json
uv run "$SKILL_DIR/scripts/outline.py" path/to/article.md
article_check.py: 제목, 중복 소제목, 빈 절, 미완성 표지를 확인한다.lint.py: 번역투, 상투 표현, 종결체 혼용, 추상어 과밀, 반복과 리듬을 찾는다.outline.py: 제목과 문단 첫 문장만으로 논지가 이어지는지 확인할 자료를 만든다.
전문용어와 영문 약어가 많으면 다음도 실행하라.
uv run "$SKILL_DIR/scripts/terms.py" path/to/article.md
6. 재작성하고 수렴하기
검사 결과를 자동 오류로 취급하지 말고 각각 수정 또는 유지로 판단하라. 수정 전 JSON을 저장하고 재작성 후 baseline으로 비교하라.
uv run "$SKILL_DIR/scripts/lint.py" path/to/article.md \
--genre blog --json > /tmp/write-natural-korean-before.json
uv run "$SKILL_DIR/scripts/lint.py" path/to/article.md \
--genre blog --baseline /tmp/write-natural-korean-before.json
references/revision-checklist.md로 사실 보존, 문단 기능, 문체, 도입과 결론을 마지막으로 확인하라. lint를 없애기 위해 정확한 용어, 의도된 반복, 글쓴이의 개성을 훼손하지 마라.
7. 완성본 전달하기
기본적으로 독자가 읽을 완성본만 먼저 제시하라. 그 뒤 중요한 작성·교정 판단을 짧게 덧붙여라. 내부 brief, lint JSON, 판단 메모는 사용자가 요구하지 않으면 노출하거나 프로젝트에 남기지 마라.
