docx-generator
Installation
SKILL.md
워드 문서 생성기 (DOCX Generator)
moai-office v1.0.0
개요
Python python-docx 라이브러리를 기반으로 DOCX 형식의 문서를 생성합니다. 한국 공문서 양식(행정 기관 공문, 기안문), 기업 보고서, 계약서, 제안서를 지원합니다. 플레이스홀더 기반 템플릿으로 반복 문서 작업을 자동화합니다.
트리거 키워드
워드, docx, Word 문서, 계약서, 공문서, 보고서 생성, 문서 편집, 기안문, 제안서, 공문, 협조문
워크플로우
- 문서 유형 선택:
- 한국 공문서 (기안문/공문/협조문)
- 기업 보고서 (주간/월간/분기)
- 계약서 (용역/근로/NDA/MOU)
- 제안서 (사업 제안/기술 제안)
- 회의록 / 품의서
- 내용 입력: 구조화된 내용 입력 또는 기존 텍스트 변환
- 서식 적용: 한국 공문서 표준 서식 (굴림/맑은 고딕, 12pt, A4)
- 파일 생성:
.docx출력, 편집 가능한 Word 형식
지원 문서 유형별 양식
한국 공문서 표준 양식
행정기관 공문서 규정(행정안전부 고시) 기준:
[기관명]
수 신: [수신처]
(경 유): [경유처, 해당 시]
제 목: [문서 제목]
1. [관련 근거 또는 개요]
2. [본문 내용]
가. [항목 1]
나. [항목 2]
[끝]
[기관명]
[담당자] [직급]
[전화번호] [날짜]
기업 계약서 표준 요소
계약 당사자 정보 → 계약 목적 → 계약 범위 → 납기/기간 → 대금 및 지급 조건 → 지적재산권 → 비밀유지 → 계약 해지 → 분쟁 해결 → 서명란
사업 제안서 구조
표지 → 목차 → 사업 개요 → 현황 분석 → 제안 내용 → 기대 효과 → 추진 일정 → 예산 계획 → 수행 팀 소개
python-docx 주요 기능 활용
# 기본 구조 예시 (생성 로직 참고용)
from docx import Document
from docx.shared import Pt, Cm
from docx.enum.text import WD_ALIGN_PARAGRAPH
doc = Document()
# 공문서: 굴림체 12pt, A4, 여백 상하 30mm 좌우 25mm
# 기업문서: 맑은 고딕 10-12pt
# 표: 선명한 경계선, 헤더 음영
지원 기능:
- 단락 스타일 (제목 1~3, 본문, 글머리)
- 표 삽입 및 서식 (병합, 음영, 경계선)
- 이미지 삽입 (로고, 서명)
- 머리글/바닥글 (페이지 번호, 기관명)
- 플레이스홀더 일괄 치환 (
{변수명}→ 실제 값)
사용 예시
- "용역 계약서 DOCX를 작성해줘 (갑: A사, 을: B사, 계약금 1,000만 원)"
- "행정기관 공문 양식으로 협조 요청 공문을 만들어줘"
- "월간 팀 성과 보고서를 Word 문서로 생성해줘"
- "NDA 초안을 DOCX로 작성해줘"
산출물
- 완성된
.docx파일 생성 코드 또는 내용 구조 - 편집 가능한 Word 형식 (Microsoft Word 호환)
- 템플릿 재사용을 위한 플레이스홀더 목록
참고 사항
- HWPX 대안: 한컴오피스 없는 환경에서 공문서가 필요한 경우 DOCX로 대체 가능. 한글 변환 필요 시 hwpx-writer 스킬 참조
- 공문서 규정: 행정안전부 「공문서 작성 규정」(훈령) 기준 양식 준수
- 폰트: 공문서 표준 폰트는 굴림/바탕/맑은 고딕. 배포 시 폰트 내장 또는 PDF 변환 권장
- 전자서명: 디지털 서명 필드 삽입 지원 (Adobe Acrobat 호환 PDF로 변환 후 서명)
- 보안: 계약서 등 민감 문서는 비밀번호 보호 설정 권장
문제 해결
| 상황 | 해결 방법 |
|---|---|
| 파일 생성 실패 | python-docx 설치 여부 확인: pip install python-docx. 설치 후 재시도하세요 |
| 템플릿 미설정 | 문서 유형과 핵심 내용을 알려주시면 기본 구조로 생성해 드립니다 |
| 폰트 깨짐 | 배포 전 PDF 변환을 권장합니다. 또는 시스템에 해당 폰트가 설치되어 있는지 확인하세요 |
| 공문서 규정 상이 | 기관별·부서별 양식 차이가 있을 수 있습니다. 기준 문서를 공유해 주시면 맞춤 작성합니다 |
이 스킬을 사용하지 말아야 할 때
- 한글(HWPX) 문서 생성 → moai-office:hwpx-writer 스킬이 더 적합합니다
- 엑셀(XLSX) 문서 생성 → moai-office:xlsx-creator 스킬을 사용하세요
- PPT 발표자료 생성 → moai-office:pptx-designer 스킬을 사용하세요
- 법적 구속력 있는 계약서 최종 검토 → moai-legal:contract-review 스킬과 법무팀 검토를 활용하세요