한국어 문서의 교정, 문체 개선, 구조 정리와 선택적 품질 평가를 위한 Agent Skill입니다.
같은 한국어 검토 기준을 두 개의 독립 설치본으로 제공합니다.
| 환경 | 설치본 |
|---|---|
| Claude Code, Codex, Hermes, VS Code 기반 에이전트 및 일반 Agent Skills 환경 | skills/general-agent/ |
| Obsidian YOLO | skills/obsidian-yolo/ |
두 설치본을 같은 환경에 동시에 설치하지 마십시오. 필요한 폴더 하나만 선택합니다.
- 원문·인용·수치·조건·코드·링크·고유명사 보호
- 한국어 맞춤법, 띄어쓰기, 호응, 조사·어미와 높임 검토
- 번역투, 과도한 명사화, 반복되는 종결형과 AI 상투 문체 검토
- 대본·보고서·기술 문서 등 9개 문서 유형별 기준
- 어문 규범 확인과 사실 확인의 분리
- 긴 문서의 섹션 단위 처리와 전체 일관성 재검사
- 문서 유형별 100점 평가
review / evaluate / improve / evaluate-and-improve작업 모드- 평가 전 원문 고정과 수정 여부 명시
- 점수제의 조건부 실행
- 최소 수정과 원문 역검증
- 대본
- 업무 보고서·공공 문서
- 기술 문서
- 이메일·메시지
- 개인 메모·지식 노트
- 조사·학습 자료
- 회의록·프로젝트 기록
- 게시글·댓글
- 일반 설명문·교육 자료
korean-writing-reviewer/
├── README.md
├── LICENSE
├── CHANGELOG.md
└── skills/
├── general-agent/
│ ├── SKILL.md
│ └── references/
│ ├── common-criteria.md
│ ├── document-profiles.md
│ ├── editor-protection.md
│ ├── long-document-workflow.md
│ ├── korean-ai-patterns.md
│ ├── examples.md
│ ├── scoring-common.md
│ ├── scoring-*.md
│ ├── scoring-examples.md
│ └── source-basis.md
└── obsidian-yolo/
├── SKILL.md
└── references/
└── ...
각 설치 폴더는 다른 폴더에 의존하지 않는 완전한 스킬 패키지입니다.
skills/general-agent/의 내용을 사용하는 에이전트의 스킬 폴더 안에 korean-writing-reviewer라는 폴더로 복사합니다.
예시:
<agent-skills-dir>/korean-writing-reviewer/
├── SKILL.md
└── references/
대상 환경의 실제 스킬 경로와 편집 도구 규칙을 따르십시오. 이 설치본은 특정 편집기 DSL을 강제하지 않습니다.
skills/obsidian-yolo/의 내용을 볼트의 다음 위치에 복사합니다.
<Obsidian Vault>/YOLO/skills/korean-writing-reviewer/
├── SKILL.md
└── references/
YOLO 설치본은 mode: always를 사용하지만 다음 작업에는 문장 검토를 확대 적용하지 않습니다.
- 코드만 생성하는 작업
- 파일 이동·삭제·이름 변경
- 단순 경로·설정 조작
- 한국어 자연어 결과가 없는 작업
기존 Markdown 파일의 편집 출력은 YOLO의 obsidian-output-format 규칙을 따릅니다.
일반 검토, 점수 평가와 수정을 구분합니다.
| 모드 | 동작 |
|---|---|
review |
점수 없이 문제·근거·수정 방향을 제시하고 수정하지 않음 |
evaluate |
명시적인 채점 요청에 따라 원문 점수를 산출하고 수정하지 않음 |
improve |
점수 없이 최소 수정 |
evaluate-and-improve |
원문 평가 → 개선 → 수정본 재평가 |
검토해 줘, 평가해 줘, 최종 검수해 줘는 점수 요청이 없으면 review로 처리합니다. 검토해서 고쳐 줘는 점수 없이 improve, 점수를 매긴 뒤 고치고 재채점해 줘는 evaluate-and-improve로 처리합니다.
점수 평가 결과에는 다음을 명시합니다.
- 평가 대상
- 문서 수정 여부
- 원문 점수와 수정본 점수의 구분
점수표는 점수·채점·등급을 명시적으로 요청한 경우에만 적용합니다. 최종 검수, 여러 문서 비교, 품질 회귀 평가나 자동화도 점수 산출 요구가 없다면 일반 검토로 처리합니다.
채점만 요청하면 원문을 수정하지 않습니다. 채점과 수정·재채점을 함께 요청하면 원문 점수를 먼저 확정하고 수정본을 같은 기준으로 다시 평가합니다.
일반 검토는 문제·근거·수정 방향만 보고합니다. 작성·교정은 최소 수정과 원문 역검증을 적용하며, 불필요한 내부 판정표나 점수를 덧붙이지 않습니다.
한국어 어문 규범, 공공언어와 언어 예절 자료를 참고하되 원문 자료와 평가표를 복제하지 않고 독자적으로 재구성했습니다. 세부 출처와 활용 범위는 각 설치본의 references/source-basis.md에 정리되어 있습니다.
MIT License
