Trigger Scenarios

用户请求撰写或格式化韩国行政公文（如报告、计划、通知、会议纪要）要求将文本转换为符合韩国行政安全部标准的HWPX文档

Install

npx skills add chrisryugj/kordoc --skill gongmunseo -g -y

More Options

Non-standard path

npx skills add https://github.com/chrisryugj/kordoc/tree/main/.claude/skills/gongmunseo -g -y

Use without installing

npx skills use chrisryugj/kordoc@gongmunseo

指定 Agent (Claude Code)

npx skills add chrisryugj/kordoc --skill gongmunseo -a claude-code -g -y

安装 repo 全部 skill

npx skills add chrisryugj/kordoc --all -g -y

预览 repo 内 skill

npx skills add chrisryugj/kordoc --list

SKILL.md

Frontmatter

{
    "name": "gongmunseo",
    "version": "1.0.0",
    "description": "내용을 받아 한국 행정 공문서(기안문·시행문·보고서·계획서·통지·회의록) 표준 서식의 HWPX로 뽑아주는 오케스트레이터 스킬. 행정안전부 「행정업무운영편람」·시행규칙에 근거한 항목부호 8단계(1. 가. 1) 가) (1) (가) ① ㉮), 둘째 줄 내어쓰기 정렬, 공식 여백(위20·아래10·좌우20mm), 명조 15pt, 줄간격, 날짜·붙임·끝·금액 표기법을 적용해 kordoc의 공문서 모드로 변환한다. 트리거 — \"보고서 작성해줘\", \"기안문 만들어\", \"공문서로 뽑아줘\", \"계획서 써줘\", \"회의록 정리해서 hwpx\", \"공문 양식으로\", \"통지문 만들어\", \"공문서 hwpx\", \"행정 문서 작성\". 단순 md→hwpx 변환(서식 불문)은 kordoc generate 직접 사용. 기존 hwp\/hwpx 양식의 빈칸 채우기는 kordoc fill.",
    "allowed-tools": "Read, Write, Edit, Bash, AskUserQuestion",
    "argument-hint": "[작성할 내용\/주제] [종류:보고서|기안문|계획서|통지|회의록]",
    "user-invocable": true
}

공문서(公文書) 생성 스킬

내용·주제를 받아 한국 행정 공문서 표준 서식의 HWPX로 생성한다. 서식 표준은 행정안전부 「행정업무운영편람」·「행정업무의 운영 및 혁신에 관한 규정」 시행규칙 근거. 실제 렌더링(항목부호 행갈굼·여백·폰트)은 kordoc 공문서 모드(kordoc generate --preset)가 담당하므로, 이 스킬은 (1) 종류 판별 → (2) 내용을 표준 구조의 마크다운으로 작성 → (3) 변환 → (4) 경로 안내 만 한다.

절차

1. 문서 종류 판별 → 프리셋

사용자 의도	프리셋	항목부호	비고
대외 공문/시행문	`기안문`	8단계 `1. 가. 1)`	두문·본문·결문
정책·검토·결과 보고	`보고서`	불릿 `□ ○ - ㆍ` + 헤딩	개조식, 1건1매
사업·행사 계획	`계획서`	8단계	5W2H 골격
알림·통지·안내	`통지`	8단계	경어 종결
회의 기록	`회의록`	8단계	법정 9요소

의도가 모호하면 AskUserQuestion으로 종류를 확인한다. (예: "보고서로 할까요, 대외 시행문(기안문)으로 할까요?")

2. 템플릿 로드 + 내용 채우기

해당 templates/<종류>.md를 Read로 읽어 골격을 파악하고, 사용자 내용으로 채운다.

부족한 필수 정보(기관명, 수신처, 담당자·연락처, 시행일 등)는 사용자에게 묻거나, 모르면 ○○○/[기관명] 같은 플레이스홀더로 두고 "채워야 할 항목"을 마지막에 안내한다. 임의로 지어내지 말 것.
본문은 아래 표기법과 항목부호 규칙을 반드시 지켜 작성한다.

3. 마크다운 작성 규칙 (kordoc 공문서 모드가 인식하는 형식)

항목부호 = 중첩 리스트의 깊이로 표현. 마커 종류(-/1.)는 무시되고 깊이 → 부호가 강제된다. 들여쓰기 2칸 = 한 단계.

1. 첫째 항목 내용          ← 깊이0 → "1."
  - 둘째 항목              ← 깊이1(2칸) → "가."
    - 셋째 항목            ← 깊이2(4칸) → "1)"
      - 넷째 항목          ← 깊이3(6칸) → "가)"
2. 다음 첫째 항목          → "2."

깊이별 부호: 0=1. 1=가. 2=1) 3=가) 4=(1) 5=(가) 6=① 7=㉮ (자동 생성·자동 정렬)
항목이 하나뿐이면 리스트로 만들지 말고 본문 단락으로 바로 쓴다(규정: 단일 항목은 부호 생략 — 엔진도 자동 생략하지만 구조를 단순히).
보고서(--preset 보고서)는 리스트 깊이가 □ ○ - ㆍ 불릿으로 나오고, 대제목/중제목은 #/## 헤딩으로 쓴다.
가운데 정렬(행정기관명·발신명의)은 <center>광 진 구 청</center> 한 줄로.
제목/기관명은 #(h1) — 공문서 모드에서 가운데·크게 렌더된다.

