서술형 종결
오류개조식 전용 보고서 지적의 57%「대체하지 않는다」 · 「별개로 추가」
「대체 아님 · 별도 추가」
「하드필터가 이미 그 수요를 흡수했다.」
「하드필터가 그 수요를 이미 흡수」
「결론: 트랙 열지 않는다.」
「결론 — 트랙 열지 않음」
「되돌리기가 가장 비싸다」
「되돌리기 비용 최대」
「재측정 결과 26/38 → 25/38 로 1건 내렸다.」
「재측정 26/38 → 25/38 · 1건 내림」
AI 한글 교정기
AI가 작성한 초안을 업무 한국어로 고치는 교정기 — 표기 규칙 위반은 검사기가 전수 검출 · 문맥 판단이 필요한 표현은 모델 검토와 사람 확인 · 유형별 수정 전후 사례
실제로 걸린 문장 넷
표시 색은 주묵(朱墨) — 원고를 고칠 때 쓰던 붉은 먹입니다. 이 페이지의 붉은색은 모두 교정 표시이고, 초록색은 원고지 바탕과 교정을 마친 문장입니다.
검사한 업무 보고서
600여 개
3초 안팎에 전수 검사
형식과 무관한 오류가 있던 보고서
8%
열두 편에 한 편꼴
개조식 규약 위반까지 포함
33%
규약 검사는 설정 한 줄로 해제
검사기가 검출하는 유형
36가지
사람 판단은 별도
01
보고서 한 편 전체를 검사하면 다음과 같은 결과가 나옵니다. 수정 전 오류 17건이 지적을 반영한 뒤 0건이 됩니다 — 걸린 낱말은 「」로 표시했습니다.
17
수정 전 오류 — 30줄 분량 문서 한 편 기준
0
지적 반영 뒤 — 검사 대상 42개(표 칸·목록 항목 등) 전부 통과
# 검사 도구 도입 검토 결과 보고 이 문서는 사내 문서 검사 도구 세 종을 비교하여 도입 여부를 정리한 것입니다. ## 1. 무엇을 비교했나 | 도구 | 라이선스 | 속도 | 비고 | |---|---|---|---| | A사 | 상용 | 12초 | 설치가 필요하다 | | B사 | 오픈소스 | 3초 | 규칙 수정이 안 된다 | | 자체 | 사내 | 2초 | 규칙을 「우리」가 정한다 | ## 2. 왜 자체 제작을 택했는가 「강력한」 규칙 엔진을 갖춘 A사 도구가 후보였다. 그러나 「우리」 문서에는 사내 용어가 많고, 「이들」 용어를 도구가 인식하지 못한다. B사 도구는 「가벼운데」 규칙을 못 고친다. - **결정**: 자체 제작으로 - **되돌리기**: 비용이 낮다 ## 3. 다음 「회기」 계획 검토 결과가 실장님께 「보고되어졌고」, 「다음 판」에서 시범 적용 대상을 정한다. 「서버로의」 배포는 이후로 미룬다. > 이 계획은 결과에 따라 바뀔 수 있다.
# 문서 검사 도구 도입 검토 결과 **문서 검사 도구 세 종 비교 · 자체 제작 채택** — 비교 대상·판정 근거·되돌리기 비용 ## 1. 비교 대상 | 도구 | 라이선스 | 속도 | 제약 | |---|---|---|---| | A사 | 상용 | 12초 | 설치 필요 | | B사 | 오픈소스 | 3초 | 규칙 수정 불가 | | 자체 | 사내 | 2초 | 규칙 자체 지정 | ## 2. 자체 제작을 택한 이유 **A사 도구 — 사내 용어 인식 안 됨** 검사 대상 문서에 사내 용어가 많으나 A사 도구가 해당 용어를 인식하지 못합니다. **B사 도구 — 규칙 수정 불가** 처리 속도는 3초로 빨랐지만 규칙을 수정할 수 없었습니다. - **결정**: 자체 제작 채택 - **되돌리기 비용**: 낮음 - **보고**: 검토 결과 실장 보고 완료 ## 3. 다음 회차 계획 - **다음 단계**: 시범 적용 대상 선정 - **서버 배포**: 이후로 미룸 - **변경 가능성**: 결과에 따라 바뀔 수 있음
02
지적이 지나치게 많으면 사용자가 검사 결과를 확인하지 않게 됩니다. 그래서 같은 낱말이라도 바르게 쓴 표현은 지적하지 않습니다 — 다섯 짝에서 왼쪽은 통과하고 오른쪽만 지적됩니다.
| 같은 겉모습 | 통과 | 지적 | 통과하는 이유 |
|---|---|---|---|
| 「자리」 | 「앞자리」·「빈자리」·「옆자리」 | 「규칙을 넣을 자리」 | 실제로 앉는 좌석 |
| 「창」·「판」 | 「편집창」·「대화창」·「바둑판」 | 「모으는 창」·「앞 판」 | 한 낱말로 굳은 이름 |
| 「회기」 | 「국회 회기」·「임시 회기」 | 「-4.9pp 회기」 | 국회·시의회가 여는 기간 |
| 「~다」 종결 | 규칙 이름 「같은 함정에 두 번 넘어가면 기계로 옮긴다」 | 값 칸의 「대체하지 않는다」 | 원문과 글자가 같아야 하는 이름 |
| 인용 부호 | 출처를 밝힌 남의 말 — 「(8/5 회의) …」 | 출처 없이 감싼 내 해설 | 고칠 수 없는 남의 원문 |
정당한 쪽 지적 0건 — 위와 같은 짝을 정당한 표기 20종 · 같은 모양의 위반 15종으로 모아 회귀 시험에 추가했습니다. 규칙의 적용 범위를 넓히다가 정당한 표기가 하나라도 지적되면 시험이 실패해 바로 드러납니다. 위반 검출 능력만 평가하면 「전부 지적」이 만점이 되므로 양쪽을 함께 평가합니다.
03
쓰시던 관행이 그대로 규칙이 됩니다. 표 머리 「비고」는 공문서의 표준 관례이고, 발표 대본은 산문이 정상입니다. 기본 설정을 그대로 사용하지 않고 유형을 켜고 끄거나 등급을 바꿔서 사용합니다.
| 설정 항목 | 설정 방법 | 적용 대상·효과 |
|---|---|---|
| 유형 끄기 | off = ["스캔 가치 없는 라벨"] | 표 머리 「비고」를 쓰는 조직 |
| 등급 낮추기 | warn = ["절단형 종결"] | 발행은 막지 않고 참고만 받을 때 |
| 묶음 단위로 끄기 | off = ["구조"] | 제목·진입점 형식을 자유로 두는 조직 |
| 산문 문서 | 머리말에 form: prose 한 줄 | 소개 글·발표 대본·설명문 · 개조식을 전제로 한 아홉 가지를 모두 검사에서 제외 |
| 자사 제품 이름 | 별도 목록 파일에 공식 표기 = 잘못 적은 한글 | 제품 이름을 한글로 잘못 적은 것을 검출 · 목록은 저장소 밖에 둠 |
| 새 규칙 추가 | 어색한 문장을 이슈로 등록 | 등록한 문장이 재검사 사례로 추가됨 · 규칙이 바뀔 때마다 다시 실행해 확인 |
유형별 사용 여부와 등급은 korean-qa.toml 한 파일에서 정합니다 — 검사 대상 파일이 있는 폴더부터 상위 폴더로 올라가며 찾습니다. 제품 이름만 별도 목록 파일을 사용합니다.
[rules]
off = ["스캔 가치 없는 라벨", "구조"]
warn = ["절단형 종결"]
끈 유형은 결과 맨 위와 합계에 표시 — 끈 사실이 표시되지 않으면 「오류 0」이 통과인지 검사하지 않은 것인지 구분할 수 없습니다. 유형 이름은 지적에 표시되는 이름 그대로이고, --list-rules 로 유형 36가지를 모두 확인할 수 있습니다 — 지적 유형 34가지와, 지적 대신 한 줄로 확인을 요청하는 안내 두 가지(「형식 미표기」와 「코드 블록 안 배포 문구」)입니다.
제품 이름은 규칙 파일에 적지 않음 — 규칙 파일은 모든 사용자가 공유하고 제품 이름 목록은 공용 규칙과 분리해 저장소 밖에서 관리합니다. 걸러 낼 이름을 규칙 파일에 나열하면 그 파일이 곧 명단이 되어, 규칙 파일을 공유하면 제품 이름도 함께 공개됩니다. 목록이 없으면 이 유형은 실행되지 않고 결과에 그 사실을 표시합니다 — 지적이 없는 결과를 합격으로 해석하지 않기 위해서입니다. 목록에 이름을 추가하기 전에 다른 낱말과 겹치는지 확인하는 검사도 함께 제공합니다(짧은 음차가 더 긴 낱말의 일부와 겹치면 오탐이 발생합니다).
오탐은 규칙의 예외로 등록 — 한 줄만으로 판별할 수 없는 표현은 후보로만 제시하고 사람이 정합니다. 사람이 「이건 정당하다」고 판정하면 그때 한 번으로 끝나지 않고, 규칙의 예외로 등록되고 재검사 사례로도 함께 기록됩니다 — 규칙이 바뀔 때마다 다시 실행됩니다.
04
세 편에 한 편꼴로 고칠 것이 있었습니다. 사람이 작성한 사내 분석·진행 보고서 600여 개를 수정하지 않고 검사만 실행한 결과입니다 — AI 글에만 맞춘 규칙이 아니라는 뜻입니다.
8%
형식과 무관한 오류가 있던 문서 — 열두 편에 한 편꼴
33%
개조식 규약까지 켰을 때 — 세 편에 한 편꼴
67%
지적의 대부분이 개조식 규약 — 해당 아홉 가지는 설정 한 줄로 해제
3초
600여 개 전체 검사 시간
두 숫자를 구분한 이유 — 「값 칸을 문장으로 끝내지 않는다」는
한국어 규칙이 아니라 문서 형식 규약입니다. 개조식(라벨: 값)으로 작성한 문서에서만 어긋나고,
산문이 정상인 문서에서는 지적되면 안 됩니다. 그래서 이 검사기는 개조식 규약 아홉 가지를 켜고 끌 수 있게 했습니다 —
머리말에 form: prose 한 줄을 넣으면 모두 검사에서 빠집니다.
개조식 규약을 끄고 검사한 결과가 8%입니다.
가장 많이 걸린 여섯 가지 — 개조식 규약인 것은 표시했습니다
존댓말 종결이 상위 셋 — 서술형 종결의 어미를 세면 「~습니다」 · 「~입니다」 · 「~합니다」 순입니다. 보고서 문장의 종결 어미를 값 칸에 그대로 사용한 것입니다.
05
설치하기 전에 어떤 표현이 지적되는지 모두 확인하고 결정하시면 됩니다. A·B는 고정 규칙이 표기만으로 전수 검출하고, C는 문맥을 읽고 판단해야 하는 유형입니다 — 문맥을 판단하는 검사 단계가 후보를 제시하고 사람이 확정합니다. 가까운 유형은 한 장에 묶었고, 사례는 모두 실제 문서와 사람이 확정한 교정에서 가져왔습니다.
표기만으로 판별할 수 있는 유형입니다. 서술형 종결만 성격이 다릅니다 — 한국어 문법 오류가 아니라 개조식 문서의 규약이라 켜고 끕니다. 나머지는 문서 형식과 무관하게 어긋난 한국어입니다.
「대체하지 않는다」 · 「별개로 추가」
「대체 아님 · 별도 추가」
「하드필터가 이미 그 수요를 흡수했다.」
「하드필터가 그 수요를 이미 흡수」
「결론: 트랙 열지 않는다.」
「결론 — 트랙 열지 않음」
「되돌리기가 가장 비싸다」
「되돌리기 비용 최대」
「재측정 결과 26/38 → 25/38 로 1건 내렸다.」
「재측정 26/38 → 25/38 · 1건 내림」
「고칠 것은 코멘트로」
「코멘트로 표시」
「새 자료는 해당 폴더에」
「새 자료 → 해당 폴더」
「로컬 삭제 파일은 Drive 휴지통으로」
「로컬 삭제 파일 → Drive 휴지통 · 30일 복구 가능」
「이 화면은 그리기만」
「이 화면은 그리기 전용」
「시퀀스 표를 다이어그램으로」
「시퀀스 표를 다이어그램으로 바꿈」
「무엇을 보나」
「관측 대상」
「무엇이 어디 있나」
「파일별 위치」
「어디를 보나」
「확인 위치」
「어디에 녹였나」
「반영 위치」
「우리 제품이 아니다 — 이들이 우리를 호출한다」
「검사기 개발 범위 밖 — 검사기를 호출하는 주체」
「우리 코퍼스는 사내 규정 비중이 크다」
「사내 문서 뭉치 — 규정 비중이 큼」
「이 둘을 구분해서 보는 것이 우리 설계에 유용하다」
「두 방식을 구분하는 것이 CT 설계에 유용」
「규칙을 넣을 자리」
「규칙을 넣을 위치」
「표 칸이 특히 새는 자리」
「표 칸에서 특히 자주 틀린다」
「실패 모드가 그대로 걸리는 자리」
「실패 모드가 그대로 걸리는 사례」
「의견을 받는 자리」
「의견을 수렴하는 회의」
「보고하는 자리」
「보고 회의」 · 「발표 세미나」
지적 제외 — 「앞자리」·「빈자리」·「옆자리」. 실제 좌석과 굳은 쓰임은 은유가 아니라 그 뜻 그대로입니다.
모임도 「자리」로 부르지 않음(2026-09-04에 좁힘) — 예전에는 모임 뜻을 예외로 두었는데 그 예외 때문에 화면의 입력 칸을 가리키는 은유도 지적되지 않았습니다. 모임 뜻의 어간 열 개를 예외에서 뺀 뒤 실측은 오류 5,529건 그대로 · 새로 주의 7건 · 사라진 지적 0건.
「1판·2판」
「1차·2차」 · 「첫 시도·두 번째 시도」
「모으는 창」·「무르는 창」
「모으는 시간」·「무를 수 있는 시간」
「앞 판에서」
「앞 실험에서」 · 「먼저 측정한 결과에서」로 바꿈
「묻는 때」·「다루는 때」
「질문 시점」·「다루는 시점」
「모델에 드는 값」
「모델 사용 비용」
「~는 때」를 두 번 좁힘(2026-09-10 추가) — 「때」를 낱말 그대로 규칙에 추가하면 오탐이 많아 사용할 수 없습니다. 부사절 「~ㄹ 때」는 사내 보고서 613개에 67건 나오는 정상적인 쓰임이고, 같은 보고서 613개에서 「~는 때」는 0건입니다. 파일 41,968개(50.8억 자)를 검사해 검출된 「~는 때」 15종이 전부 표 머리 라벨이었습니다. 그런데 검사기가 관형형만 확인하면 「이제는 때가 됐다」·「그는 때를 기다린다」처럼 「는」이 보조사인 경우도 함께 지적됩니다. 이 오탐은 실측한 문서에서는 발생하지 않았고, 오탐을 유도하려고 직접 작성한 시험 문장에서만 발생했습니다. 업무 문서에는 「때를 기다리다」 같은 표현이 쓰이지 않기 때문입니다. 그래서 값·축과 같은 방식으로 앞에 오는 용언을 구분해 검출합니다 — 범위를 좁힌 뒤에도 실문서에서 찾은 15종은 그대로 검출되고, 시험 문장의 오탐 6건만 더 이상 지적되지 않습니다.
여섯 낱말 중 셋을 먼저 규칙에 추가 — 처음에는 여섯 낱말을 합산해 집계했는데, 검출된 것이 대부분 정당한 쓰임이어서 규칙 전체를 보류했습니다. 그래서 실문서 1,100여 개에서 관형형 뒤에 붙은 출현 건수를 낱말별로 다시 집계했습니다. 「판·창」은 0건, 「결」은 1건뿐이어서 규칙에 추가해도 정당한 문장이 지적될 일이 거의 없으므로 추가했습니다. 「값」 9건 · 「축」 4건 · 「층」 2건은 거의 전부 정당한 쓰임이어서 제외했습니다. 세 명사 모두 이 분야에서 혼자 서는 말이기 때문입니다(계산하는 값 · 못 보는 축 · 읽는 층). 규칙에 추가할 낱말은 빈도가 아니라 정밀도(지적한 것 가운데 실제로 고칠 것의 비율)를 기준으로 골랐습니다. 이후 「값」·「축」을 목적어로 받을 수 없는 용언(「닿는 값」 등) 뒤에 붙은 경우만 오류로 추가했습니다.
「-4.9pp 회기」
「-4.9pp 회귀」
「다음 회기 계획」
「다음 회차 계획」
전수 점검에서 78건 모두 오용 — 회귀 오타 46 · 「이번 작업 세션」 뜻 32 · 정당한 쓰임 0. 「어려운 말로 쓰지 않음」 규칙이 이미 적혀 있었는데도 오용이 계속 발생해서 검사기 규칙으로 옮겼습니다.
「값이 잘못 계산되어진다」
「값이 잘못 계산된다」
「서버로의 접속」
「서버 접속」
「단일에서 복합으로의 progression」
「단일에서 복합으로 나아감」
규칙을 추가하고 실문서 409개에 실행해 오탐 2건을 찾아냄 — 「구축되지는 않습니다」가 이중 피동으로 지적됐고(어간에서 「되」를 뺌), 「경로의」·「대로의」가 이중 조사로 지적됐습니다(예외 낱말 목록에 추가).
문장은 멀쩡한데 값을 찾는 데 문장을 끝까지 읽어야 하는 유형.
「분산을 왜 택했는가 — 검색 정확도 때문이 아니다」
「분산을 택한 이유 — 검색 정확도 아님」
「무엇을 어떻게 틀렸나」
「틀린 지점과 원인」
「진단 — 어디서 무거워졌는가」
「진단 — 무거워진 지점」
「의존성 검사가 직접 의존성만 본다」
「의존성 검사 — 직접 의존성만 검사」
「이 문서는 사내 문서 검사 도구 세 종을 비교하여 도입 여부를 정리한 것입니다.」
「문서 검사 도구 세 종 비교 · 자체 제작 채택 — 비교 대상·판정 근거·되돌리기 비용」
「최신 릴리즈 노트와 변경 사항을 검토하여 정리한 주요 업데이트는 다음과 같습니다.」
「릴리즈 노트 주요 변경 — 검토 정리본」
「본 보고서는 첫 보고서. 향후 보고서는 이 보고서 이후의 변경사항만 다룬다.」
「AI 활용 첫 보고서 — 다음 회차부터 변경분만 다룸」
「분류 · 카운트 · 비율 · 설명」
「분류 · 건수 · 비율 · 판정 근거」
「단계 · 상태 · 비고」
「단계 · 상태 · 다음 행동」
「파일 · 줄 수 · 내용」
「파일 · 줄 수 · 포함 항목」
「이 문서는 설계 전용이다」 · 「코드 실행은 재컨펌 후 별도 진행」
「적용 범위 — 설계 전용 · 코드 실행은 사용자 재컨펌 후 별도 진행」
「이 계획은 시범 적용 결과에 따라 바뀔 수 있다.」
「변경 가능성 — 시범 적용 결과에 따라 바뀔 수 있음」
실제 효과 — 산문으로 된 원칙 문서 하나에 형식을 적자 오류 81건 → 3건. 나머지 78건은 규칙이 잘못 걸린 것이었습니다.
「가벼운 검증 실행체」
「화면 없이 명령줄로 호출하는 실행체」
「강력한 Context Engineer 워크플로우」
「도구 호출 순서를 정해 두는 워크플로우」
「풍부한 메타데이터」
「메타데이터 12종」
줄만 봐서는 안 갈리는 유형입니다. 문맥을 판단하는 단계가 후보를 제시하고 사람이 확정합니다 — 그 판정이 다시 고정 규칙의 예외로 추가됩니다. 사례는 모두 사람이 확정한 교정입니다.
「메메틱 구조」
「기억 구조」
「메모리 초과 클래시」
「메모리 초과로 인한 비정상 종료」
「메인 라인업」
「주력 제품군」
「산출물을 타깃」
「산출물을 검증 대상으로 지정」
「프러리리스 배포 시작」
「사전 공개판 배포 시작」
「최대 출력 토큰(max output tokens)」
「최대 출력 토큰」
「safety-critical 시스템 단위/통합 테스팅」
「안전 필수 시스템의 단위·통합 테스트」
「scratch 공간에 명세 및 실행 계획을 수립하고 verification gate를 사전에 정의」
「임시 공간에 명세와 실행 계획을 적고 검증 관문을 미리 정의」
「에러」
「오류」
「로컬 실행 환경 구축 기능 추가」
「로컬 실행 환경을 구축하는 기능 추가」
「컨텍스트 압축 및 세션 리셋 주기적 수행」
「주기적으로 컨텍스트를 압축하고 세션을 초기화」
「가변 추론 기능 도입으로 작업 난이도에 따른 동적 추론 깊이 조절 가능.」
「가변 추론 기능을 도입해 작업 난이도에 따라 추론 깊이를 조절.」
「사용자 인터페이스 고도화」
「사용자 인터페이스 개선」
사용자가 잡아낸 미탐 — 「로컬 실행 환경 구축 기능 추가」는 검사기와 문맥 판단 단계가 모두 검출하지 못했습니다. 사용자가 이 문구를 고칠 표현으로 판단한 근거는 조사가 하나도 없다는 점이었고, 이 지적을 반영해 새 유형을 추가했습니다.
「HTTPS URL을 통해 직접 플러그인 아카이브 패키지를 설치 및 관리하는 스펙 지원.」
「HTTPS URL로 플러그인 아카이브 패키지를 직접 설치하고 관리하는 스펙 지원.」
「인터뷰를 통해」
「인터뷰에서」로 바꿈
「검증에서 사람이 가장 많이 붙는 곳이 테스트를 만드는 구간이고, 여기를 AI로 풉니다」
「단위 통합 검증에서 공수가 많이 필요한 과정이 테스트를 설계하는 것입니다」
「갈래는 둘, 요구사항에서 도출하는 것과 코드 구조를 훑어 커버리지를 채우는 것입니다」
「크게 두 가지로 나뉘는데, 요구사항 기반 테스트와 구조 기반 테스트입니다」
「에이전트가 자체적으로 돌 수 있도록」
「에이전트가 자동으로 실행할 수 있도록」
「막대가 상반기 실측입니다」
「현재 보여드리는 내용이 상반기 결과이며」
「제품화 경로」
「제품화 단계」
「CT를 다시 세우는 부분」
「CT 재개발이 필요한 항목」
「비약적으로 상승한 플래그십 모델」
「에이전틱 작업·시스템 설계·리팩터링 능력을 개선한 최상위 모델」
「차세대 임베디드 테스팅 파이프라인 대응」
「임베디드 테스트 연계 지원」
「적극 제외하여」
「제외해」
「상위 4개 벤더가 모두 AI 보조 기능을 올린 상태」 — 문장 전체가 굵게
「상위 4개 벤더가 모두 AI 보조 기능을 정규 제품군에 올린 상태」
「최초 버전 인도」 — 나라 이름으로 읽힘
「최초 버전 공급」 · 「최초 버전 전달」
「브랜드 재정립」 — 무엇을 어떻게 바꿨는지 숨음
바꾼 내용을 그대로 적음 · 원문에 근거가 있을 때만 고침
「시드 목록」
「시드(조사 대상으로 미리 정한 도구) 목록」
「AI 조립 라인」
「AI 조립 라인(AI Assembly Line)」
06
낱말 검사는 등록된 표현과 대조하는 방식입니다. 그래서 등록되지 않은 말은 검출하지 못합니다. 문장 형식을 검사하는 유형은 그대로 실행하고, 낱말 검사만 빈도 검사로 보완합니다. 사람이 쓴 업무 한국어를 기준 자료로 두고 기준 자료와 비교해 드문 말을 후보로 제시합니다.
36,037
기준 자료 문서 — 사람이 쓴 사내 업무 한국어
4,793만
기준 자료 글자 수
3,108
기준 자료의 낱말 종수 — 41회 이상 나온 것
2가지
기준 자료에서 드문 말 · 기준 자료보다 자주 쓴 말
| 검사 기준 | 기준값 | 후보 낱말 |
|---|---|---|
| 기준 자료에 드묾 | 기준 자료에 40회 이하 | 기준 자료에 40회 이하로 나온 낱말 — 문맥을 검토해야 할 후보 |
| 이 문서에 잦음 | 상대 빈도 350배 이상 · 이 문서에 3회 이상 | 기준 자료보다 이 문서에서 훨씬 자주 쓴 낱말 · 과용인지는 사람이 판단 |
상대 빈도 계산 방법 — 문서 길이로 나눠 비교합니다 — (이 문서 횟수 ÷ 이 문서 글자수) ÷ (기준 자료 횟수 ÷ 기준 자료 글자수). 기준 자료에 40회 이하인 낱말은 「이 문서에 잦음」 기준에서 빼고 「기준 자료에 드묾」 기준으로 검사합니다 — 분모가 작아 배수가 지나치게 커지기 때문입니다.
판정하지 않고 목록만 제시함 — 드물다고 해서 곧 고칠 표현인 것은 아닙니다. 제품 이름·전문 용어·숫자 단위가 드문 것은 정상입니다. 판정은 사람이 하고, 이 도구는 검토할 후보를 줄여 줄 뿐입니다. 사람이 판정할 때는 함께 쓰인 낱말과의 짝을 확인합니다 — 「돈을 걷다」는 업무 문서에 쓰이지만 「커밋을 걷다」는 쓰이지 않습니다.
정상 표현 등록 — 낱말과 적용 범위를 함께 적습니다. 등록한 범위에서는 다음부터 후보에 오르지 않고, 범위 밖에서는 그대로 오릅니다 — 같은 낱말이라도 문서 종류가 다르면 다시 검토해야 하기 때문입니다.
모델 검토가 놓친 사례 — 후보 63개를 모델로 판별해 본 실험에서 시험한 모든 모델·설정 조합이 함께 놓친 것이 12개였습니다. 그중 「깎」·「싣」·「갈음」은 빈도 검사가 후보로 제시했습니다. 특정 실험의 결과이고 모델 전반의 한계를 뜻하지는 않습니다. 다만 이 결과 때문에 후보를 제외하는 판단은 모델에 맡기지 않습니다 — 사람이 정합니다. 사용한 모델·설정과 「놓쳤다」의 판정 근거는 실험 기록에 적혀 있습니다.
07
사내 문서 두 묶음(업무 보고서 · 규칙·기록 문서)의 유형별 지적 비중입니다. 도입을 검토하실 때 참고용이고, 조직마다 문서 형식과 사용하는 유형이 달라 분포도 달라집니다. 업무 보고서는 사내 분석·진행 보고, 규칙·기록 문서는 작업 규칙과 진행 기록입니다. 값은 각 뭉치의 전체 지적에서 차지하는 비중입니다.
측정 기준 — 업무 보고서 2026-09-18 · 문서 636개 중 지적이 발생한 문서 347개 · 전체 지적 2,486건(오류 1,780 · 주의 706)이 분모입니다. 규칙·기록 문서는 2026-09-08 측정이고 당시 전체 지적 건수를 기록하지 않아 분모를 적을 수 없습니다 — 두 열을 더하거나 비교하지 마십시오.
| 유형 | 등급 | 업무 보고서 | 규칙·기록 |
|---|---|---|---|
| 서술형 종결 개조식 전용 | 오류 | 57% | 58% |
| 스캔 가치 없는 라벨 | 주의 | 9% | <1% |
| 절단형 의심 | 주의 | 6% | 4% |
| 서술형 문단 개조식 전용 | 오류 | 6% | <1% |
| 해설을 인용 부호로 씀 | 주의 | 4% | 4% |
| 형식 미표기 | 주의 | 2% | 5% |
| 반복 블록 라벨 불일치 | 주의 | 2% | 5% |
| 모호한 지칭 | 오류 | 3% | 2% |
| 제목 서술형 개조식 전용 | 오류 | 1% | 3% |
| 진입점 서술형 개조식 전용 | 오류 | 1% | 5% |
| 진입점 없음 개조식 전용 | 오류 | 0 | 4% |
| 절단형 종결 | 오류 | 2% | 2% |
| 제목 명사형 위반 개조식 전용 | 오류 | 1% | 1% |
| 지어낸 명사구 | 오류·주의 | 0 | 2% |
| 「~하는 자리」 의심 | 주의 | 0 | 1% |
| 평가 수식어 | 주의 | 1% | 1% |
| 번역투 이중 조사 | 주의 | <1% | <1% |
| 이중 피동 | 오류 | 0 | <1% |
| 「회기」 | 오류 | 0 | <1% |
| 은유 「자리」 | 오류 | 0 | <1% |
| 진입점 명사형 위반 개조식 전용 | 오류 | <1% | 0 |
| 제목 형태 확인 개조식 전용 | 주의 | <1% | <1% |
| 진입점 형태 확인 개조식 전용 | 주의 | 0 | 0 |
| 지시어 확인 | 주의 | 3% | <1% |
| 번역투 「그녀」 | 주의 | 0 | <1% |
| 결론 라벨 없는 설명 | 주의 | 0 | 0 |
| 업무 글에 없는 말 | 오류·주의 | 1% | 측정 전 |
| 말투 섞임 | 주의 | <1% | 측정 전 |
| 제품 이름 음차 | 오류 | <1% | 측정 전 |
| 다른 낱말로 읽힘 | 주의 | 측정 전 | 측정 전 |
| 절 번호로 가리킴 | 오류 | 측정 전 | 측정 전 |
| 문장 끝 괄호 속 이름 | 주의 | 측정 전 | 측정 전 |
| 코드 블록 안 배포 문구 | 주의 | <1% | 측정 전 |
| 반말 서술형 | 오류 | 측정 전 | 측정 전 |
| 낯선 사내 용어 | 주의 | 측정 전 | 측정 전 |
| 띄어 쓴 가운뎃점 | 오류 | 측정 전 | 측정 전 |
「개조식 전용」이 붙은 아홉 가지 — 문서가 개조식일 때만 적용 ·
머리말 form: prose 한 줄로 모두 검사에서 제외 · 업무 보고서 전체 지적의 67%가 이 아홉 가지에서 나왔습니다(1,673 / 2,486건).
0건이어도 규칙은 실행됨 — 「이 뭉치에서 검출되지 않았다」와 「규칙이 없다」는 다릅니다. 이중 피동은 업무 보고서에서 0건인데, 직접 작성한 시험 시료에서는 검출됩니다.
2026-09-08 측정 뒤에 추가한 유형 다섯 — 업무 보고서 열은 2026-09-17 에 다시 측정해 채웠고(같은 뭉치 · 같은 검사기 · 기존 값 여덟이 그대로 재현됐습니다), 규칙·기록 열은 아직 측정하지 않았습니다. 비중을 지어내지 않고 「측정 전」으로 둡니다 — 0건과 미측정은 다릅니다. 「다른 낱말로 읽힘」·「절 번호로 가리킴」은 2026-09-23 에, 「문장 끝 괄호 속 이름」은 2026-09-29 에, 「낯선 사내 용어」는 2026-10-06 에 추가돼 두 열 모두 측정 전입니다.
등급이 둘인 가지 — 「지어낸 명사구」와 「업무 글에 없는 말」은 같은 가지 안에서 확실한 것만 오류로 표시하고 나머지는 주의로 표시합니다. 표는 둘을 함께 적었습니다.
반말은 문서 전부에서 오류 — 2026-09-23 부터입니다. 그 전에는 기본 설정에서 꺼져 있어 이 측정에서 실행되지 않았고, 두 열 모두 측정 전입니다.
08
짐작으로 추가한 유형은 없습니다. 규칙 후보마다 실문서에서 몇 건 나오는지 집계하고, 정당한 쓰임이 섞이면 고정 규칙에서 제외했습니다. 추가한 근거와 제외한 근거를 함께 기록했습니다.
09
MIT 라이선스 — 내려받아 수정하고 재배포 가능 · 전부 공개
git clone https://github.com/kkhfiles/korean-writing-qa.git
1단계면 대부분 충분합니다 — 파일 하나에 파이썬만 있으면 되고, 지금까지 소개한 지적 대부분을 이 파일 하나가 검출합니다.
| 단계 | 받는 것 | 준비 | 고르는 기준 |
|---|---|---|---|
| 1 | assets/doc-style-check.py 파일 하나 · 70KB 안팎 |
파이썬 3.11 이상 · 설치할 라이브러리 0 | 검사만 실행하면 될 때 |
| 2 | 스킬 폴더 · 13개 파일 · 154KB | Claude Code · python install.py |
표현 교정까지 맡기고 싶을 때 · YAML 검사할 때만 pyyaml |
| 3 | 위 + 훅 셋 | python install.py --hooks |
문서를 작성할 때마다 자동으로 검사하고 싶을 때 |
코딩 에이전트에게 맡겨도 됩니다 — README 첫 절이 클론부터 시험까지 명령 순서이고, 단계마다 출력되어야 하는 값이 적혀 있습니다. 저장소 주소만 전달하면 에이전트가 설치까지 수행합니다.
저장소에 포함된 자료 — 테스트 300여 건 · 유형별 회귀 테스트 예문 · 실행 기록 25개 · 규칙별 결정 이유와 실측 근거. 이 페이지의 수치는 모두 실행 기록에서 산출했습니다.