[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-80700":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":8,"htmlUrl":8,"language":9,"languages":8,"totalLinesOfCode":8,"stars":10,"forks":11,"watchers":10,"openIssues":12,"contributorsCount":12,"subscribersCount":12,"size":12,"stars1d":12,"stars7d":12,"stars30d":12,"stars90d":12,"forks30d":12,"starsTrendScore":12,"compositeScore":13,"rankGlobal":8,"rankLanguage":8,"license":14,"archived":15,"fork":15,"defaultBranch":16,"hasWiki":17,"hasPages":15,"topics":18,"createdAt":8,"pushedAt":8,"updatedAt":19,"readmeContent":20,"aiSummary":21,"trendingCount":12,"starSnapshotCount":12,"syncStatus":22,"lastSyncTime":23,"discoverSource":24},80700,"public-doc-to-hwpx","Kminer2053\u002Fpublic-doc-to-hwpx","Kminer2053",null,"Python",45,11,0,3.24,"MIT License",false,"main",true,[],"2026-06-12 02:04:05","# public-doc-to-hwpx\n\n> **AI 콘텐츠를 공공기관 표준 보고서로 다듬어 HWPX·메일 본문으로 변환하는 Claude Skill**\n> 한 문장 한 줄, 개조식, 두괄식 — AI가 없던 시절 한글(hwp)을 쓰던 베테랑 보고서 작성자가 만든 것처럼.\n\n[![License: MIT](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-yellow.svg)](https:\u002F\u002Fopensource.org\u002Flicenses\u002FMIT)\n[![Python 3.10+](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fpython-3.10+-blue.svg)](https:\u002F\u002Fwww.python.org\u002F)\n[![HWPX 5.1.3](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FHWPX-5.1.3-green.svg)](https:\u002F\u002Fwww.hancom.com\u002F)\n\n---\n\n## 왜 만들었나\n\n대부분의 AI 문서 자동화 도구는 **양식**(서식·레이아웃) 자동화에 집중합니다.\n하지만 공공기관에서 평생 보고서를 써온 분들이 늘 강조하는 건 다른 부분입니다.\n\n> \"보고서는 30초 안에 핵심을 파악할 수 있어야 한다.\"\n> \"한 문장에 두 개 이상의 정보가 들어가면 다시 읽게 된다.\"\n> \"`-적`, `의`, `것`, `들` — 빼도 의미가 살아나면 빼라.\"\n\n이 스킬은 **약 20여 년의 공공기관 근무 경력을 가진 직원의 보고서 작성 노하우**를\n실제 강의자료와 우수예시에서 추출하여, AI가 자동으로 글을 다듬어주는 도구로 구현했습니다.\n\nXML 빌드보다 **글쓰기 품질**을 먼저 생각하는 것이 이 스킬의 핵심입니다.\n\n---\n\n## 스킬 작동 구조 (v3.4.0 — 공공기관 문서서식 유지 방식)\n\n![public-doc-to-hwpx 스킬 작동 구조](assets\u002Fpublic_doc_to_hwpx_skill_pipeline.svg)\n\n### 핵심 변화 (v3.4.0)\n\n이전의 4단계 워크플로우는 v3.4.0에서 **공공기관 특유의 문서서식을 그대로 유지하는 6단계 파이프라인**으로 개선되었습니다.\n표·테두리·음영·결재선·페이지헤더 등 **양식의 시각 디자인은 손대지 않고, 내용만 슬롯에 채워 넣는 방식**입니다.\n\n| 단계 | v3.0.1까지 | v3.4.0+ (개선사항) |\n|------|-----------|------------------|\n| 1. 입력 | 마크다운\u002FPDF 파싱 | (동일) |\n| 2. 양식 | 4개 양식 중 선택 | (동일) |\n| 3. 콘텐츠 다듬기 | 글쓰기 최적화 규칙 적용 | **Author 가이드 참조** (원칙·구조·규칙 명확화) |\n| 4. 값매핑 | 콘텐츠 → 슬롯 직접 매핑 | **표준 매핑 문서화** (양식별 슬롯 정의 파일) |\n| 5. 빌드 파이프라인 | 처음부터 XML 생성 | **공공기관 문서서식 유지** — 양식의 표·테두리·음영 그대로, 슬롯에만 콘텐츠 삽입 |\n| 6. 출력 | (동일) | (동일) |\n\n### 공공기관 문서서식 유지 방식의 장점\n\n- ✅ **양식 디자인 100% 보존** — 한글(hwp)의 표, 테두리, 음영, 결재선, 페이지헤더 모두 그대로 유지\n- ✅ **공공기관 표준 양식 그대로** — 부서 양식·결재 라인·로고가 흐트러지지 않음\n- ✅ **외부 의존성 제거** — 표준 양식 파일을 스킬에 동봉 (python-hwpx 라이브러리 불필요)\n- ✅ **메타파일 자동 보정** — 한컴 표준 준수 메타파일 7종을 그대로 사용\n- ✅ **회귀 테스트 완료** — 4개 양식 빌드 + 메타파일 일치 + HWP 식별 모두 검증\n\n---\n\n## 이전 워크플로우 (v3.0.1)\n\n```\n┌──────────────────────────────────────────────────────────────────┐\n│                                                                  │\n│   ① 콘텐츠 정리        ②  양식 결정       ③  콘텐츠 매핑      ④ 레이아웃 최적화      │\n│   ─────────         ─────────       ─────────         ─────────         │\n│   md\u002Fdocx\u002Fpdf\u002Ftxt    참조 hwpx 우선     필수항목 매핑       적\u002F의\u002F것\u002F들 정리         │\n│   파싱 + 구조화      4개 양식 자동추천   누락 시 ※AI 플래그   한 문장 한 줄 점검       │\n│                                                       페이지 걸침 점검         │\n│                                                                  │\n└──────────────────────────────────────────────────────────────────┘\n                                  │\n                                  ▼\n                       ┌──────────────────┐\n                       │   ⑤ HWPX 빌드      │\n                       │ (이메일은 .md)     │\n                       └──────────────────┘\n```\n\n---\n\n## 4개 양식 비교\n\n| 양식 | 분량 | 독자 | 출력 | 글머리 위계 | 핵심 특징 |\n|------|------|------|------|-------------|----------|\n| **`format_1p`** | A4 1쪽 강제 | 의사결정자 | `.hwpx` | □ ○ - * | 두괄식 음영 박스 + 핵심 항목만 |\n| **`format_full`** | A4 5–30쪽 | 상급자·관계부서 | `.hwpx` | Ⅰ. 1. 가. (1) | 표지 + 목차 + 보고요약 + 본문 + 별첨 |\n| **`format_gongmun`** | A4 1–3쪽 | 외부기관·일반국민 | `.hwpx` | 1. 가. 1) (1) | 수신·제목·본문·발신명의 형식 엄수 |\n| **`format_email`** | 200–500자 | 협업자 | `.md`\u002F`.txt` | □ - * | 두괄식 결론 + 기한 명시 (메일 본문 복붙용) |\n\n---\n\n## 가장 빠른 사용법 (one-shot)\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002F\u003Cyour-username>\u002Fpublic-doc-to-hwpx.git\ncd public-doc-to-hwpx\n\n# 1페이지 보고서 빌드\npython3 scripts\u002Fcompose_doc.py input.md output.hwpx \\\n  --format format_1p \\\n  --meta meta.json \\\n  --report-path \u002Ftmp\u002Foptimization_report.md\n```\n\n### `input.md` 예시\n\n```markdown\n# ○○기관 협력사업 실무협의 보고\n\n## 추진배경\n- 한국을 대표하는 공기업과 중소기업과의 상호 협력\n- 판로 개척 어려운 중소기업의 전시·판매 통한 국가경제 발전\n\n## 추진경과\n- (6.15. ○○기관 유선협의)\n  - ○○공사에서 중소기업 제품 판로개척 노력에 감사\n  - 향후 MOU 등 적극 의사표명\n\n## 향후계획\n- MOU 체결에 따른 세부사항 협의 : '12. 6월\n- MOU 체결 : '12. 7월\n```\n\n### `meta.json` 예시\n\n```json\n{\n  \"subtitle\": \"- ○○공사와 중소기업 상생협력을 위한 -\",\n  \"author\": \"○○○처장 ○○○\",\n  \"date\": \"'25.11.\",\n  \"phone\": \"4315\"\n}\n```\n\n### 결과\n\n- `output.hwpx` — 한글에서 바로 열리는 1페이지 보고서\n- `optimization_report.md` — 자동 적용·검토 권장 사항 리포트\n\n---\n\n## 글쓰기 자동 변환 (★ 핵심 차별점)\n\n`layout_optimizer.py` 가 다음을 **자동 적용**합니다.\n\n### 신뢰도 높음 — 자동 적용\n\n| 변환 전 | 변환 후 |\n|---------|---------|\n| `~와 관련된 ~` | `~ 관련 ~` |\n| `~할 예정이었으나 이를 유예하였습니다` | `~ 예정 → 유예` |\n| `여러\u002F많은\u002F각\u002F모든\u002F수많은\u002F대부분의\u002F다양한 ~들` | (들 제거) |\n\n### 신뢰도 중간 — 검토 권장으로 표시\n\n- `~할 것으로 보입니다` → `~ 예상 \u002F ~ 전망`\n- `~한 것으로 판단됩니다` → `~ 판단 \u002F ~로 보임`\n- `~하는 것이 필요합니다` → `~가 필요합니다`\n- `~에 대한`, `~ 중 하나인`, `~의 ~의 ~` (의 연쇄)\n- `사회적\u002F경제적\u002F정치적\u002F행정적\u002F조직적` + 명사\n- 한 문장 46자 초과 (분리 후보)\n\n### Before \u002F After 예시\n\n**Before** (66자, 정보 3개 혼재):\n> 라마단 종료에 따라 중동항로의 거래량과 적재율 회복이 예상되며, 라마단 직전 적재율은 95% 수준이었고, 선사협의체는 성수기 할증료 부과를 유예하였습니다.\n\n**After** (개조식 변환):\n```\n- 라마단 종료 → 중동항로 거래량·적재율 회복 예상\n- 라마단 직전 적재율: 약 95%\n- 성수기 할증료(USD 300\u002FTEU) 부과 유예\n```\n\n---\n\n## 디렉토리 구조 (v3.6.11)\n\n```\npublic-doc-to-hwpx\u002F\n├── SKILL.md                                   # 6단계 워크플로우 + Critical Rules 23개 (Claude Skill 진입점)\n├── README.md                                  # 이 파일\n├── LICENSE                                    # MIT\n├── CHANGES.md                                 ★ v3.6.11 — 사용자용 누적 변경 요약 (통합본)\n├── RELEASE_CHECKLIST.md                       ★ v3.6.11 — 버전 업데이트 시 갱신 파일 체크리스트\n├── PUSH_GUIDE.md                              # GitHub 푸시 워크플로우 안내\n│\n├── scripts\u002F                                   ★ v3.6.11 — 공공기관 문서서식 유지 + 양식별 핫픽스 빌드\n│   │\n│   │  [핵심 빌더]\n│   ├── fill_skeleton.py                       메인 빌더 — 양식 슬롯에 콘텐츠 값 삽입\n│   ├── make_skeleton.py                       새 양식 등록 시 hwpx → 슬롯 토큰화 변환\n│   ├── build_full.py                          ★ v3.5.0 — 풀버전 통합 빌드 워크플로우 (4대 함정 검사)\n│   ├── fix_namespaces.py                      ⚠️ 필수 후처리 (빠뜨리면 한글에서 안 열림)\n│   ├── validate.py                            구조 검증\n│   │\n│   │  [페이지 처리]\n│   ├── simulate_pages.py                      ★ v3.5.0 — 페이지 시뮬레이션 + 목차 페이지번호\n│   ├── ensure_body_anchor.py                  풀버전 본문 시작 pageBreak=\"1\" 강제\n│   │\n│   │  [v3.6.x 양식별 핫픽스]\n│   ├── wrap_long_titles.py                    ★ v3.6.0\u002F3.6.4 — 표지·공문 제목 자간 압축 자동 해소\n│   ├── fix_toc_dots.py                        ★ v3.6.1\u002F3.6.2\u002F3.6.5 — 목차 점선 width 42000 통일 + 캐시 제거\n│   ├── fix_gongmun_body.py                    ★ v3.6.3 — 공문 본문 자간 압축 자동 해소\n│   ├── split_gongmun_paragraphs.py            ★ v3.6.4\u002F3.6.6 — placeholder 강제 분리\n│   ├── fix_skeleton_defects.py                ★ v3.6.6\u002F3.6.10 — Skeleton 양식 결함 자동 보정\n│   ├── expand_gongmun_body.py                 ★ v3.6.7~3.6.10 — 공문 본문 위계 동적 확장\n│   └── normalize_1p_markers.py                ★ v3.6.11 — 1p 보고서 마커(◦\u002F-\u002F*) 자동 정규화\n│\n├── templates\u002F\n│   ├── _skeleton.hwpx                         폴백 베이스 (한컴 표준 메타파일 준수)\n│   ├── charpr_mapping.json                    양식별 charPr 역할 → id 매핑표\n│   ├── government\u002Fheader.xml                  관공서 charPr\u002FparaPr\u002FborderFill 정의\n│   │\n│   ├── format_1p\u002F\n│   │   ├── standard.hwpx                      1p 보고서 표준 양식 (맑은 고딕, 35개 슬롯)\n│   │   ├── skeleton.hwpx                      슬롯 양식 (35개 슬롯)\n│   │   ├── skeleton_mapping.json              슬롯 ↔ 원본 텍스트 매핑\n│   │   └── outline_guide.md                   ★ v3.3.1 보고 목적별 11가지 표준 목차\n│   │\n│   ├── format_full\u002F\n│   │   ├── standard.hwpx                      풀버전 보고서 표준 양식 (맑은 고딕, 표 10개)\n│   │   ├── skeleton.hwpx                      슬롯 양식 (127개 슬롯 + 페이지번호)\n│   │   └── skeleton_mapping.json              슬롯 ↔ 원본 텍스트 매핑\n│   │\n│   ├── format_gongmun\u002F\n│   │   ├── standard.hwpx                      시행문 표준 양식 (굴림체, 표 셀 66개)\n│   │   ├── skeleton.hwpx                      슬롯 양식 (27개 슬롯 — fwSpace 포함)\n│   │   └── skeleton_mapping.json              슬롯 ↔ 원본 텍스트 매핑\n│   │\n│   └── format_email\u002F                          (이메일은 텍스트만, 양식 불필요)\n│\n├── references\u002F                                Claude가 작업 중 참조하는 Author 가이드 7개\n│   ├── writing-principles.md                  ★ 보고서 작성 원칙 (강의자료 + 사례 통합)\n│   ├── layout-rules.md                        ★ 레이아웃 최적화 규칙\n│   ├── format-selection.md                    양식 선택 결정트리\n│   ├── format-1p.md                           1p 보고서 가이드\n│   ├── format-full.md                         풀버전 보고서 가이드\n│   ├── format-gongmun.md                      시행문 가이드\n│   └── format-email.md                        이메일 가이드\n│\n├── examples\u002F                                  예시 values.json\n│   ├── example_values_1p.json                 ★ v3.6.11 — 1페이지 보고서 예시 (마커 입력 자유)\n│   ├── example_values_gongmun.json            시행문 예시 (모든 7개 위계 활용)\n│   └── example_values_full.json               풀버전 보고서 예시 (127슬롯)\n│\n└── assets\u002F\n    └── public_doc_to_hwpx_skill_pipeline.svg  작동 구조 설명 다이어그램\n```\n\n---\n\n## Claude Skill로 설치\n\n이 리포지토리는 [Claude Skill](https:\u002F\u002Fdocs.claude.com\u002F) 형식을 따르며, Claude·Cursor·Codex 등에서 사용 가능합니다.\n\n### Claude Desktop \u002F Web\n\n```bash\n# 1. 사용자 스킬 디렉토리에 복사\ncp -r public-doc-to-hwpx ~\u002F.claude\u002Fskills\u002F\n\n# 2. Claude 재시작 후, 자연어로 호출\n\"매출 실적 보고서 1페이지로 작성해줘\"\n\"이 내용을 시행문 양식으로 hwpx 만들어줘\"\n```\n\n### Cursor \u002F Codex\n\n`.cursor\u002Frules` 또는 `AGENTS.md` 에 다음 추가:\n\n```yaml\ndescription: HWPX 보고서 작성 시 public-doc-to-hwpx v3 사용\nglobs: [\"*.hwpx\", \"*.md\", \"*.docx\"]\n---\n1. SKILL.md 의 4단계 워크플로우를 따른다\n2. compose_doc.py 한 번으로 빌드 + 후처리 + 검증 자동\n3. layout_optimizer 의 검토 권장 사항을 사용자에게 항상 표시\n4. 1p 양식 1쪽 초과 시 풀버전 변경 권고 (자동 변경 금지)\n```\n\n---\n\n## 작성 원칙\n\n> **업무용 글쓰기의 본질 = 문제해결.**\n> 보고서의 구조 = 문제해결 프로세스 그 자체.\n>\n> 약 20여 년의 공공기관 근무 경력을 가진 직원의 「업무용 글쓰기」 강의자료(전 25페이지) + 우수예시 모음을 학습하여 도출한 글쓰기 원칙을 자동 적용합니다.\n\n상세 가이드: [`references\u002Fwriting-principles.md`](references\u002Fwriting-principles.md) · [`references\u002Flayout-rules.md`](references\u002Flayout-rules.md)\n\n### 1. 보고서 논리 패턴 — Why → How → What\n\n```\n시작(Why)    → 왜 이 사업\u002F보고를 하는가?      [제목 · 개요 · 추진배경]\n중간(How)    → 어떻게 해결할 것인가?           [현황 · 문제점\u002F원인 · 해결방안]\n마무리(What) → 무엇을 결정\u002F판단할 것인가?       [기대효과 · 조치사항 · 추진계획]\n```\n\n필수 항목이 누락되면 `※ AI 보완 필요` 플래그가 표시됩니다.\n\n### 2. 두괄식 — 첫 3줄에 핵심을\n\n- 개요는 결론·요약을 **첫 3줄 이내**에 압축\n- 1페이지 보고서는 **음영 박스(요약문)** 에 보고 목적을 1–2줄로 압축해 맨 앞에 배치\n- 의사결정자가 **30초 안에 읽고 판단**할 수 있도록 핵심부터 전달\n\n### 3. 개조식 — 키워드·항목 중심\n\n> **가독성이 높은 개조식 문체로 간결하게 기술하는 것이 원칙.**\n\n- 글머리·번호로 끊어서 키워드 중심 서술\n- 부가해설 없이 사실만 나열\n- 서술식은 시행문 본문 도입부에서만 사용\n- **서술식 → 개조식 자동 변환** 예시:\n\n  Before (66자, 정보 3개 혼재):\n  > 라마단 종료에 따라 중동항로의 거래량과 적재율 회복이 예상되며, 라마단 직전 적재율은 95% 수준이었고, 선사협의체는 성수기 할증료 부과를 유예하였습니다.\n\n  After:\n  - 라마단 종료 → 중동항로 거래량·적재율 회복 예상\n  - 라마단 직전 적재율: 약 95%\n  - 성수기 할증료(USD 300\u002FTEU) 부과 유예\n\n### 4. 「적의를 보이는 것들」 4종 — 빼야 할 군더더기\n\n> 빼도 의미가 유지되면 빼는 것이 원칙. `layout_optimizer.py` 가 자동 점검·경고합니다.\n\n| # | 표현 | 어색함 | 자연스러움 |\n|---|------|--------|-----------|\n| 1 | 접미사 `-적` | 사회**적** 현상 | 사회 현상 |\n| 2 | 조사 `의` | 매출**의** 감소 | 매출 감소 |\n| 3 | 의존명사 `것` | 검토하는 **것이** 필요합니다 | 검토가 필요합니다 |\n| 4 | 복수 표현 `들` | 여러 사람**들** | 여러 사람 |\n\n특히 `의`가 한 문장에 2번 이상 나오면 반드시 점검 대상.\n\n### 5. 문장 줄이기 5원칙\n\n**5-1. 한 문장 한 핵심** — 한 문장에 두 개 이상의 정보가 있으면 분리\n\n**5-2. 한 문장 한 줄** — 본문 한 줄 ≈ 35–45자. 46자 초과 시 자동 분리 후보\n\n**5-3. 제목은 명사형으로 짧게** — 제목은 문장이 아니라 **검색어**처럼\n\n| 긴 제목 | 짧은 제목 |\n|---------|-----------|\n| 중동 항로와 관련된 특이사항 | 중동항로 특이사항 |\n| 매장 운영의 효율성 제고 방안 | 매장 운영 효율화 방안 |\n| 신규 사업의 추진의 필요성 | 신규사업 추진 필요성 |\n\n**5-4. 판단·예정 표현 압축**\n\n| 길게 | 짧게 |\n|------|------|\n| ~할 것으로 보입니다 | ~ 예상 \u002F ~ 전망 |\n| ~한 것으로 판단됩니다 | ~ 판단 \u002F ~로 보임 |\n| ~할 예정이었으나 이를 유예하였습니다 | ~ 예정 → 유예 |\n| ~와 관련된 \u002F ~에 대한 | ~ 관련 \u002F (생략) |\n\n**5-5. 숫자는 눈에 띄게** — 천 단위 콤마(`5,210`), 단위 한글 표기(원·억원·%), 항목 끝 우측 정렬 또는 별도 표 분리\n\n### 6. 글머리 위계 — 한 체계만, 혼용 금지\n\n| 양식 | 위계 체계 |\n|------|----------|\n| 1페이지 보고서 \u002F 이메일 | `□ → ○ → - → *` (행정·실무용) |\n| 풀버전 보고서 \u002F 시행문 | `Ⅰ. → 1. → 가. → (1) → (가) → ①` (정식 행정문서) |\n\n한 문서에서 두 체계를 섞으면 `layout_optimizer` 가 경고합니다.\n\n### 7. 페이지 걸침 방지\n\n- **한 문단이 두 페이지에 걸치면 가독성 급감** — 같은 □ 아래 첫 ○ 본문, 표 헤더와 첫 행, 그림과 캡션은 반드시 같은 페이지에\n- 페이지당 권장 라인 수: A4 11pt 본문 기준 **약 38–42줄**\n- **1페이지 보고서는 무조건 1쪽** — 초과 시 부가설명·비고 우선 제거, 이후 풀버전 양식 변경 권고\n\n### 8. 시각 스타일 — 공공기관 표준 무채색\n\n| 용도 | 색상 | HEX |\n|------|------|-----|\n| 본문 텍스트 | 검정 | `#000000` |\n| 강조 (제한적) | 짙은 남색 | `#1F3864` |\n| 표 헤더 배경 | 옅은 회색 | `#D9D9D9` |\n| 음영 박스 | 옅은 회색 | `#F2F2F2` |\n| 경고 | 어두운 빨강 | `#C00000` |\n\n본문 글꼴: **함초롬바탕 11pt** (폴백: 맑은 고딕 \u002F 한컴바탕)\n\n### 9. 양식의 중요성\n\n> 공통 양식은 문서를 예쁘게 만드는 틀이 아니라,\n> **조직이 같은 기준으로 일하게 만드는 소통의 약속**입니다.\n\n좋은 양식의 5조건:\n1. **목적이 분명** — 왜 작성하는지 바로 알 수 있어야 함\n2. **작성 순서가 자연스러움** — 배경 → 현황 → 문제 → 대안 → 요청\n3. **중복 입력이 적음** — 같은 내용 두 번 쓰지 않음\n4. **검토자가 보기 쉬움** — 작성자보다 받는 사람 우선\n5. **업무 기록으로 남기 좋음** — 검색·인수인계·감사 활용 가능\n\n### 한 줄 정리\n\n> **좋은 문장은 꾸미는 문장이 아니라, 덜어낸 문장입니다.**\n> 문장을 고칠 때는 먼저 `-적`, `의`, `것`, `들`을 찾아보세요. 빼도 뜻이 유지된다면, 줄이는 편이 좋습니다.\n\n---\n\n## 출처와 학습 자료\n\n이 스킬은 **약 20여 년의 공공기관 근무 경력을 가진 직원의 보고서 작성 강의자료(전 25페이지)와\n우수예시 모음**을 학습하여 만들어졌습니다.\n저작권 보호를 위해 원문은 리포지토리에 포함하지 않으며, 핵심 원칙·패턴만 코드와 가이드에 반영했습니다.\n\n학습 자료에서 추출한 주요 내용:\n\n- 보고서 논리 패턴 (Why → How → What)\n- 개조식 ↔ 서술식 변환 사례\n- 1페이지 보고서 표준 골격 3가지 패턴 (결과보고형 \u002F 진행보고형 \u002F 동향보고형)\n- 시행문 = 서술식 + 개조식 혼용 원칙\n- 이메일 5원칙 (제목·결론·기한·파일명·참조)\n- 「적의를 보이는 것들」 4종 (-적 \u002F 의 \u002F 것 \u002F 들) 자동 점검\n\n---\n\n## 관련 도구\n\n- [chrisryugj\u002Fkordoc](https:\u002F\u002Fgithub.com\u002Fchrisryugj\u002Fkordoc) — HWP\u002FHWPX → Markdown 파서. 사용자 참조 hwpx 분석 시 활용.\n- [Hancom HWPX 공식 문서](https:\u002F\u002Fwww.hancom.com\u002F) — HWPX 5.1.3 스펙\n- [Anthropic Claude Skills](https:\u002F\u002Fdocs.claude.com\u002F) — 이 스킬의 진입점 형식\n\n---\n\n## 변경 이력\n\n| 날짜 | 버전 | 변경사항 |\n|------|------|----------|\n| 2026-04-05 | 1.0.0 | 최초 생성 (python-hwpx 직접 API) |\n| 2026-04-05 | 2.0.0 | jkf87\u002Fhwpx-skill 구조 흡수, fix_namespaces 추가 |\n| 2026-05-05 | 3.0.0 | 글쓰기 품질 강화 — 4단계 워크플로우 + 4개 양식 빌더 + layout_optimizer + 통합 파이프라인 |\n| 2026-05-06 | 3.0.1 | 한글 호환성 핫픽스 — Skeleton.hwpx 기반 빌드로 전면 전환 (메타파일 6개 한컴 표준 준수) |\n| 2026-05-07 | 3.3.0 | 페이지 시뮬레이션 추가 (simulate_pages.py + ensure_body_anchor.py) |\n| 2026-05-07 | 3.3.1 | 풀버전 목차 표준화 (outline_guide.md, 11가지 보고 유형) |\n| 2026-05-13 | **3.4.0** | **공공기관 문서서식 유지 방식 통합** — 6단계 파이프라인으로 전환, 양식 슬롯 매핑 도입, templates 구조 재정리, 내장 표준 양식 추가 |\n| 2026-05-13 | **3.5.0** | **풀버전 4대 함정 자동 검사** — build_full.py 신규 (위계 위반·빈 슬롯·마커 중복·페이지번호 미반영 해결), simulate_pages --values 인자 추가 |\n| 2026-05-14 | **3.6.0~3.6.11** | **양식별 핫픽스 누적 보정** — 표지·공문 제목 자간 압축 해소(wrap_long_titles.py), 목차 점선 깨짐 자동 보정(fix_toc_dots.py), 공문 본문 모든 위계 동적 확장(expand_gongmun_body.py), Skeleton 결함 자동 보정(fix_skeleton_defects.py), 1p 보고서 마커 자동 정규화(normalize_1p_markers.py) 등 다수 핫픽스 (상세: [CHANGES.md](CHANGES.md)) |\n\n---\n\n## 라이선스\n\nMIT License — [LICENSE](LICENSE) 참조.\n\n> 이 스킬은 공공기관 보고서 작성 노하우를 누구나 자유롭게 활용·개선할 수 있도록 공유합니다.\n> 개선 제안·이슈는 GitHub Issues 환영합니다.\n","public-doc-to-hwpx 是一个将AI生成的内容转换为符合韩国公共机构标准报告格式（HWPX）的工具。它基于具有20年经验的公文撰写者总结的最佳实践，利用Claude AI技能对文本进行优化处理，确保每句话都能简洁明了地传达信息，并且保持原有的文档布局和设计不变。该工具支持从Markdown或PDF文件中提取内容，并根据预设的模板填充至HWPX文档内，特别适用于需要快速准备高质量官方报告的场景，如政府机关、企事业单位等。此外，项目还提供邮件正文格式输出选项，增强了其适用范围。",2,"2026-06-11 04:01:41","CREATED_QUERY"]