기존 HWPX 분석·서식 채우기 중심의 스킬을, 바이너리 HWP 편집까지 다루는 통합 hwp 스킬로 확장했습니다. Codex, Claude Code, OpenClaw에서 각자의 스킬 경로에 설치할 수 있습니다.
- 통합 진입점: 분석, 서식 채우기, 템플릿 관리를 하나의
hwp스킬에서 요청할 수 있습니다. 기존hwp-analyze,hwp-fill,hwp-template폴더는 통합했습니다. - 바이너리 HWP 편집: 본문·표·글자·문단 서식을 수정하는 엔진과 관련 문서를 포함했습니다. 기존 HWPX 편집도 함께 사용할 수 있습니다.
- 순서대로 편집하는 도구:
edit.mjs가 연산을 입력 순서에 따라 임시 복사본에 적용합니다. 일부 연산이 실패하면 입력 파일과 기존 출력 파일을 보존합니다. - 본문 문단 분리:
split_body_paragraph로 하나의 일반 텍스트 문단을 지정한 구분자에 따라 실제 문단으로 나눌 수 있습니다. - 제목의 페이지 배치:
start_section_page로 제목 앞에 페이지 나눔과 상단 간격을 함께 넣을 수 있습니다. 같은 작업을 반복해도 페이지 나눔이 중복되지 않도록 처리했습니다. - PDF 미리보기 내보내기:
render-pdf.mjs가 별도의 로컬 브라우저 프로필에서 문서를 렌더링하고 PDF를 생성합니다. - 관련 기능 안내 통합: 비공개 프로필로 서식 채우기, 도장·서명, 문서 요소 편집, kordoc 분석·비교·변환, 대체 텍스트 편집 CLI, Windows 한컴 자동화 사용 경로를 통합 지침에 연결했습니다. 대체 도구는 필요한 경우 별도로 설치합니다.
- 줄바꿈과 텍스트 위치: 셀 내용이나 본문을 바꿀 때 변경된 문단의 오래된 줄 배치 정보를 제거합니다. 새 내용이 예전 위치에 표시되거나 줄바꿈이 반영되지 않는 문제를 줄였습니다. 빈 문단의 원본 배치 정보는 유지합니다.
- 셀 분할 스타일: 분할한 새 셀이 다른 머리글의 색상이나 굵기를 가져오지 않고, 분할 대상 셀의 스타일을 이어받도록 수정했습니다.
- 문단 배치: 바이너리 HWP에서 다음 문단과 함께 배치, 문단 보호, 문단 앞 페이지 나눔 관련 속성을 적용하도록 보완했습니다.
- 문단 간격 단위:
spacing_before_pt,spacing_after_pt등 명시적인 pt 속성을 추가했습니다. 기존 간격 속성은 계속 HWPUNIT으로 처리합니다. - 표 테두리 두께:
width_mm로 지원되는 실제 두께를 지정할 수 있으며, 지원되지 않는 값은 오류로 처리합니다. 기존width는 두께 프리셋 번호로 유지합니다. - 파일 경로 오류: 편집·PDF 내보내기 경로에 CR/LF나 NUL이 포함되면 거부합니다. 대화에서 줄이 꺾인 한글 파일명을 그대로 경로에 사용하는 실수를 방지하도록 지침도 추가했습니다.
scripts/install.py로 설치 경로를 선택할 수 있습니다. 기본값은~/.codex/skills/hwp입니다.--replace로 교체할 때 이전 설치는 스킬 탐색 경로 밖에 백업합니다. 새 파일을 준비한 뒤 교체하며, 교체 단계가 실패하면 이전 설치를 복원합니다.- 핵심 편집 라이브러리를 포함해 일반 사용자의 별도
npm install절차를 줄였습니다. - 개인 파일 경로, 사용자 계정, 문서, 봇 토큰, 수신자 설정을 포함하지 않았습니다.
- 한국어 README를 확장했습니다. 런타임별 설치, 자연어 요청 예시, 업데이트, PDF 제한, 문제 해결, 직접 실행 방법을 안내합니다.
- 합성 문서를 사용하는 회귀 테스트를 추가했습니다. 사용자의 실제 문서는 테스트나 배포 파일에 포함하지 않습니다.
- Git으로 설치했다면 저장소에서
git pull --ff-only를 실행합니다. ZIP으로 설치했다면 새 릴리스 ZIP을 내려받아 압축을 풉니다. - 해당 폴더에서
python3 scripts/install.py --replace를 실행합니다. 다른 위치에 설치했다면 처음 사용한--dest도 지정합니다. - 새 에이전트 세션을 시작합니다.
- 기존 개별 스킬을 별도로 설치했다면 중복 여부를 확인하고 정리합니다. 설치 스크립트는 다른 이름의 스킬을 자동으로 삭제하지 않습니다.
기존 개별 스킬 이름에 의존하던 요청은 통합 hwp 스킬에 자연어로 요청하도록 변경하세요. Claude Code 플러그인 사용자는 런타임의 플러그인 업데이트 기능을 사용하면 됩니다.
- 기본 분석·편집은 Node.js 18 이상, 설치·일부 도구는 Python 3.9 이상이 필요합니다.
- 포함된 PDF 내보내기는 Node.js 22 이상과 Chrome/Chromium이 필요합니다. 브라우저 경로는
HWP_BROWSER로 지정할 수 있습니다. - 미리보기 PDF는 이미지 기반이므로 텍스트 검색·선택·복사를 제공하지 않습니다. 글꼴이나 페이지 배치는 원본 한컴 앱과 다를 수 있습니다.
- 이번에 추가한 본문 문단 분리와 제목 페이지 배치 연산은 바이너리 HWP의 section 0에 있는 일반 텍스트 문단을 대상으로 합니다. 객체·필드·범위 주석이 포함된 문단은 임의 변경하지 않고 거부합니다.
- HWP와 HWPX의 세부 연산 지원 범위는 다릅니다. 복잡한 문서의 원본 서식 보존은 저장 성공만으로 판단하지 않고, 수정한 페이지를 직접 확인해야 합니다.