By name: hwpx-gov-doc-js description: > 행정안전부 'AI 친화 행정문서 작성 가이드라인' 기반으로 공공 보고서를 HWPX 파일로 자동 생성하는 스킬 (JavaScript/Node.js 버전). 검증된 base64 템플릿을 내장하여 한컴 오피스에서 정상 동작하는 서면보고·보도자료를 생성함. 사용자가 "HWPX", "한글 문서", "공공 보고서", "행정 문서", "서면보고", "보도자료", "공문", "보고서 작성", "AI로 보고서"를 언급하면 이 스킬을 사용한다.
HWPX 공공행정문서 자동생성 스킬 (JavaScript)
환경 요구사항
npm install jszip @xmldom/xmldom
지원 문서 유형
| 유형 | 설명 |
|---|---|
| 서면보고 | Ⅰ/Ⅱ 대제목 표 + □/○ 본문 + ⇒ 결론 |
| 보도자료 | 보도시점 표 + 제목/부제/리드문 + □/○ 본문 + 담당자 표 |
핵심 가이드라인 규칙 (반드시 적용)
- 주어·서술어 명확 — 개조식 금지, 완전한 문장으로 서술 (~함, ~임, ~예정임)
- 표준 번호체계 — Ⅰ. → 1. → 가. → 1) 순서 준수
- 셀 병합 금지 — 단순 표 구조만 사용
- 특수기호 대신 번호체계 — heading, paragraphs에 불릿 기호(□, ○, Ⅰ 등)를 넣지 마세요. 시스템이 자동 추가합니다.
라이브러리 파일 위치
이 스킬은 저장소 루트의 JS 라이브러리를 사용합니다:
(저장소 루트)/
├── generate_hwpx_node.js ← Node.js 생성기
├── generate_hwpx_browser.js ← 브라우저 생성기
├── hwpx_template_node.js ← 서면보고 템플릿 (Node.js)
├── hwpx_template_browser.js ← 서면보고 템플릿 (브라우저)
└── hwpx_press_template.js ← 보도자료 템플릿
워크플로우
Step 1 — 입력 수집
사용자로부터 받을 정보:
필수: 문서 제목, 추진 배경, 주요 내용
선택: 작성 부서, 담당자, 작성일, 문서 종류(서면보고/보도자료), 연락처, 붙임
Step 2 — 내용 정제 (가이드라인 적용)
입력 내용을 변환:
- "AI 도입 필요" → "정부는 AI를 도입할 필요가 있음."
- 주어 없는 문장 → 주어 추가
- 모든 문장 끝 → ~함 / ~임 / ~예정임 / ~있음
Step 3 — JSON 구성 후 생성
CLI에서 바로 실행:
cd /path/to/hwpx-generator # 저장소 루트로 이동
npm install # 첫 실행 시 의존성 설치 (jszip, @xmldom/xmldom)
node test_example.js # 데모 실행
Node.js에서 사용:
// ⚠️ 저장소 루트의 JS 파일을 require (경로 주의)
const { createGovHwpx, today } = require('/path/to/hwpx-generator/generate_hwpx_node.js');
const doc = {
title: 'AI시대 행정문서 작성 가이드라인(안) 보고',
doc_type: '서면보고', // 또는 '보도자료'
dept: '혁신행정담당관',
author: '박은희 사무관',
date: today(),
sections: [
{
heading: '추진 배경',
paragraphs: [
'정부는 표준화된 문서 작성 가이드라인을 수립할 필요가 있음.',
],
table: {
rows: [
['정보 종류', 'AI 인식 수준'],
['일반 문자', '정확하게 인식'],
]
}
},
{
heading: '주요 내용',
paragraphs: ['전 부서에 가이드라인을 배포하고 시범 실시함.'],
subsections: [
{
heading: '문서 작성 원칙',
paragraphs: ['주어와 서술어를 명확히 기술함.']
}
]
}
],
contacts: [
{ dept: '혁신행정담당관', name: '박은희 사무관', tel: '044-205-1473' }
]
};
createGovHwpx(doc, '보고서.hwpx')
.then(path => console.log('생성 완료:', path));
보도자료:
const doc = {
title: '보도자료 헤드라인',
subtitle: '부제목',
doc_type: '보도자료',
_templateType: 'press',
press_time_online: '2026. 4. 1.(수) 12:00 이후',
press_time_print: '2026. 4. 2.(목) 조간부터',
lead_lines: ['리드문 1', '리드문 2'],
policy_ref: '관련 정책명',
sections: [
{
heading: '소제목',
subsections: [
{ heading: '세부항목', paragraphs: ['본문 내용'] }
]
}
],
contacts: [{ dept: '담당부서', name: '담당자', tel: '전화번호' }],
attachments: ['첨부자료명']
};
서식 커스텀 (선택):
const opts = {
colors: { navy: '#003366', title_bg: '#DFEAF5', navy_line: '#315F97' },
fonts: { title: 'HY헤드라인M', body: '휴먼명조', ui: '맑은 고딕' },
sizes: { title: 2000, body: 1500, h2: 1600 },
indent: { h2: 1400, body: 2800 },
spacing: { body_line: 160, h2_before: 2400 }
};
createGovHwpx(doc, '보고서.hwpx', opts);
Step 4 — 파일 제공
생성된 .hwpx 파일 경로를 사용자에게 알려준다.
JSON 스키마
서면보고
{
"title": "보고서 제목",
"doc_type": "서면보고",
"dept": "부서명",
"author": "작성자",
"sections": [
{
"heading": "대제목 (Ⅰ 자동)",
"subsections": [
{
"heading": "중제목 (□ 자동)",
"paragraphs": ["본문 (○ 자동)"],
"subsections": [
{ "heading": "소제목 (가 자동)", "paragraphs": ["세부 (- 자동)"] }
]
}
],
"table": { "rows": [["헤더1", "헤더2"], ["값1", "값2"]] },
"conclusions": ["결론 (⇒ 자동)"],
"notes": ["주석 (※ 자동)"]
}
],
"contacts": [{ "dept": "부서", "name": "이름", "tel": "연락처" }],
"attachments": ["첨부 파일명"]
}
보도자료
{
"title": "헤드라인",
"subtitle": "부제목",
"doc_type": "보도자료",
"_templateType": "press",
"press_time_online": "2026. 4. 1.(수) 12:00 이후",
"press_time_print": "2026. 4. 2.(목) 조간부터",
"lead_lines": ["리드문"],
"policy_ref": "관련 국정과제",
"sections": [{ "heading": "소제목", "paragraphs": ["본문"] }],
"contacts": [{ "dept": "부서", "name": "이름", "tel": "연락처" }],
"attachments": ["첨부자료명"]
}
파일 구조
skill-js/
├── SKILL.md ← 이 파일
└── references/
├── guideline_rules.md
└── hwpx_format.md
라이브러리 코드는 저장소 루트의 generate_hwpx_node.js, hwpx_template_node.js 등을 참조합니다.