<img src="docs/assets/logo.svg" width="30" align="middle" alt=""> <b>korean-report-skills</b>

[](../../actions) [](../../releases) [](INSTALL.md) [](LICENSE)

# 왜 Claude가 만든 한국어 문서는 어딘가 이상할까

내용은 맞는데 **문서로 전달하기가 망설여지는** 경험. 그 이유를 다섯 가지로 나누고 각각을 규약으로 구성한 스킬셋입니다.

Claude Code · Codex · Cursor 에 적용 가능합니다. → [설치](#설치)

<picture> <source media="(prefers-color-scheme: dark)" srcset="docs/assets/banner-dark.png"> <img src="docs/assets/banner-light.png" alt="paper 보고서와 deck 협의자료 — 스킬이 만들어낸 문서 세 장"> </picture>

paper(세로·보고서) · deck(가로·협의자료) — HTML 파일 하나로 구성됩니다.

---

## "디자인이 별로예요"

마크다운을 워드에 붙이면 볼품없고, HTML로 제작 할 경우 **매번 일관되지 않은 디자인과 구성으로 표현합니다.** 제목 크기도, 표 모양도, 여백도 그때그때 달라집니다.

**→ 디자인 시스템을 고정했습니다.** 액센트 색 하나, 그림자 없음, 표에 세로 괘선 없음. paper(세로·보고서)와 deck(가로·협의자료) 두 모드뿐이고 섞을 수 없습니다. 같은 요청에 같은 결과가 나옵니다.

<table> <tr> <th width="50%">전 — 그냥 만들었을 때</th> <th width="50%">후 — 스킬 적용</th> </tr> <tr> <td><img src="docs/assets/ba_before.png" alt="스킬 없이 작성한 문서"></td> <td><img src="docs/assets/ba_after.png" alt="스킬을 적용한 문서"></td> </tr> </table>

## "문장이 번역체 같아요"

`됐다`와 `하였습니다`가 한 문서에 섞이고, `~하는 것`·`~에 걸려 있다` 같은 번역투가 남습니다. 읽는 사람에게 **초안처럼** 보입니다.

**→ 치환 목록 115건과 어미 규약.** 평서체와 합니다체를 섞지 않고, 필요하면 문서와 커버레터를 분리합니다.

| 그냥 쓰면 | 규약 적용 | |---|---| | 반토막 넘게 늘었습니다 | 4.2시간에서 9.1시간으로 증가하였다 | | 모든 사슬이 승인 하나에 걸려 있다 | 승인 이후 착수할 수 있다 | | 각 절은 근거를 함께 갖는다 | 각 절에 근거를 명시하였다 |

**지켜졌는지 확인할 수 있습니다.** 규약이 표로만 있으면 지켜졌는지 아무도 모릅니다. 같이 실려 가는 검사기가 문서를 훑어 걸린 곳을 줄·열로 알려줍니다.

```console $ python korean-report-style/assets/lint.py 보고서.md 보고서.md:5:24 [검토] 반토막이 된다 → 절반 수준으로 낮아진다 (§3 구어체 환언) 보고서.md:5:38 [고침] 했다 → 하였다 (§1 어미) 보고서.md:10:1 [제목] 무엇이 달라지나 → 명사구로 고친다 (§1.1 제목은 명사구) ```

`--fix` 는 어미만 자동으로 고칩니다. `넘긴다 → 전