HWPX 문서 스킬 — 레퍼런스 복원 우선(XML-first) 워크플로우

한글(Hancom Office)의 HWPX 파일을 XML 직접 작성 중심으로 생성, 편집, 읽기할 수 있는 스킬. HWPX는 ZIP 기반 XML 컨테이너(OWPML 표준)이다. python-hwpx API의 서식 버그를 완전히 우회하며, 세밀한 서식 제어가 가능하다.

기본 동작 모드 (필수): 첨부 HWPX 분석 → 고유 XML 복원(99% 근접) → 요청 반영 재작성

사용자가 .hwpx를 첨부한 경우, 이 스킬은 아래 순서를 기본값으로 따른다.

레퍼런스 확보: 첨부된 HWPX를 기준 문서로 사용
심층 분석/추출: analyze_template.py로 header.xml, section0.xml 추출
구조 복원: header 스타일 ID/표 구조/셀 병합/여백/문단 흐름을 최대한 동일하게 유지
요청 반영 재작성: 사용자가 요구한 텍스트/데이터만 교체하고 구조는 보존
빌드/검증: build_hwpx.py + validate.py로 결과 산출 및 무결성 확인
쪽수 가드(필수): page_guard.py로 레퍼런스 대비 페이지 드리프트 위험 검사

99% 근접 복원 기준 (실무 체크리스트)

charPrIDRef, paraPrIDRef, borderFillIDRef 참조 체계 동일