hwpx-automationlisted

# HWP/HWPX 작업 자동화 스킬 ## 도구 위치 이 SKILL.md와 같은 디렉토리에 모든 도구가 포함되어 있다: - **hwpx_edit.py**: 이 디렉토리의 `hwpx_edit.py` (편집 명령 + `--to-md` CLI 래퍼) - **hwpx-tomd**: `--to-md` 변환 엔진을 단일 소스로 보유한 독립 패키지. `pip install hwpx-tomd` (PyPI·GitHub `Engccer/hwpx-tomd` 공개. 엔진 자체를 수정할 때만 로컬 editable: `pip install -e path/to/hwpx-tomd`). 라이브러리로도 직접 사용 가능(`from hwpx_tomd import to_markdown, convert`). 변환 로직은 이 패키지에만 있고 `hwpx_edit.py`는 호출만 한다(코드 분기 방지). - **hwpx_convert.py**: 이 디렉토리의 `convert/hwpx_convert.py` (MD/DOCX/HTML/RST/TEX/TXT → HWPX 변환, `pip install pypandoc-hwpx` 필요) - **hwpx_com.py**: 이 디렉토리의 `hwpx_com.py` (한컴 COM 네이티브 파이프라인, pyhwpx 기반, Windows + 한컴오피스 전용, `pip install pyhwpx` 필요). MD→HWPX 생성·이미지 삽입·본문 추출·한컴 재저장 정규화(--normalize)·PDF 변환. XML/Pandoc 파이프라인과 **분리 운용**(아래 "한컴 COM 자동화" 참조) - **hwpx_sign.py**: 이 디렉토리의 `hwpx_sign.py` (서명란(기준 텍스트 "(서명)" 등)에 서명/도장 이미지를 삽입하는 전용 도구, Windows + 한컴오피스 필요). COM으로 이미지를 넣어 BinData를 확보한 뒤 XML 후처리로 floating PAPER 절대좌표 전환·앵커 위 문단 이동·lineseg 제거를 자동 수행한다(아래 "서명/도장 이미지 삽입" 참조) - **hwp2hwpx**: 이 디렉토리의 `convert/hwp2hwpx.bat`(Windows) 또는 `convert/hwp2hwpx.sh`(macOS/Linux) - **python-hwpx CLI**: `pip install python-hwpx` (v2.9.0+): `hwpx-validate`, `hwpx-page-guard` 등 실행 시 이 스킬 디렉토리의 절대경로를 사용한다. 예: `python <스킬디렉토리>/hwpx_edit.py` ## Step 0: 환경 점검 (첫 실행 또는 의존성 의심 시) ```bash python <스킬디렉토리>/hwpx_edit.py --check-env ``` 기능 계층(tier)별로 무엇이 바로 되는지 한 번에 출력한다(읽기 전용, 아무것도 설치하지 않음). 이 스킬은 API 키를 쓰지 않으므로(전부 로컬 도구) 점검 대상은 pip 패키지와 시스템 런타임이다: - **Tier 1 (읽기·편집, 필수)**: `python