hwplisted

# HWP ## What this skill does `.hwp` 문서를 읽어 JSON / Markdown / HTML로 변환하고, 이미지 추출이나 배치 처리를 수행한다. 환경이 **Windows + 한글(HWP) 프로그램 설치 + 직접 제어가 필요한 작업**이면 `hwp-mcp`를 선택하고, 그 외에는 기본값으로 `@ohah/hwpjs`를 사용한다. ## When to use - "이 HWP 파일을 Markdown으로 바꿔줘" - "한글 문서에서 이미지만 뽑아줘" - "폴더 안 HWP를 한 번에 JSON으로 변환해줘" - "윈도우에서 한글 프로그램을 직접 조작해서 표 채워줘" ## When not to use - 원본이 `.hwpx`, `.docx`, `.pdf` 인 경우 - Windows가 아니거나 한글 프로그램이 없는데 직접 편집 자동화를 요구하는 경우 - OCR이나 스캔 PDF 복구가 필요한 경우 ## Prerequisites - 공통 변환 경로: Node.js 24.18.0 LTS 권장 (`.claude/registry/tech-stacks/web-nextjs.yaml`; 변환 도구의 더 엄격한 `engines`가 있으면 이를 우선) - 직접 제어 경로: Windows + 한글(HWP) 프로그램 설치 + Python 3.7+ - 출력 경로 쓰기 권한 ## Inputs - 원본 `.hwp` 파일 경로 또는 폴더 경로 - 원하는 출력 형식: `json`, `markdown`, `html` - 출력 파일/디렉터리 경로 - 이미지 포함/추출 여부 - 배치 처리 여부 - 직접 제어가 필요한지 여부 ## Routing policy ### Default: `@ohah/hwpjs` 다음 조건 중 하나라도 맞으면 `@ohah/hwpjs`를 기본값으로 사용한다. - macOS / Linux / CI 환경 - Windows여도 한글 프로그램 설치 여부를 확신할 수 없음 - 읽기 / 변환 / 이미지 추출 / 배치 처리 중심 작업 ### Windows direct-control path: `hwp-mcp` 다음 조건을 모두 만족할 때만 `hwp-mcp`를 선택한다. - 운영체제가 Windows - 한글(HWP) 프로그램이 실제로 설치되어 있음 - 문서 생성, 텍스트 삽입, 표 채우기, 저장 같은 **실행 중인 한글 프로그램 직접 제어**가 필요함 직접 제어 조건이 불분명하면 추측하지 말고 `@ohah/hwpjs`로 처리 가능한 범위부터 진행한다. ## Workflow ### 0. Detect the environment first ```bash node -p "process.platform" ``` - 결과가 `win32`가 아니면 `@ohah/hwpjs` - 결과가 `win32`여도 한글 프로그램 직접 제어가 확인되지 않으면 `@ohah/hwpjs` - `win32` 이고 한글 프로그램이 실제로 설치되어 있으며 직접 조작이 필요하면 `hwp-mcp` ### 1. Install the chosen backend