القائمة
한글(HWPX) 문서 생성/읽기/편집. .hwpx 파일, 한글 문서, Hancom, OWPML 관련 요청 시 사용. 컨테이너(sandbox) 안에서 Python + lxml로 실행. Do NOT use for .hwp(바이너리) — .hwpx만 지원.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Create new skills, modify and improve existing skills, and validate skill structure. Use when users want to create a skill from scratch, update or optimize an existing skill, restructure SKILL.md for better triggering, or add scripts/references/assets. Do NOT use for general coding tasks, when the user just wants to use an existing skill, or when a builtin skill already covers the use case (check src/skills/ first).
워크플로우 설계 전문. 프로바이더/백엔드 구성, 에이전트 프롬프트 작성, 노드 할당, 실시간 반복 수정까지 end-to-end 워크플로우 생성·편집. Use when 사용자가 자동화 워크플로우를 만들거나 수정하려 할 때, 멀티에이전트 파이프라인을 구성할 때, closed-loop 품질 게이트가 필요할 때, 기존 워크플로우에 단계를 추가/변경/삭제할 때. Do NOT use for 단순 워크플로우 실행(이미 정의가 있으면 바로 run).
Baseline task skill example for .claude/skills/. Use as a reference template when authoring task skills. Do NOT use for builtin skills -- those go in src/skills/.
Generate map links for places, addresses, and points of interest. Use when the user mentions a location, asks for directions, or wants nearby recommendations (restaurants, cafes, etc.). Supports Google Maps, Kakao Map, and Naver Map.
Gateway direct execution 설계/구현 전문. 채널 요청을 `builtin`, `direct_tool`, `model_direct`, `workflow_compile`, `workflow_run`, `agent_required`로 분류하고, 가능한 경로는 에이전트 없이 직접 실행하도록 경계를 정리한다. Use when 게이트웨이/오케스트레이션 분리, direct tool path, model-direct path, RequestPlan, ExecutionGateway, ResultEnvelope, requested channel affinity 작업을 수행할 때. Do NOT use for phase loop 내부 구현, workflow state machine 자체 수정, 단순 프롬프트 문구 조정만 필요한 작업.
Role protocol architecture 설계/구현 전문. `src/skills/roles/*/SKILL.md`를 source of truth로 유지하면서 `RolePolicyResolver`, `ProtocolResolver`, `PromptProfileCompiler`로 역할 정책을 구조화한다. Use when 역할 기준을 런타임·워크플로우 생성기·에이전트 생성 UI가 공통으로 사용해야 할 때, `shared_protocols`를 실제 정책으로 해석해야 할 때, role baseline과 persona/task override를 분리해야 할 때. Do NOT use for 단순 문자열 prompt 조합, 한 역할의 문구만 수정하는 작업, user-facing deterministic renderer만 수정하는 작업.
| name | hwpx |
| description | 한글(HWPX) 문서 생성/읽기/편집. .hwpx 파일, 한글 문서, Hancom, OWPML 관련 요청 시 사용. 컨테이너(sandbox) 안에서 Python + lxml로 실행. Do NOT use for .hwp(바이너리) — .hwpx만 지원. |
| metadata | {"model":"remote","tools":["exec","Bash","write_file","read_file","send_file"],"triggers":["hwpx","한글","한글문서","공문","보고서","회의록","제안서","hancom"]} |
한글(Hancom Office)의 HWPX 파일을 XML 직접 작성 중심으로 생성, 편집, 읽기할 수 있는 스킬. HWPX는 ZIP 기반 XML 컨테이너(OWPML 표준)이다. python-hwpx API의 서식 버그를 완전히 우회하며, 세밀한 서식 제어가 가능하다.
사용자가 .hwpx를 첨부한 경우, 이 스킬은 아래 순서를 기본값으로 따른다.
analyze_template.py로 header.xml, section0.xml 추출build_hwpx.py + validate.py로 결과 산출 및 무결성 확인page_guard.py로 레퍼런스 대비 페이지 드리프트 위험 검사charPrIDRef, paraPrIDRef, borderFillIDRef 참조 체계 동일rowCnt, colCnt, colSpan, rowSpan, cellSz, cellMargin 동일hp:p, hp:tbl, rowCnt, colCnt, pageBreak, secPr를 변경하지 않는다validate.py 통과만으로 완료 처리하지 않는다. 반드시 page_guard.py도 통과해야 한다page_guard.py 실패 시 결과를 완료로 제출하지 않고, 원인(길이 과다/구조 변경)을 수정 후 재빌드한다R=$(command -v podman >/dev/null 2>&1 && echo podman || echo docker)
N="hwpx-$(head -c4 /dev/urandom | xxd -p)"
S="src/skills/hwpx"
# 컨테이너 내에서 전체 파이프라인 실행
$R run --rm --name "$N" -v "$PWD:/workspace:rw" -w /workspace python:3.12-slim bash -c "
pip install -q lxml &&
python3 $S/scripts/analyze_template.py reference.hwpx \
--extract-header /tmp/ref_header.xml \
--extract-section /tmp/ref_section.xml &&
# (ref_section.xml 복제 후 텍스트/데이터 수정 → new_section0.xml) &&
python3 $S/scripts/build_hwpx.py \
--header /tmp/ref_header.xml \
--section /tmp/new_section0.xml \
--output result.hwpx &&
python3 $S/scripts/validate.py result.hwpx &&
python3 $S/scripts/page_guard.py \
--reference reference.hwpx \
--output result.hwpx
"
모든 Python 스크립트는 컨테이너(sandbox) 안에서 실행한다. 호스트에 직접 python/pip 실행 금지.
R=$(command -v podman >/dev/null 2>&1 && echo podman || echo docker)
N="hwpx-$(head -c4 /dev/urandom | xxd -p)"
SKILL_DIR="src/skills/hwpx"
# 컨테이너 실행 (lxml 자동 설치)
$R run --rm --name "$N" -v "$PWD:/workspace:rw" -w /workspace python:3.12-slim bash -c "pip install -q lxml && python3 $SKILL_DIR/scripts/<script>.py <args>"
환경변수:
SKILL_DIR: 스킬 루트 디렉토리 (src/skills/hwpx)/workspace가 호스트 PWD와 매핑됨/workspace 하위에 저장해야 호스트에서 접근 가능src/skills/hwpx/
├── SKILL.md # 이 파일
├── scripts/
│ ├── office/
│ │ ├── unpack.py # HWPX → 디렉토리 (XML pretty-print)
│ │ └── pack.py # 디렉토리 → HWPX
│ ├── build_hwpx.py # 템플릿 + XML → .hwpx 조립 (핵심)
│ ├── analyze_template.py # HWPX 심층 분석 (레퍼런스 기반 생성용)
│ ├── validate.py # HWPX 구조 검증
│ ├── page_guard.py # 레퍼런스 대비 페이지 드리프트 위험 검사
│ └── text_extract.py # 텍스트 추출
├── templates/
│ ├── base/ # 베이스 템플릿 (Skeleton 기반)
│ │ ├── mimetype, META-INF/*, version.xml, settings.xml, Preview/*
│ │ └── Contents/ (header.xml, section0.xml, content.hpf)
│ ├── gonmun/ # 공문 오버레이 (header.xml, section0.xml)
│ ├── report/ # 보고서 오버레이
│ ├── minutes/ # 회의록 오버레이
│ └── proposal/ # 제안서/사업개요 오버레이 (색상 헤더바, 번호 배지)
└── references/
└── hwpx-format.md # OWPML XML 요소 레퍼런스
원칙: 사용자가 레퍼런스 HWPX를 제공한 경우에는 이 워크플로우 대신 상단의 "기본 동작 모드(레퍼런스 복원 우선)"를 사용한다.
R=$(command -v podman >/dev/null 2>&1 && echo podman || echo docker)
S="src/skills/hwpx"
# 빈 문서 (base 템플릿)
$R run --rm -v "$PWD:/workspace:rw" -w /workspace python:3.12-slim bash -c "pip install -q lxml && python3 $S/scripts/build_hwpx.py --output result.hwpx"
# 템플릿 사용
$R run --rm -v "$PWD:/workspace:rw" -w /workspace python:3.12-slim bash -c "pip install -q lxml && python3 $S/scripts/build_hwpx.py --template gonmun --output result.hwpx"
# 커스텀 section0.xml 오버라이드
$R run --rm -v "$PWD:/workspace:rw" -w /workspace python:3.12-slim bash -c "pip install -q lxml && python3 $S/scripts/build_hwpx.py --template gonmun --section my_section0.xml --output result.hwpx"
# 메타데이터 설정
$R run --rm -v "$PWD:/workspace:rw" -w /workspace python:3.12-slim bash -c "pip install -q lxml && python3 $S/scripts/build_hwpx.py --template report --section my.xml --title '제목' --creator '작성자' --output result.hwpx"
write_file 도구로 section0.xml을 워크스페이스에 작성# write_file로 section0.xml 작성 후:
R=$(command -v podman >/dev/null 2>&1 && echo podman || echo docker)
S="src/skills/hwpx"
$R run --rm -v "$PWD:/workspace:rw" -w /workspace python:3.12-slim bash -c "pip install -q lxml && python3 $S/scripts/build_hwpx.py --section section0.xml --output result.hwpx"
section0.xml의 첫 문단(<hp:p>)의 첫 런(<hp:run>)에 반드시 <hp:secPr>과 <hp:colPr> 포함:
<hp:p id="1000000001" paraPrIDRef="0" styleIDRef="0" pageBreak="0" columnBreak="0" merged="0">
<hp:run charPrIDRef="0">
<hp:secPr ...>
<!-- 페이지 크기, 여백, 각주/미주 설정 등 -->
</hp:secPr>
<hp:ctrl>
<hp:colPr id="" type="NEWSPAPER" layout="LEFT" colCount="1" sameSz="1" sameGap="0"/>
</hp:ctrl>
</hp:run>
<hp:run charPrIDRef="0"><hp:t/></hp:run>
</hp:p>
Tip: templates/base/Contents/section0.xml 의 첫 문단을 그대로 복사하면 된다.
<hp:p id="고유ID" paraPrIDRef="문단스타일ID" styleIDRef="0" pageBreak="0" columnBreak="0" merged="0">
<hp:run charPrIDRef="글자스타일ID">
<hp:t>텍스트 내용</hp:t>
</hp:run>
</hp:p>
<hp:p id="고유ID" paraPrIDRef="0" styleIDRef="0" pageBreak="0" columnBreak="0" merged="0">
<hp:run charPrIDRef="0"><hp:t/></hp:run>
</hp:p>
<hp:p id="고유ID" paraPrIDRef="0" styleIDRef="0" pageBreak="0" columnBreak="0" merged="0">
<hp:run charPrIDRef="0"><hp:t>일반 텍스트 </hp:t></hp:run>
<hp:run charPrIDRef="7"><hp:t>볼드 텍스트</hp:t></hp:run>
<hp:run charPrIDRef="0"><hp:t> 다시 일반</hp:t></hp:run>
</hp:p>
<hp:p id="고유ID" paraPrIDRef="0" styleIDRef="0" pageBreak="0" columnBreak="0" merged="0">
<hp:run charPrIDRef="0">
<hp:tbl id="고유ID" zOrder="0" numberingType="TABLE" textWrap="TOP_AND_BOTTOM"
textFlow="BOTH_SIDES" lock="0" dropcapstyle="None" pageBreak="CELL"
repeatHeader="0" rowCnt="행수" colCnt="열수" cellSpacing="0"
borderFillIDRef="3" noAdjust="0">
<hp:sz width="42520" widthRelTo="ABSOLUTE" height="전체높이" heightRelTo="ABSOLUTE" protect="0"/>
<hp:pos treatAsChar="1" affectLSpacing="0" flowWithText="1" allowOverlap="0"
holdAnchorAndSO="0" vertRelTo="PARA" horzRelTo="COLUMN" vertAlign="TOP"
horzAlign="LEFT" vertOffset="0" horzOffset="0"/>
<hp:outMargin left="0" right="0" top="0" bottom="0"/>
<hp:inMargin left="0" right="0" top="0" bottom="0"/>
<hp:tr>
<hp:tc name="" header="0" hasMargin="0" protect="0" editable="0" dirty="1" borderFillIDRef="4">
<hp:subList id="" textDirection="HORIZONTAL" lineWrap="BREAK" vertAlign="CENTER"
linkListIDRef="0" linkListNextIDRef="0" textWidth="0" textHeight="0"
hasTextRef="0" hasNumRef="0">
<hp:p paraPrIDRef="21" styleIDRef="0" pageBreak="0" columnBreak="0" merged="0" id="고유ID">
<hp:run charPrIDRef="9"><hp:t>헤더 셀</hp:t></hp:run>
</hp:p>
</hp:subList>
<hp:cellAddr colAddr="0" rowAddr="0"/>
<hp:cellSpan colSpan="1" rowSpan="1"/>
<hp:cellSz width="열너비" height="행높이"/>
<hp:cellMargin left="0" right="0" top="0" bottom="0"/>
</hp:tc>
<!-- 나머지 셀... -->
</hp:tr>
</hp:tbl>
</hp:run>
</hp:p>
1000000001부터 순차 증가1000000099 등 별도 범위 사용 권장templates/base/Contents/header.xml 복사itemCnt 속성 업데이트<hh:charPr id="8" height="1400" textColor="#000000" shadeColor="none"
useFontSpace="0" useKerning="0" symMark="NONE" borderFillIDRef="2">
<hh:fontRef hangul="1" latin="1" hanja="1" japanese="1" other="1" symbol="1" user="1"/>
<hh:ratio hangul="100" latin="100" hanja="100" japanese="100" other="100" symbol="100" user="100"/>
<hh:spacing hangul="0" latin="0" hanja="0" japanese="0" other="0" symbol="0" user="0"/>
<hh:relSz hangul="100" latin="100" hanja="100" japanese="100" other="100" symbol="100" user="100"/>
<hh:offset hangul="0" latin="0" hanja="0" japanese="0" other="0" symbol="0" user="0"/>
<hh:bold/>
<hh:underline type="NONE" shape="SOLID" color="#000000"/>
<hh:strikeout shape="NONE" color="#000000"/>
<hh:outline type="NONE"/>
<hh:shadow type="NONE" color="#C0C0C0" offsetX="10" offsetY="10"/>
</hh:charPr>
fontRef 값은 fontfaces에 정의된 font idhangul="0" → 함초롬돋움 (고딕)hangul="1" → 함초롬바탕 (명조)hp:switch 구조 포함 (hp:case + hp:default)hp:case와 hp:default의 값은 보통 동일 (또는 default가 2배)borderFillIDRef="2" 유지| ID | 유형 | 설명 |
|---|---|---|
| charPr 0 | 글자 | 10pt 함초롬바탕, 기본 |
| charPr 1 | 글자 | 10pt 함초롬돋움 |
| charPr 2~6 | 글자 | Skeleton 기본 스타일 |
| paraPr 0 | 문단 | JUSTIFY, 160% 줄간격 |
| paraPr 1~19 | 문단 | Skeleton 기본 (개요, 각주 등) |
| borderFill 1 | 테두리 | 없음 (페이지 보더) |
| borderFill 2 | 테두리 | 없음 + 투명배경 (참조용) |
| ID | 유형 | 설명 |
|---|---|---|
| charPr 7 | 글자 | 22pt 볼드 함초롬바탕 (기관명/제목) |
| charPr 8 | 글자 | 16pt 볼드 함초롬바탕 (서명자) |
| charPr 9 | 글자 | 8pt 함초롬바탕 (하단 연락처) |
| charPr 10 | 글자 | 10pt 볼드 함초롬바탕 (표 헤더) |
| paraPr 20 | 문단 | CENTER, 160% 줄간격 |
| paraPr 21 | 문단 | CENTER, 130% (표 셀) |
| paraPr 22 | 문단 | JUSTIFY, 130% (표 셀) |
| borderFill 3 | 테두리 | SOLID 0.12mm 4면 |
| borderFill 4 | 테두리 | SOLID 0.12mm + #D6DCE4 배경 |
| ID | 유형 | 설명 |
|---|---|---|
| charPr 7 | 글자 | 20pt 볼드 (문서 제목) |
| charPr 8 | 글자 | 14pt 볼드 (소제목) |
| charPr 9 | 글자 | 10pt 볼드 (표 헤더) |
| charPr 10 | 글자 | 10pt 볼드+밑줄 (강조 텍스트) |
| charPr 11 | 글자 | 9pt 함초롬바탕 (소형/각주) |
| charPr 12 | 글자 | 16pt 볼드 함초롬바탕 (1줄 제목) |
| charPr 13 | 글자 | 12pt 볼드 함초롬돋움 (섹션 헤더) |
| paraPr 20~22 | 문단 | CENTER/JUSTIFY 변형 |
| paraPr 23 | 문단 | RIGHT 정렬, 160% 줄간격 |
| paraPr 24 | 문단 | JUSTIFY, left 600 (□ 체크항목 들여쓰기) |
| paraPr 25 | 문단 | JUSTIFY, left 1200 (하위항목 ①②③ 들여쓰기) |
| paraPr 26 | 문단 | JUSTIFY, left 1800 (깊은 하위항목 - 들여쓰기) |
| paraPr 27 | 문단 | LEFT, 상하단 테두리선 (섹션 헤더용), prev 400 |
| borderFill 3 | 테두리 | SOLID 0.12mm 4면 |
| borderFill 4 | 테두리 | SOLID 0.12mm + #DAEEF3 배경 |
| borderFill 5 | 테두리 | 상단 0.4mm 굵은선 + 하단 0.12mm 얇은선 (섹션 헤더) |
들여쓰기 규칙: 공백 문자가 아닌 반드시 paraPr의 left margin 사용. □ 항목은 paraPr 24, 하위 ①②③ 는 paraPr 25, 깊은 - 항목은 paraPr 26.
섹션 헤더 규칙: paraPr 27 + charPr 13 조합. 문단 테두리(borderFillIDRef="5")로 상단 굵은선 + 하단 얇은선 자동 표시.
| ID | 유형 | 설명 |
|---|---|---|
| charPr 7 | 글자 | 18pt 볼드 (제목) |
| charPr 8 | 글자 | 12pt 볼드 (섹션 라벨) |
| charPr 9 | 글자 | 10pt 볼드 (표 헤더) |
| paraPr 20~22 | 문단 | CENTER/JUSTIFY 변형 |
| borderFill 3 | 테두리 | SOLID 0.12mm 4면 |
| borderFill 4 | 테두리 | SOLID 0.12mm + #E2EFDA 배경 |
시각적 구분이 필요한 공식 문서용. 색상 배경 헤더바와 번호 배지를 표(table) 기반 레이아웃으로 구현.
| ID | 유형 | 설명 |
|---|---|---|
| charPr 7 | 글자 | 20pt 볼드 함초롬바탕 (문서 제목) |
| charPr 8 | 글자 | 14pt 볼드 함초롬바탕 (소제목) |
| charPr 9 | 글자 | 10pt 볼드 함초롬바탕 (표 헤더) |
| charPr 10 | 글자 | 14pt 볼드 흰색 함초롬돋움 (대항목 번호, 녹색 배경) |
| charPr 11 | 글자 | 11pt 볼드 흰색 함초롬돋움 (소항목 번호, 파란 배경) |
| paraPr 20 | 문단 | CENTER, 160% 줄간격 |
| paraPr 21 | 문단 | CENTER, 130% (표 셀) |
| paraPr 22 | 문단 | JUSTIFY, 130% (표 셀) |
| borderFill 3 | 테두리 | SOLID 0.12mm 4면 |
| borderFill 4 | 테두리 | SOLID 0.12mm + #DAEEF3 배경 |
| borderFill 5 | 테두리 | 올리브녹색 배경 #7B8B3D (대항목 번호 셀) |
| borderFill 6 | 테두리 | 연한 회색 배경 #F2F2F2 + 회색 테두리 (대항목 제목 셀) |
| borderFill 7 | 테두리 | 파란색 배경 #4472C4 (소항목 번호 배지) |
| borderFill 8 | 테두리 | 하단 테두리만 #D0D0D0 (소항목 제목 영역) |
대항목 헤더 (2셀 표: 번호 + 제목):
<!-- borderFillIDRef="5" + charPrIDRef="10" → 녹색배경 흰색 로마숫자 -->
<!-- borderFillIDRef="6" + charPrIDRef="8" → 회색배경 검정 볼드 제목 -->
소항목 헤더 (2셀 표: 번호배지 + 제목):
<!-- borderFillIDRef="7" + charPrIDRef="11" → 파란배경 흰색 아라비아숫자 -->
<!-- borderFillIDRef="8" + charPrIDRef="8" → 하단선만 검정 볼드 제목 -->
R=$(command -v podman >/dev/null 2>&1 && echo podman || echo docker)
S="src/skills/hwpx"
# 1. HWPX → 디렉토리 (XML pretty-print)
$R run --rm -v "$PWD:/workspace:rw" -w /workspace python:3.12-slim bash -c "pip install -q lxml && python3 $S/scripts/office/unpack.py document.hwpx ./unpacked/"
# 2. XML 직접 편집 (read_file/edit_file 도구로)
# 본문: ./unpacked/Contents/section0.xml
# 스타일: ./unpacked/Contents/header.xml
# 3. 다시 HWPX로 패키징
$R run --rm -v "$PWD:/workspace:rw" -w /workspace python:3.12-slim bash -c "pip install -q lxml && python3 $S/scripts/office/pack.py ./unpacked/ edited.hwpx"
# 4. 검증
$R run --rm -v "$PWD:/workspace:rw" -w /workspace python:3.12-slim bash -c "pip install -q lxml && python3 $S/scripts/validate.py edited.hwpx"
R=$(command -v podman >/dev/null 2>&1 && echo podman || echo docker)
S="src/skills/hwpx"
# 순수 텍스트
$R run --rm -v "$PWD:/workspace:rw" -w /workspace python:3.12-slim bash -c "pip install -q lxml && python3 $S/scripts/text_extract.py document.hwpx"
# 테이블 포함
$R run --rm -v "$PWD:/workspace:rw" -w /workspace python:3.12-slim bash -c "pip install -q lxml && python3 $S/scripts/text_extract.py document.hwpx --include-tables"
# 마크다운 형식
$R run --rm -v "$PWD:/workspace:rw" -w /workspace python:3.12-slim bash -c "pip install -q lxml && python3 $S/scripts/text_extract.py document.hwpx --format markdown"
R=$(command -v podman >/dev/null 2>&1 && echo podman || echo docker)
S="src/skills/hwpx"
$R run --rm -v "$PWD:/workspace:rw" -w /workspace python:3.12-slim bash -c "pip install -q lxml && python3 $S/scripts/validate.py document.hwpx"
검증 항목: ZIP 유효성, 필수 파일 존재, mimetype 내용/위치/압축방식, XML well-formedness
사용자가 제공한 HWPX 파일을 분석하여 동일한 레이아웃의 문서를 생성하는 워크플로우. 이 스킬에서는 첨부 레퍼런스가 존재하면 본 워크플로우를 기본으로 사용한다.
analyze_template.py로 레퍼런스 문서 심층 분석validate.pypage_guard.py (실패 시 재수정)R=$(command -v podman >/dev/null 2>&1 && echo podman || echo docker)
S="src/skills/hwpx"
# 전체 파이프라인을 단일 컨테이너에서 실행
$R run --rm -v "$PWD:/workspace:rw" -w /workspace python:3.12-slim bash -c "
pip install -q lxml &&
python3 $S/scripts/analyze_template.py reference.hwpx \
--extract-header /tmp/ref_header.xml \
--extract-section /tmp/ref_section.xml &&
# (분석 결과 기반으로 new_section0.xml 작성) &&
python3 $S/scripts/build_hwpx.py \
--header /tmp/ref_header.xml \
--section /tmp/new_section0.xml \
--output result.hwpx &&
python3 $S/scripts/validate.py result.hwpx &&
python3 $S/scripts/page_guard.py \
--reference reference.hwpx \
--output result.hwpx
"
| 항목 | 설명 |
|---|---|
| 폰트 정의 | hangul/latin 폰트 매핑 |
| borderFill | 테두리 타입/두께 + 배경색 (각 면별 상세) |
| charPr | 글꼴 크기(pt), 폰트명, 색상, 볼드/이탤릭/밑줄/취소선, fontRef |
| paraPr | 정렬, 줄간격, 여백(left/right/prev/next/intent), heading, borderFillIDRef |
| 문서 구조 | 페이지 크기, 여백, 페이지 테두리, 본문폭 |
| 본문 상세 | 모든 문단의 id/paraPr/charPr + 텍스트 내용 |
| 표 상세 | 행×열, 열너비 배열, 셀별 span/margin/borderFill/vertAlign + 내용 |
| 스크립트 | 용도 |
|---|---|
scripts/build_hwpx.py | 핵심 — 템플릿 + XML → HWPX 조립 |
scripts/analyze_template.py | HWPX 심층 분석 (레퍼런스 기반 생성의 청사진) |
scripts/office/unpack.py | HWPX → 디렉토리 (XML pretty-print) |
scripts/office/pack.py | 디렉토리 → HWPX (mimetype first) |
scripts/validate.py | HWPX 파일 구조 검증 |
scripts/page_guard.py | 레퍼런스 대비 페이지 드리프트 위험 검사 (필수 게이트) |
scripts/text_extract.py | HWPX 텍스트 추출 |
| 값 | HWPUNIT | 의미 |
|---|---|---|
| 1pt | 100 | 기본 단위 |
| 10pt | 1000 | 기본 글자크기 |
| 1mm | 283.5 | 밀리미터 |
| 1cm | 2835 | 센티미터 |
| A4 폭 | 59528 | 210mm |
| A4 높이 | 84186 | 297mm |
| 좌우여백 | 8504 | 30mm |
| 본문폭 | 42520 | 150mm (A4-좌우여백) |
.hwp(바이너리) 파일은 지원하지 않는다. 사용자가 .hwp 파일을 제공하면 한글 오피스에서 .hwpx로 다시 저장하도록 안내할 것. (파일 → 다른 이름으로 저장 → 파일 형식: HWPX)hp:, hs:, hh:, hc: 접두사 유지python:3.12-slim 컨테이너에서 pip install lxml 후 실행. 호스트 직접 python/pip 금지validate.py로 무결성 확인<hp:t/> 사용 (self-closing tag)analyze_template.py + 추출 XML 기반으로 복원/재작성할 것.claude/skills/hwpx/examples/* 파일은 읽기/참조/복사에 사용하지 말 것validate.py와 별개로 page_guard.py를 반드시 통과해야 완료 처리