# AI로 시장조사부터 한글 보고서까지 — 나만의 자동화 파이프라인

> 게시: [MS Wiki (mywiki-khaki.vercel.app)](https://mywiki-khaki.vercel.app/)

---

① 어떤 상황에서 AI를 활용했나요?

문제 인식: "보고서 쓰는 데 하루가 사라진다"
정부 ICT 정책 업무를 하다 보면 반복적인 보고서 작성이 일상입니다.
- 시장 동향·정책 현황 조사 → 2~3시간
- 내용 정리·개조식 변환 → 1~2시간
- 한글(HWP) 문서 서식 맞추기 → 1~2시간

**핵심 문제는 세 가지였습니다.**
□ 내용 생산과 서식 작업이 뒤섞여 집중력이 분산됨
□ 매번 동일한 서식(□ ○ ― 구조, 폰트, 여백)을 수작업으로 반복함
□ 작성한 내용이 보고서 파일 안에만 갇혀 재활용이 어려움

이 세 문제를 동시에 해결할 방법을 찾다가 **AI + 마크다운 + 자동화 파이프라인** 조합에 도달했습니다.

② 어떤 AI를 어떻게 활용했나요?

- 핵심 도구: Claude (Anthropic)
단순 "글 써줘"가 아닙니다.
Claude에 **재사용 가능한 전문 스킬(SKILL.md)** 을 등록해 두고, 3단계 파이프라인을 운영합니다.
동향정보의 정확성과 출처 근거를 명확하게 하기위해 gemini, perplexity에서 동시에 조사를 진행하고
출력된 내용을 클로드에서 취합 정리하는 과정을 거쳤습니다.

- 파이프라인 구조
[STEP 1] 시장조사 스킬
웹 검색 10회 이상 → 4대 영역(시장/기업/정책/기술) 자동 수집
Tier 1(KISDI·NIPA·IITP) 우선, 수치·날짜 교차 검증
결과물: 마크다운(.md) 보고서 초안
↓
[STEP 2] 문장 정제 스킬 (Sentence Normalizer)
자유 서술 → 공식 문서 규칙으로 강제 변환
□(헤드라인) ○(본문) ―(보충) ※(출처) 구조로 분해
키워드 파란색 볼드, 수치 검정 볼드 자동 적용
결과물: 구조화된 마크다운(.md)
↓
[STEP 3] HWPX 변환 스킬
MD + 기관 템플릿 → 완성 한글 보고서(.hwpx)
python3 build.py 한 줄 실행
폰트·여백·섹션바 등 서식 100% 자동 유지
결과물: 제출 가능한 .hwpx 파일

③ 활용 결과 어떤 변화가 있었나요?

- 작업 시간 단축
; 기존 (수작업) = 시장조사·수집(2~3시간 ), 개조식 정제(1~2시간), 서식화 작업(1~2시간)
; 파이프라인 이용으로 한시간 이내 초안 생성 완료

- 질적 변화 : 출처가 모든 수치에 자동으로 붙어 신뢰도 향상 , 마크다운 원본이 남아 재활용·버전 관리가 가능해짐

④ 나만의 방식 또는 개선 포인트는 무엇인가요?
- 차별점 1: 콘텐츠와 서식의 완전 분리, 기존 도구들은 내용 작성과 서식 적용이 뒤섞입니다. 이 파이프라인은 세 스킬이 **역할을 엄격히 분리**합니다. 각 스킬은 독립적이어서, 출력 형식만 바꾸면 PPTX·DOCX·PDF 등으로도 연결 가능합니다.

- 차별점 2: HWPX 변환 스킬 — 유튜브 사례를 보고 직접 개선, 공공 분야의 HWPX 자동화 필요성은 이미 커뮤니티에서 인식되어 있습니다. 다만 기존 방식들은 **공공 보고서 서식의 세부 규칙**(섹션바, □ ○ ― 개조식, 볼드 charPr ID 연속성 등)을 처리하지 못했습니다. 이를 해결하기 위해 HWPX 스킬을 개선했습니다. (섹션바 없는 템플릿도 구분선으로 자동 대체, 표 캡션자동 파싱)
- 차별점 3: MD → Quartz → 웹 동시 발행 , 고서를 한글 파일로만 끝내지 않습니다. 마크다운 원본을 **Quartz 기반 개인 위키**에 그대로 업로드하면 웹으로도 즉시 발행됩니다.> https://mywiki-khaki.vercel.app/
보고서 작성 (Claude)
↓
마크다운(.md) 저장
├── build.py → .hwpx (공문 제출용)
└── Obsidian → Quartz → Vercel → 웹 공개

- 차별점 4: SKILL.md — 재현 가능한 AI 작업 지침서, 각 스킬은 Claude가 읽는 **작업 지침 파일(SKILL.md)** 로 존재합니다. 버전 관리가 되고, 다른 사람과 공유·재사용이 가능합니다.

⑤ 다른 사람도 따라 할 수 있나요?
- 해당 스킬 공유시 각자의 ai에 프롬프트로 등록해서 개인 맞춤형 스킬이나 프롬프트로 발전 가능
- 스킬 분할로 필요한 스킬만 별도로 활용 가능
- 파이썬 다룰 수 있는 사람은 기관 서식 템플릿(.hwpx)과 SKILL.md만 있으면 `python3 build.py` 한 줄로 실행됩니다.

> "AI에게 일을 시키는 것이 아니라, > AI가 일하는 방식 자체를 설계하는 것입니다."

스킬을 한 번 만들어 두면 다음 보고서는 30분 안에 완성됩니다.
마크다운 하나로 공문 보고서와 웹 아카이브가 동시에 만들어집니다.
그리고 이 모든 과정은 누구나 따라 할 수 있도록 문서화되어 있습니다.

---

- 아래는 이 프로젝트를 만들기위해 도움 받은 참고 및 관련 링크

- [MS Wiki (Quartz 기반 개인 위키)](https://mywiki-khaki.vercel.app/)
- [YouTube: HWPX 클로드 스킬 공유 영상](https://www.youtube.com/watch?v=06UFCYfyNiA)
- [GitHub: nathankim0/easy-hwp](https://github.com/nathankim0/easy-hwp)
- [GitHub: airmang/hwpx-mcp-server](https://github.com/airmang/hwpx-mcp-server)
- [GitHub: msjang/pypandoc-hwpx](https://github.com/msjang/pypandoc-hwpx)
- [GitHub: chrisryugj/kordoc](https://github.com/chrisryugj/kordoc)


마지막으로 전 파이썬개발자도, 전문 프로그래머도 웹디자이너도 아닙니다.
물론 ai와 대화하면서 개발도구들(파이썬, 클라우드, 깃허브 등)을 배우긴 했지만요.
이 뜻은 누구나 하고 싶은 내용을 명확히 하면 자신만의 프로그램을 만들 수 있다는 얘기이기도 합니다.