hwp-model-spec

SkillAI & models

1:1 field mapping table between HWP 5.0 and HWPX (OWPML). Referenced when designing, implementing, and verifying the hwp-model crate.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the hwp-model-spec skill

What this skill tells your AI

The instructions your AI receives, as published by ohah/hwpjs in legacy/rust/.claude/skills/hwp-model-spec/SKILL.md and read by ahel’s review.

HWP 5.0(바이너리)과 HWPX(KS X 6101:2024, XML) 두 포맷 간의 필드별 매핑 관계를 정리한 스펙 문서.

용도

  • hwp-model 공통 문서 모델 설계 시 참조
  • hwp-parser (HWP 5.0 → Document) 구현 시 변환 로직 확인
  • hwpx-parser (HWPX → Document) 구현 시 변환 로직 확인
  • hwp-writer / hwpx-writer 구현 시 역변환 로직 확인

파일 구성

파일내용
1-매핑-개요.md전체 요약, 설계 원칙, 포맷별 특성
2-resources-매핑.md글꼴, 글자모양, 문단모양, 테두리/배경, 탭, 번호, 글머리표, 스타일
3-section-매핑.md섹션 정의, 페이지 설정, 각주/미주, Grid, 단 정의, 쪽 테두리
4-paragraph-매핑.md문단, Run, 텍스트, 제어문자, 글자모양 적용, 범위태그
5-control-매핑.md머리글/꼬리말, 각주/미주, 자동번호, 필드, 책갈피
6-shape-매핑.md개체 공통, 표, 그림, 도형 6종, OLE, 수식, 묶음, 글맵시
7-hints-전용필드.mdHWP only / HWPX only 필드 정리, hints 설계

사용 방법

  • 특정 영역 구현 시 해당 번호의 .md 파일을 읽어 참조
  • 예: 표 개체 구현 → 6-shape-매핑.md, 문단 파싱 → 4-paragraph-매핑.md

Signals

GitHub stars
161
Forks
24
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
hwp-model-spec
Source
github.com/ohah/hwpjs