（5036期）Gonggong Hwpxskills Main – HWPX 템플릿 자동 치환 문서 생성기

HWPX 템플릿 자동 치환 문서 생성기 基于ZIP层级替换的HWPX韩文文档模板生成工具，支持占位符提取与批量内容填充，适用于自动化报告生成场景 使用说明 核心用法 hwpx_my는 한글 HWPX 포맷 문서의 템플릿 기반 자동 생성을 위한 스킬입니다. ZIP 구조를 활용한 경량 치환 방식으로 작동하며, 전용 파서 없이도 템플릿 내 플레이스더를 탐색하고 JSON 매핑 파일을 통해 일괄 치환합니다. 주요 커맨드: analyze-template <path> — 템플릿에서 텍스트 플레이스홀더 추출 apply-template <template> <mapping.json> <out.hwpx> — 매핑 데이터로 치환 후 출력 워크플로우: assets/report-template.hwpx 기본 플릿 또는 사용자 업로드 템플릿(uploads/) 준비 analyze-template로 치환 가능한 필드 식별 JSON 매핑 파일 작성 후 apply-template 실행 결과물 outputs/에 저장 확장성: python-hwpx 설치 시 전체 ObjectFinder 기능 사용 가능; 미설치 시 lib/hwpx_shim.py 경량 셔 제공 显著优点 한글 전용 최적화: 국내 표준 HWPX 포맷原生 지원 경량 구조: ZIP 레벨 치환으로 무거운 문서 엔진 불필요 템플릿 친화적: 양식 기반 워크플로우, 재사용성 높음 MIT 라이선스: 상업/개인 용도 자유로운 사용 潜在缺点与局限性 구조적 제약: ZIP 레벨 치환은 서식 보존에 한계; 복잡한 서식/표/이미지 동적 조정 어려움 python-hwpx 의존성: 고급 기능(ObjectFinder)은 추가 패키지 필요 검증 부재: 제공된 문서에 보안 스캔 정보 없음, 실제 안전성 미확인 단일 포맷: HWPX만 지원, DOCX/PDF 등 크로스 포맷 호환 없음 템플릿 품질 의존: 출력물 품질은 템플릿 설계에 전적으로 의존 适合人群 한글 문서 자동화가 필요한 국내 기업/공공기관 담당자 정형화된 보고서(주간/월간 리포트, 감사 결과서 등)를 반복 생성하는 사용자 개발자가 템플릿 엔진을 직접 구축하기보다 경량 솔루션을 선호하는 경우 常规风险 데이터 노출: mapping.json에 민감 정보 포함 시 버전관리 시스템 유출 위험 템플릿 주입: 외부 템플릿 파일 신성 검증 필요; 악성 XML/매크로 가능성 출력 무결성: ZIP 치환 실패 시 손상된 문서 생성, 사전 백업 권장 의존성 관리: python-hwpx 버전 불일치로 기능 동작 불능 가능성 原始说明 HWPX 문서(.hwpx 파일)를 생성, 읽기, 편집, 템플릿 치환하는 스킬. 한글 HWPX 포맷을 다루며 양식 기반 템플릿 치환 워크플로우를 제공합니다.