4주차 — 문서 작성 에이전트 + 서브에이전트·Skill
— 한글 문서, 내용만 적으세요

1문제 — 같은 조직의 한글 문서 56건, 서식이 전부 달랐다

한 폴더에 모아 둔 같은 종류의 한글 문서 56건을 자동으로 읽어 여백·글꼴·줄 간격을 세어 봤습니다. 용지(A4 세로 91%)만 일정하고 나머지는 문서마다 달랐습니다.

왜 이럴까. 기준이 없으니 지난 문서를 복사해서 고쳐 쓰고, 그때마다 서식이 한 번 더 갈라집니다. 검토한 예시 파일 한 건은 그 안에서 줄 간격이 150%·160% 두 벌이었습니다. 문제는 '한글을 못 다뤄서'가 아니라 골격이 매번 달라서입니다.

※ 통계는 수치만 싣습니다. 개별 파일명·내용·작성자는 여기에 싣지 않습니다. 누구의 문서가 '잘못된 예'라는 뜻이 아닙니다 — 기준이 없으면 누구나 그렇게 됩니다.

2기준 — 남의 문서가 아니라, 정부 공문서 작성 기준

어느 문서를 골라도 "그게 표준"이라는 근거가 없습니다. 그래서 바닥은 법령(「행정업무의 운영 및 혁신에 관한 규정 시행규칙」 제2조)과 행정안전부 『행정업무운영 편람』으로 깔고, 기관·부서 사정은 그 위에서 고쳐 씁니다. 출처를 댈 수 있고, 바뀌면 따라가면 됩니다.

※ 신청서·증명서 같은 「서식」은 기준이 따로 있습니다(시행규칙 [별표 4]: 여백 상·좌·우 20/하 10mm, 돋움 10pt). 이 페이지는 보고자료·기안문 쪽 이야기입니다.

3에이전트 구조 — Skill은 레시피 카드, 서브에이전트는 문서별 담당

이번 주 미션의 핵심 두 단어를 도구 안에 이렇게 배치했습니다.

실물 — Skill 카드 발췌

---
name: hwpx-report
description: 평문 원고(메모장 txt)를 정부 공문서 작성 기준 서식의 한글 파일(.hwpx)로 만든다.
             "한글 파일로 만들어줘", "공문서 서식으로", "보고자료 hwpx" 요청 때 사용.
---
## 절차
1. 원고를 기준 형식으로 정리한다.  (이 단계가 이 스킬의 판단 부분)
   - 첫 줄 `제목: ...`
   - 항목 기호를 법정 순서로: 1. → 가. → 1) → 가) → (1) → (가) → ① → ㉮
   - ■ ● ▶ ※ ◆ 등 규칙에 없는 기호는 위 순서로 바꾼다. 부연 설명 줄은 - 로 둔다.
   - 들여쓰기·탭은 전부 지운다(기호를 보고 자동으로 2타씩 넣는다).
   - 날짜는 2026. 9. 15.(월) 형식. 항목이 하나뿐인 층에는 기호를 붙이지 않는다.
   - 내용(문장)은 고치지 않는다. 오탈자가 보이면 고치지 말고 결과 안내 때 알려준다.
2. 생성기를 실행한다.   python 도구/hwpx서식/build_hwpx.py 원고.txt 결과.hwpx [--한장]
3. 결과를 안내한다. 파일 위치 / 바꾼 것(기호·날짜) / 고치지 않은 것(문장·오탈자)을 3줄 이내로.

## 바꾸지 않는 것 (법령, A항)   ## 바꿔도 되는 것 (B항)   ## 하지 않는 것
… HTML·DOCX를 거쳐 한글로 변환하지 않는다(표·글머리·글꼴이 깨진다).

이 카드는 규칙이지 프로그램이 아닙니다. 채팅에 붙여 넣으면 그 대화에서 규칙은 따르지만, 한글 파일을 실제로 만드는 것은 폴더 안의 생성기와 골격 hwpx입니다. 스킬로 쓰려면 붙여 넣는 게 아니라 프로젝트 폴더에 .claude/skills/hwpx-report/SKILL.md로 저장해 두는 것이고, 그러면 폴더를 열 때마다 자동으로 붙습니다.

담당(서브에이전트) 파일은 열 줄 남짓입니다: "너는 보고자료 담당이다 → 스킬 절차대로 한다 → 이 담당만의 기본값(한 쪽, 제목 한 줄, 15pt) → 표·다른 종류·외부 전송은 하지 않는다." 작업 분할의 실익은 새 종류를 붙일 때 규칙을 다시 적지 않는다는 것입니다.

4쓰는 법 — 설치 프로그램도, 실행 파일도 아닙니다

Skill과 서브에이전트는 프로젝트 폴더 안에 든 설명 파일입니다(.claude/skills/, .claude/agents/). Claude Code로 그 폴더를 열면 자동으로 읽히고, 다른 폴더를 열면 붙지 않습니다. 터미널·데스크톱 앱(Code 탭)·VS Code 확장 어느 쪽이든 같습니다. 별도 설치나 등록 절차는 없습니다.