4. 표기법 (본문 작성 시 직접 지킬 것 — 엔진이 안 고쳐줌)

항목	규칙	예
날짜	`YYYY. M. D.` 온점+1칸, 월·일 0 제거, 끝에도 온점	`2026. 6. 19.` / `2026. 6. 19.(금)`
기간	물결표 `∼`	`6. 1.∼6. 15.`
시각	24시각제 `HH:MM`, 시·분 0 표기	`09:00`, `14:30`
금액	숫자+한글 병기, 붙여씀	`금113,560원(금일십일만삼천오백육십원)`
붙임	`붙임` 뒤 2칸(쌍점 X), 1개면 번호 생략	`붙임 ○○○ 1부. 끝.`
끝	본문/붙임 마지막에 2칸 띄우고	`…바랍니다. 끝.`
법령명	낫표	`「행정업무의 운영 및 혁신에 관한 규정」`
쌍점	앞 붙이고 뒤 1칸(본문·항목). 표 셀의 라벨 "성 명 :"은 법정 서식 관행이라 lint 대상 아님(v4.12.3)	`일시: 2026. 6. 19.`
어투	시행문·통지=경어("~하시기 바랍니다") / 보고서·계획서=개조식 명사형("~함/~임")

생성형 AI 문체 흔적(슬롭) 제거 — AI 초안을 공문서로 옮길 때 다음으로 바꿔 쓴다 (kordoc lint가 AI_* 룰로 경고):

줄표(— – ―)는 쉼표·괄호·가운뎃점(·)으로 풀어쓴다
강조(볼드)는 리드어·핵심 수치 한 곳만 남긴다 (한 줄 3회 이상이면 lint 경고)
선언·구호형 문장과 작은따옴표 강조는 담백한 개조식 서술로 바꾼다
외래어는 행정용어로 옮긴다 — 파일럿→시범, 베이스라인→기준치, 리스크→위험 요인, 벤치마크→준용, 투트랙→병행

상세 표준은 references/reference.md(전체), 빠른 참고는 references/quickref.md.

5. 변환 → 저장

작성한 마크다운을 임시 파일로 저장 후 kordoc로 변환:

node /Users/chris_gomdori/workspace/kordoc/dist/cli.js generate <작성.md> -o <출력.hwpx> --preset <종류>

(또는 라이브러리: markdownToHwpx(md, { gongmun: { preset } }))

옵션: --font gothic(맑은 고딕, 전자결재 스타일) / --pt 14 / --line-spacing 130.

위계 폰트(--levels, v4.12.3) — 항목부호 단계(depth 0~7)마다 글꼴·크기·굵기를 지정한다. 실측 (실결재 기안문 206건·보고서 337건, references/reference.md 2.7) 근거의 처방:

문서 꼴	실측 지배 관행	처방
법정 8단계 기안문(1. 가. 1))	전 단계 본문과 동일 글꼴·크기(90%)	지정하지 말 것 (기본값)
전자결재 기안문·계획서 □/ㅇ/- 계열	□ HY견고딕 +2~3pt 굵게 · ㅇ 한컴돋움 굵게 · - 휴먼명조 본문	`--preset 계획서 --bullet2 ㅇ --levels "0=HY견고딕/17/bold,1=한컴돋움/15/bold,2=휴먼명조/14"` (본문 14~15pt 기준)
보고서 양식 □/○/-	□ 만 HY헤드라인M +1pt(개조식 실측과 동일)	보고서·계획서·개조식 프리셋 기본값이 이미 이것 — 지정 불필요

문법: 쉼표로 단계 구분, depth=글꼴/pt/bold — 숫자=pt, bold(b)=굵게, plain=굵게 해제, 그 외=글꼴명. 지정한 단계만 바뀌고 나머지는 본문 계열. 기관 표준이 따로 있으면 그 값을 넣는다(미설치 글꼴은 경고만 내고 생성). 라이브러리: markdownToHwpx(md, { gongmun: { preset, levels: { 0: { font: "HY견고딕", pt: 17, bold: true } } } }), MCP levels.

6. 결과 안내

생성된 HWPX 경로만 안내한다(파일을 직접 전송하지 말 것).
플레이스홀더로 남긴 항목이 있으면 "채워 넣을 항목" 목록으로 함께 안내한다.
검증이 필요하면 사용자에게 한글/한컴오피스로 열어 확인을 요청한다.

주의

내용(사실·수치·고유명사)은 절대 지어내지 않는다. 모르면 플레이스홀더 + 질문.
항목부호는 수동으로 "1." "가." 를 타이핑하지 말고 중첩 리스트 깊이로만 표현한다(엔진이 부호·정렬을 넣는다). 단, 보고서 대제목처럼 # 헤딩으로 쓸 부분은 헤딩으로.
공문서 글꼴·크기·여백·줄간격은 법령이 강제하지 않는 관행값이다(편람 근거). 기관 요구가 있으면 --font/--pt/--line-spacing으로 조정.