---
description: 본문 완성 후 요약·정책제언을 쓰고, 전체를 조립하여 HWPX로 변환한다(gdi-hwpx 스킬 — md2hwpx 엔진 재사용).
argument-hint: "(선택) HWPX 양식 파일 경로 — 예: <P>/sources/gdi_template.hwpx (생략 시 번들 기본 양식)"
---

최종화 절차:

0. **활성 과제 확정(★선행):** 루트 `ACTIVE_PROJECT.txt`로 `<P>`(= `projects/<폴더명>`)를 확인하라. 미지정·폴더 부재이면 진행하지 말고 사용자에게 과제 지정을 요청하라. 아래 bash 예시의 `<P>`는 실제 활성 과제 경로로 치환해 실행한다.
1. **정합성 통합 검수:** `<P>/drafts/*_audit.md`의 출처 대장을 통합하여 전 장의 미확인·추정 항목과 수치 일관성·용어 통일·위계 준수를 점검하라(`gdi-auditor` 활용). 미해결 Tier A가 있으면 사용자에게 먼저 보고하라.
2. **요약(Summary) 작성 — `gdi-summarizer` 서브에이전트 호출:** 완성된 본문 전체를 근거로 3장 구성(`1. 과제의 필요성 → 2. 현황과 문제점 → 3. 정책 방향`, 목차 앞) 요약을 작성하게 하라. ★ 요약은 본문과 달리 **서술식(~다.체)** 이며 **본문에 없는 새 Tier A 사실을 도입하지 않는다.** 분량(총 약 1,000토큰·약 2,000자, 장별 300/300/400, ±5%)·문체 규칙은 `gdi-summarizer` 정의를 따른다. 결과는 `<P>/drafts/90_summary.md`로 저장된다.
3. **참고문헌 정리:** `<P>/sources/`(수동자료 + **`_research/` 자동 수집물**) 참고문헌 + `<P>/drafts/95_references_auto.md`(자료조사관 후보, 있으면) + 본문에서 실제 인용한 출처를 GDI 형식(§4.6)으로 **종합·정리**하라. **본문에서 인용한 것만** 등재하고, 서지가 불확실하면 `[서지 확인요망]`. 사용자가 수동으로 직접 추가한 항목도 보존한다. `<P>/drafts/95_references.md`로 저장.
4. **전체 조립:** 요약 → 목차(표·그림 목차 포함) → 본문 장 → 참고문헌 순으로 `<P>/drafts/99_full.md`로 병합.
5. **HWPX 변환 (`gdi-hwpx` 스킬):** 조립한 `<P>/drafts/99_full.md` 를 경북연구원 양식 한글 문서로 변환하라. 딸깍 개발실 md2hwpx 엔진을 재사용하므로 폰트·표·글머리 스타일이 양식대로 입혀진다. 양식 인자($ARGUMENTS)가 있으면 `--template` 으로 넘기고, 없으면 번들 기본 양식을 사용한다.

   ```bash
   # 양식 미지정 — 번들 기본 양식(경북연구원 정책보고서 양식)
   node .claude/skills/gdi-hwpx/build_hwpx.mjs --md <P>/drafts/99_full.md --out <P>/output/report.hwpx
   # 양식 지정 시
   node .claude/skills/gdi-hwpx/build_hwpx.mjs --md <P>/drafts/99_full.md --template $ARGUMENTS --out <P>/output/report.hwpx
   ```

   변환 후 스킬이 출력한 **매핑 표 + 자가검증(mimetype·XML 태그 균형)** 결과를 확인하라. 매핑 경고가 있으면 `--print-styles` 로 양식 스타일을 점검하고 `--mapping <json>` 으로 교정한다. 마크다운 위계 표기(▮/❍/-/제N장 등 → 스타일)는 `.claude/skills/gdi-hwpx/SKILL.md` 의 작성 규약을 따른다.

6. **그림 소싱·임베드 (§4.4.1 ① 표준 절차):**
   - ⑴ **참고문헌에서 그림 발굴 점검:** 본문 논거와 직결되는 원본 도표(계획 체계도·시장 차트·사례 구조도 등)가 `<P>/sources/` 참고문헌 PDF에 있는데 본문에 누락됐으면, `extract_fig.py`로 크롭 추출 → PNG 육안 검증 → 원문 인쇄 쪽번호 확인 후 캡션·자료주·출처 대장 등재(연번 재부여 시 상호참조 갱신) → `<P>/drafts/figures/` + `_sources.md` 로그. **본문 인용 수치의 원본 차트 최우선, 분량용 무관 도표 금지.**
   - ⑵ **임베드:** `a4_upconvert.py`로 본문 HWPX를 A4 폭으로 보정(**그림이 없어도 필수** — 7단계가 A4 입력을 가정해 무조건 native로 축소) 후, `embed_figs.py`로 PNG 임베드 → `<P>/output/report_그림.hwpx`.

   ```bash
   python .claude/skills/gdi-hwpx/finalize/a4_upconvert.py <P>/output/report.hwpx <P>/output/report_a4.hwpx
   python .claude/skills/gdi-hwpx/finalize/embed_figs.py <P>/output/report_a4.hwpx <P>/output/report_그림.hwpx <manifest.json>
   # manifest.json: [{"caption": "[그림 N-M]", "png": "<P>/drafts/figures/…png", "width_ratio": 1.0}, …]
   ```

   렌더 검증(8단계 PDF)에서 **이미지-캡션이 쪽 분리**되면 해당 그림의 `width_ratio`를 줄여(예: 0.8→0.62) 재임베드한다.

7. **조판 레이어 (`finalize/finalize_layout.mjs`):** 위 본문 HWPX 위에 겉/속표지·연구진·요약·목차·표목차·그림목차·장별 간지·장 박스·절 투명표·항 페이지·머리말 쪽번호·참고문헌 박스·뒷표지를 입힌다. ★용지는 **양식 native 190×260mm**(A4 아님)이며 본문 표·그림은 native 폭으로 자동 축소된다. 표지 치환값은 `<P>/finalize.config.json`(제목·연구번호·영문제목; **연구진·발간정보는 `[확인요망]` 유지**)로 넘긴다. 상세 규칙은 `docs/경북연구원_정책과제_작성지침.md` §8.

   ```bash
   node .claude/skills/gdi-hwpx/finalize/finalize_layout.mjs \
     --in <P>/output/report_그림.hwpx --summary <P>/drafts/90_summary.md \
     --config <P>/finalize.config.json --out <P>/output/report_최종.hwpx
   ```

   생성 후 `finalize/render_pdf.ps1 <hwpx> <pdf>`(한컴 COM)로 PDF 렌더해 **native 영역(538×737pt) 크롭**으로 육안 검증하라. 사용자 안내: ① 목차류 쪽번호 `000` → 한컴 [도구]-[차례 만들기], ② 표지 `[확인요망]` 확정값 교체, ③ PDF 내보내기 용지 = 문서 크기(190×260).

CLAUDE.md §3·§4 준수. 조립·요약 과정에서 새로운 수치·고유명사를 만들지 말 것.