같은 방식으로 직접 만들 때 필요한 것은 셋입니다: .claude/skills/hwpx-report/ 폴더, 생성기 build_hwpx.py, 골격 서식/골격/골격.hwpx. 부서 기본값(글꼴·여백)은 생성기 맨 위 설정 한 곳만 고칩니다. 생성기 자체는 PC 안에서만 돌고 결과 파일도 PC에 남습니다. 단 ①·②는 원고 정리 판단을 위해 원고 글을 Claude가 읽으므로, 채팅에 붙여 넣는 것과 같은 범위로 서버에 전달됩니다. 개인정보가 든 원고는 ③으로 만들거나 그 자리를 가리고 넘기면 됩니다.

5시연 — 왼쪽에 적으면, 오른쪽이 나옵니다

제목: 한글 문서 서식 기준 마련 추진 현황

1. 추진 배경
가. 부서에서 생산한 한글 문서 56건을 전수 분석한
   결과, 문서마다 서식이 서로 달랐음
1) 여백 6종, 본문 글꼴 4종, 줄 간격 3종이 혼재
2) 용지(A4 세로)만 91%로 일정하고 나머지는
   문서별로 상이
- 2026. 9. 11. 기준, 파일 자동 분석 결과
나. 기준이 없어 기존 문서를 복사해 수정하는
   방식으로 작성되고 …

2. 추진 내용
가. 정부 공문서 작성 기준을 그대로 기준점으로 채택
1) 항목 구분은 1., 가., 1), 가), (1), (가), ①, ㉮
   순서로 표시
2) 둘째 항목부터는 상위 항목에서 오른쪽으로
   2타씩 이동
3) 항목 기호와 내용 사이는 1타를 띄우고 …
나. 평문 원고를 입력하면 위 기준의 한글 파일이
   생성되도록 구현
…
3. 향후 계획
가. 보고자료를 시작으로 계획(안), 회의록,
   결과보고, 붙임 표 순으로 서식을 하나씩 확정
나. 기관·부서별 사정에 맞추어 글꼴, 크기,
   줄 간격은 조정하여 사용
- 이 문서 자체가 해당 방식으로 생성된 첫 결과물임

원고 (메모장 · 평문). 들여쓰기는 적지 않아도 됩니다 — 기호를 보고 단계를 판단합니다. 예시 원고의 내용은 이 서식 기준 자체를 설명하는 글입니다.

→

결과 (한글 hwpx → 1쪽). 줄 간격 140% · 자간 -4% · 장평 96% · 15pt로 조여 한 쪽, 매달린 글자 0. 사람이 한 일은 왼쪽 글을 쓴 것뿐입니다.

어떻게 동작하나

• ① 평문으로 적는다. 제목과 내용만. 기호는 1. 가. 1) -처럼 앞에 붙이기만 하면 됩니다.
• ② 기호를 보고 단계를 판단한다. '가.'가 보이면 둘째 단계 → 2타 들여쓰기, 두 줄 넘으면 첫 글자에 맞춤. 2타 = 한글 1자 = 영문·숫자 2자로 환산해 계산합니다. 내어쓰기는 기호의 실제 폭(장평·자간 반영)으로 재서, 자간을 바꿔도 정렬이 어긋나지 않습니다.
• ③ 한글 파일을 바로 만든다. 워드→한글 '변환'이 아닙니다. 글꼴 목록·문서 구조는 실제 한컴 파일에서 물려받은 골격을 쓰고, 문단 모양은 기준대로 새로 만들고, 내용만 채워 넣습니다. 변환이 없으니 표·글머리·글꼴이 깨질 자리가 없습니다.

덤 — 한 장 맞추기 (--한장)

보고자료가 한두 줄 넘칠 때 실무에서 하는 순서 그대로 조입니다. 글을 자르는 건 마지막입니다.

• 쪽수는 추정이 아니라 한글로 실제 조판해 PDF를 만들어 셉니다. 그래서 한컴이 설치된 PC에서만 켜지는 옵션입니다.
• 한 쪽에 들어가면 매달린 줄(문단 끝에 한두 글자만 넘어간 줄)까지 빨아올리고, 아래가 비면 줄 간격을 도로 넓혀 한 쪽을 채웁니다.
• 한도를 넘겨야 들어간다면 조이지 않고 "원고를 줄여야 합니다"라고 알립니다. 읽기 나쁜 한 장보다 정직한 한 줄이 낫습니다.

생성기(파이썬)는 Claude Code가 작성했고, 저는 기준을 정하고 결과를 한글로 열어 검증하는 쪽을 맡았습니다. 시안 1~3은 들여쓰기 폭·매달린 줄 처리에서 틀려 시안 4에서 통과했습니다.

6정직하게, 지금 단계 — 된 것 / 안 된 것 / 다음

Before / After

부서 기본값 — 의견을 모으는 중

Skill 카드의 B항(글꼴·크기·여백·첫 줄 구조)은 코드가 아니라 "우리 문서는 이렇다"는 말이면 채울 수 있습니다. 4회차 스터디(9. 14.)에서 "내가 자주 쓰는 문서 1종의 바꾸지 않을 것 / 바꿔도 되는 것 3줄"을 적어 보내 주시길 요청했고, 회신이 오는 대로 기준 문서의 "부서 의견" 절과 담당 파일 기본값에 반영합니다. (이 페이지 작성 시점에는 회신 취합 전입니다.)

다음 계획: ① 계획(안) 담당 → 회의록 담당 순으로 추가(각각 담당 파일 + 골격 검증) ② 생성기에 표(붙임 표) 기능 ③ 3주차 취합봇의 승인본을 이 생성기로 hwpx 병합본까지 만들기 — 3주차의 "다음 계획 ①"이 이번 주 도구로 이어집니다.