📋 한글 매크로 봇

키워드로 글을 쓰면, 버튼 한 번에 공문서 서식으로. — 범정부오피스 형태의 우리 기관 전용 한글 자동화 도구

작업 정리 · 2026-06-12 · 환경: Windows + 한글 2024 + Python(pyhwpx)
📖 사용자 가이드 보기 →

1. 이 프로젝트가 하는 일

유튜브 '공무원코딩'의 범정부오피스(기관마다 따로 만들어주는 한글 자동화 도구)를, 우리 기관(재단·교육부 등)에 맞춰 직접 쓰는 버전입니다. 핵심 철학:

① 키워드로 작성제목/중제목/네모/원/당구장…
② 정리한다 클릭공문서 서식으로 일괄 변환
③ 클로드 연동AI가 초안까지 자동 작성

영상 2개(인천공항 가이드·AI 연동편)를 프레임 단위로 분석해 그 형태를 목표로 재설계했습니다.

2. 오늘 한 작업 (2026-06-11~12)

전면 재설계 — 기존 실험(엑셀표 정상화 등)을 정리하고, 영상 형태(세로 도킹 패널 + 정리한다)로 새로 설계. 실험 스크립트 48개는 _archive로 보관.
「정리한다」 엔진 구현 — 키워드 9종 → 서식 변환, 중제목 Ⅰ·소제목 1 자동 번호(구간마다 리셋), 손기호(ㅁ○-) 통일.
세로 도킹 패널 재작성 — 기관 드롭다운 + 양식/본문/기호/AI 섹션 + 큰 [정리한다] 버튼.
프리셋 외부화 + 참고글 레벨 — 기관 스타일을 JSON 파일로 분리(클로드가 직접 보정 가능), ※ 참고글 단계 추가.
양식 생성기 — 단문/장문보고·표지목차·참석명단 골격 자동 생성, templates 폴더 파일 = 자동 버튼.
스타일 배우기 — 참조 문서를 읽어 그 기관 스타일을 학습 → 드롭다운에 추가. 교육부 기준 문서로 회귀 검증.
본문 도구 — 금액 천원/백만원 변환, 자간·장평, 형광펜, 기호 팔레트.
버그 수정 (사용자 검수) — ①계층 들여쓰기 ②줄 맞춤(앞선 맞추기) ③표 우하단 바깥선 끊김 ④제목 박스 글꼴 — 모두 화면 캡처로 확인.
중제목·소제목 버튼 추가 — 문서 위쪽 번호를 이어 매기는 버튼.
작성 품질 규칙 학습 — ○ 항목 2줄 설명·※ 참고 활용·단계 간격을 영구 규칙으로 반영.

3. 실제 결과물

클로드가 재단 스타일로 작성한 워크샵 계획서 — 키워드 초안 → 정리 자동 변환:

워크샵 계획서 결과
제목 박스, Ⅰ~Ⅳ 자동번호, □○ 계단 들여쓰기, ※ 참고글까지 — 손 안 대고 자동 생성

4. 구성 모듈

모듈역할
panel.py세로 도킹 패널 (버튼 UI)
hwp_normalize.py정리한다 엔진 — 키워드→서식, 자동번호, 계층 들여쓰기
hwp_report_format.py레벨 서식 코어 — 프리셋·글머리·표·제목박스
hwp_style_learn.py스타일 배우기 — 참조 문서 학습
hwp_templates.py양식 생성 — 골격 + templates 폴더 연동
hwp_text_tools.py금액·자간·장평·형광
hwpfill.py양식 채우기 (신청서 칸 자동 입력)

5. 검증 현황

자동 테스트 전부 PASS

  • 정리한다 엔진 (키워드·번호·들여쓰기)
  • 프리셋 병합 로드
  • 양식 골격 생성
  • 본문 도구 (금액/자간/장평/형광)
  • 중제목/소제목 번호 이어가기
  • 스타일 학습 회귀 (교육부 기준)
  • 양식 채우기 왕복

화면 눈 검증

표
표 바깥선·머리행 음영 정상

6. 다음 후보

📖 사용자 가이드 보기 →