korean-report-hwpx โ ํ๊ตญ ๊ณต๋ฌธ์ MCP (๋ณด๊ณ ์ยท๋ณด๋์๋ฃยท๊ธฐ์๋ฌธ HWPX)
๋ฐ๋ชจ: ํ์ ๋ฉ๋ชจ ํ ์ฅ โ ๋ค๋ฅธ ๊ธฐ๊ด ์ฌ๋ก ์กฐ์ฌ โ ๊ณผ์ฅ๋ ๋ณด๊ณ ์ฉ 1์ชฝ ๋ณด๊ณ ์ + ๊ต์ก ์ค์ ๊ณํ ๊ธฐ์๋ฌธ(๋ด๋ถ๊ฒฐ์ฌ) ํ๊ธ ํ์ผ
์์: Claude ์ฑ(์ฝ์ํฌ)์ "ํ์๋ฉ๋ชจ ๋ณด๊ณ ๋ค๋ฅธ ๊ธฐ๊ด AI ๊ต์ก ์ฌ๋ก ์ฐพ์์ ๊ณผ์ฅ๋ ๋ณด๊ณ ์ฉ 1์ชฝ ๋ณด๊ณ ์ ๋ง๋ค์ด ์ค. ๊ต์ก ์ค์ ๊ณํ ๊ธฐ์๋ฌธ๋ ๊ฐ์ด ํ๊ธ ํ์ผ๋ก ์ค" ์์ฒญ ํ๋ โ ์ฌ๋ก ํยท์ฐ๋ฆฌ ๊ธฐ๊ด ๊ณํ 1์ชฝ ๋ณด๊ณ ์ + ๊ทธ ๋ณด๊ณ ์๋ฅผ ๋ถ์์ผ๋ก ๋จ ๋ด๋ถ๊ฒฐ์ฌ ๊ธฐ์๋ฌธ(์์ฐ '๊ธ1,200,000์(๊ธ์ผ๋ฐฑ์ด์ญ๋ง์)' ํ๊ธ ๋ณ๊ธฐ)๊น์ง(2026-11-08 ๊ณต๊ฐ, ํ์ ๋ฉ๋ชจ๋ ๊ฐ์ ์์).
ยท English
๊ณต๋ฌด์ ๊ณต๋ฌธ์(๋ณด๊ณ ์ยท๋ณด๋์๋ฃยท๊ธฐ์๋ฌธ)๋ฅผ ๊ธฐ๊ด ์์ HWPX๋ก. ์ฐ๊ณ ์๋ AI(ClaudeยทChatGPT ๋ฑ)๊ฐ ๋ฉ๋ชจยท์ด์์ ๊ณต๋ฌธ์ ๊ตฌ์กฐ๋ก ์ ๋ฆฌํ๋ฉด, ์ด ์๋ฒ๊ฐ ์์ฑ ๊ท์น์ ์๋ ค ์ฃผ๊ณ ๊ตฌ์กฐ๋ฅผ ์ ๊ฒํ ๋ค 52๊ฐ ์ค์ํ์ ๊ธฐ๊ด์ ์์ ๊ท์น๊ฐ์ผ๋ก ํ๊ธ(HWPX) ํ์ผ์ ๊ทธ๋ฆฝ๋๋ค. ์์์ ์ ์ฑ
๋ธ๋ฆฌํ ๋ณด๋์๋ฃ 2,670๊ฑด ์กฐ์ฌ๋ก ์ ํ ๊ฐ์
๋๋ค. ๋๊ตฌ 7๊ฐ, ์ธ๋ถ ์ ์ก ์์ยทAPI ํค ๋ถํ์ โ ๋ชจ๋ ์ฒ๋ฆฌ๋ ์ค์นํ ์ปดํจํฐ ์์์ ๋๋ฉ๋๋ค.
๊ฒฐ๊ณผ๋ฌผ์ ์ด์์
๋๋ค. ํ๊ธ์์ ํ์ธํ ๋ค ์ฐ์ธ์. ์ด ์๋ฒ๋ ์๊ณ ๋ฅผ ์ธ๋ถ๋ก ๋ณด๋ด์ง ์์ต๋๋ค.
์ค์น
Claude Code โ ํ ์ค: claude mcp add korean-report-hwpx -- uvx korean-report-hwpx
Claude ์ฑ(๋ฐ์คํฌํฑยท์ฝ์ํฌ) โ 3๋จ๊ณ
- uv ์ค์น (ํ ๋ฒ๋ง) โ ๋งฅ์ ํฐ๋ฏธ๋์, ์๋๋ PowerShell์ ๋ถ์ฌ ๋ฃ์ต๋๋ค.
- ๋งฅ:
curl -LsSf https://astral.sh/uv/install.sh | sh
- ์๋:
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
- Claude ์ฑ ์ค์ โ ๊ฐ๋ฐ์(Developer) โ ๊ตฌ์ฑ ํธ์ง(Edit Config) ์ผ๋ก ์ด๋ฆฐ
claude_desktop_config.json์ ์๋ mcpServers ๋ด์ฉ์ ๋ฃ๊ณ ์ ์ฅํฉ๋๋ค.
์ฑ์ด uvx๋ฅผ ๋ชป ์ฐพ์ผ๋ฉด command์ ์ ์ฒด ๊ฒฝ๋ก๋ฅผ ์๋๋ค(๋งฅ ํฐ๋ฏธ๋์์ which uvx๋ก ํ์ธ, ์: /Users/์ด๋ฆ/.local/bin/uvx).
- Claude ์ฑ์ ์์ ํ ์ข
๋ฃํ๋ค๊ฐ ๋ค์ ์ด๊ณ "์ด ๋ฉ๋ชจ๋ฅผ 1์ชฝ ๋ณด๊ณ ์๋ก ๋ง๋ค์ด ์ค"๋ผ๊ณ ์์ฒญํฉ๋๋ค.
{
"mcpServers": {
"korean-report-hwpx": {
"command": "uvx",
"args": ["korean-report-hwpx"]
}
}
}
- API ํคยทํ๊ฒฝ๋ณ์ ํ์ ์์. ๋ง๋ ํ์ผ์
~/korean-report-hwpx/์ ์ ์ฅ๋ฉ๋๋ค(KOREAN_REPORT_HWPX_OUT_DIR๋ก ๋ณ๊ฒฝ, ์ด์ ์ด๋ฆ KOREAN_GOV_DOCS_OUT_DIR๋ ์ธ์).
- ์๋์์ ์ฐ๊ธฐ: docs/WINDOWS.md
์ด๋ ๊ฒ ๋์ํฉ๋๋ค
flowchart LR
M["๋ฉ๋ชจยท์ด์ยท์ฌ์ค๊ด๊ณ"] --> AI["์ฌ์ฉ์ AI<br/>ClaudeยทChatGPT ๋ฑ"]
T["korean-tax-mcpยทkorean-tax-calc-mcp<br/>์ธ๋ฒ ๊ทผ๊ฑฐยท๊ณ์ฐ ๊ฒฐ๊ณผ"] -.->|๊ฒํ ๋ณด๊ณ ์| AI
AI --> G["get_writing_guide<br/>์์ฑ ๊ท์นยท๊ตฌ์กฐ ์คํค๋ง"]
AI -.->|๋ณด๋์๋ฃ| P["draft_press_structure<br/>์ฌ์ค ๋ฉ๋ชจ โ ๊ตฌ์กฐ ์ด์"]
G --> J["๊ตฌ์กฐ JSON"]
P --> J
J --> C["check_structure<br/>์ ๊ฒยทtarget_pages ๋ถ๋"]
C --> B["build_document<br/>๊ธฐ๊ด ์์ HWPX"]
B -->|warnings| J
R[("๊ธฐ๊ด ๊ท์น๊ฐ 52๊ณณ<br/>list_ministriesยทget_rules")] -.-> B
B --> O["~/korean-report-hwpx/<br/>.hwpx + ๊ตฌ์กฐ .json + ๊ฐ์ํ .md"]
์ธ๋ฒ MCP(korean-tax-mcpยทkorean-tax-calc-mcp)์ ํจ๊ป ์ฐ๋ฉด ๊ทผ๊ฑฐ ์ฐพ๊ธฐ โ ๊ณ์ฐ โ ๊ฒํ ๋ณด๊ณ ์ HWPX๊น์ง ์ด์ด์ง๋๋ค.
์ด๋ ๊ฒ ๋ฌผ์ด๋ณด์ธ์
AI์๊ฒ ํ์์ฒ๋ผ ๋งํ๋ฉด ๋ฉ๋๋ค. ๋๊ตฌ ์ด๋ฆ์ ๋ชฐ๋ผ๋ ๋ฉ๋๋ค.
| ์ด๋ ๊ฒ ๋งํ๋ฉด | ์ด๋ ๊ฒ ๋์ต๋๋ค |
|---|
| "์ด์ ํ์ ๊ฒฐ๊ณผ๋ฅผ ๊ณผ์ฅ๋๊ป ๋ณด๊ณ ํ 1์ชฝ์ง๋ฆฌ ๋ณด๊ณ ์๋ก ๋ง๋ค์ด ์ค" | ๋ณธ๋ฌธ 1์ชฝ์ ๊ฝ ์ฑ์ฐ๊ณ ์ธ๋ถ๋ ๋ถ์์ผ๋ก. ๋์น๊ฑฐ๋ ๋ ์ฐจ๋ฉด target_pages ๊ฒฝ๊ณ ๋๋ก AI๊ฐ ๋ค์ ๋ง๋ฆ |
| "์ด ๋ฉ๋ชจ๋ฅผ โโ๋ถ ๋ณด๊ณ ์๋ก ๋ง๋ค์ด ์ค" | 42๊ฐ ๊ธฐ๊ด ๋ณด๊ณ ์ ์์(๊ธฐ๊ด์ ๋งํ์ง ์์ผ๋ฉด ๊ณตํต ์์) |
| "๋ด๋ถ ๊ฒฐ์ฌ์ฉ์ผ๋ก ๋ง๋ค์ด ์ค" | ๋ด๋ถ ๊ฒฐ์ฌ ๋ณด๊ณ ์ ์์('26. 11. 8.(์ผ) / ๊ณผ๋ช
, ์ชฝ ๋ฒํธ "- n -") |
| "๋ฒํธ ๋งค๊ธฐ๋ ๊ฐ์ํ ์์์ผ๋ก, ๋งํฌ๋ค์ด๋ ๊ฐ์ด" | โ
. 1. ๊ฐ. ๋ฒํธ ์์ + .md ํ์ผ |
| "์ด ์๊ณ ๊ตญ์ธ์ฒญ ๋ณด๋์๋ฃ๋ก ๋ง๋ค์ด ์ค, ๋ณด๋์์ 2026. 10. 8.(๋ชฉ) ์กฐ๊ฐ" | 52๊ฐ ๊ธฐ๊ด ๋ณด๋์๋ฃ ์์, ๋ฆฌ๋ยท์ ๋ชฉยท์ธ์ฉยท์ซ์ ํ๊ธฐ ์ ๊ฒ |
| "์ด ๋ณด๊ณ ์ ๊ฒฐ์ฌ ์ฌ๋ฆด ๊ธฐ์๋ฌธ ๋ง๋ค์ด ์ค, ๋ถ์์ ๋ฐฉ๊ธ ๋ณด๊ณ ์" | ๊ธฐ์๋ฌธ(๋ณ์ง ์ 1ํธ์์), ํญ๋ชฉ ๋ฒํธยท๊ฒฐ์ฌ๋ยท"๋." ์๋ |
| "์๊น ๋ณด๊ณ ์์์ โ
ข์ฅ โก ๋ฌธ์ฅ๋ง ๋ฐ๊ฟ์ ๋ค์ ๋ง๋ค์ด ์ค" | ํ์ผ ์์ ์ ์ฅ๋ ๊ตฌ์กฐ(.json)๋ฅผ ๊ณ ์ณ ๋ค์ ์์ฑ |
| "์ฐ๋ฆผ์ฒญ ๋ณด๊ณ ์ ์์ ๊ท์น ๋ณด์ฌ ์ค" | ๊ณ์ธต๋ณ ๊ธฐํธยท๊ธ๊ผดยทํฌ๊ธฐยท๋น ์ค ๊ท์น๊ฐ |
๊ฒํ ์ยท์ถ์ง๊ณํยทํ์ ๊ฒฐ๊ณผยทํํฉ ๋ณด๊ณ ๋ ๋ชจ๋ ๋ณด๊ณ ์๋ก ๋ง๋ญ๋๋ค. ๊ฐ์ ์๋ฃ๋ก ๋ณด๊ณ ์ โ ๋ณด๋์๋ฃ โ ๊ธฐ์๋ฌธ์ ์ด์ด์ ๋ง๋ค ์๋ ์์ต๋๋ค.
๋งํฌ
English README ยท llms.txt ยท CHANGELOG ยท PyPI ยท ์๊ฐ ํ์ด์ง ยท ์ง ์๋ฒ korean-tax-mcpยทkorean-tax-calc-mcp
โญ ์จ ๋ณด์๊ณ ๋์์ด ๋์
จ๋ค๋ฉด ๋ณ ํ๋ ๋๋ฌ ์ฃผ์ธ์. ๋ฌด๋ฃ ๊ณต๊ฐ๋ฅผ ๊ณ์ ์ด์ด ๊ฐ๋ ํ์ด ๋ฉ๋๋ค.
๋๊ตฌ (7๊ฐ)
| ๋๊ตฌ | ํ๋ ์ผ |
|---|
get_writing_guide | ๋ฌธ์ ์ข
๋ฅ ํ๋จ ๊ธฐ์ค, ์์ฑ ๊ท์น(โก ๋๊ด์ ํ ๋ฌธ์ฅยทใ
๊ทผ๊ฑฐยท- ์ธ๋ถ, ๋ช
์ฌํ ์ข
๊ฒฐ, ์ฌ์คยท์ซ์ ์ฐฝ์ ๊ธ์ง, ๊ธฐํธ๋ ํ
์คํธ์ ๋ฃ์ง ์์, ์ฐธ๊ณ ยท๋ถ์ ๊ตฌ์กฐ, ๊ธฐ์๋ฌธ ํญ๋ชฉ ๋ฒํธยท๋ ์งยท๊ธ์กยท๋ ํ์ยท๋ถ์), ๊ตฌ์กฐ JSON ์คํค๋งยท์์. MCP prompt writing_guide๋ก๋ ์ ๊ณต |
draft_press_structure | ์ฌ์ค ๋ฉ๋ชจ(๋๊ฐยท์ธ์ ยท๋ฌด์, ๋ฐฐ๊ฒฝยทํต์ฌ ๋ด์ฉยท๊ณํ, ์ธ์ฉ, ๋ด๋น ๋ถ์, ์ซ์ ๋ฑ)๋ฅผ ๋ณด๋์๋ฃ ๊ตฌ์กฐ JSON ์ด์์ผ๋ก ์ฎ๊ธด๋ค. ๋ฉ๋ชจ์ ์๋ ๋ฌธ์ฅยท์ซ์ยท์ด๋ฆ์ ๋ง๋ค์ง ์์ผ๋ฉฐ, ๋ฆฌ๋ยท์ธ์ฉยทํยท์ฐธ๊ณ ์๋ฃ๋ฅผ ๊ท์น์ ๋ง๊ฒ ๋ฐฐ์นํ๋ค |
check_structure | ์์ฑ ์ ์ ๊ฒ: ํ์ ํ๋, text ์ ๊ธฐํธ, ๊ณ์ธต ๊ฑด๋๋, โก ๋ ๋ฌธ์ฅ ์ด์, ๋ช
์ฌํ ์ข
๊ฒฐ ์๋ ๋ฌธ์ฅ, ๊ธด ์ ๋ชฉ, target_pages ๋ถ๋, ๊ธฐ์๋ฌธ์ ํ์ ํคยทtoยทdisclosure ํ์ฉ๊ฐยท๊ฒฐ์ฌ๋ drafter/approver ํ์ยทattachments ๋ฌธ์์ด ๋ชฉ๋ก ๊ฒ์ฆ |
build_document | ๊ตฌ์กฐ JSON โ ๊ธฐ๊ด ์์ HWPX. ์
๋ ฅ ์ ๊ทํ(๊ธฐํธยท๋์ยท์ ๊ณต๋ฐฑ ์ ๊ฑฐ) + ๊ณ ์น ์ (warnings) ๋ฐํ. ๊ธฐ์๋ฌธ์ doc_type="official", ๊ธ์ก ํ๊ธ ๋ณ๊ธฐ ๊ฒฝ๊ณ ยท๋ ์ง ์ ๊ทํ ํฌํจ |
build_from_structure | build_document์ ๋ณ์นญ(์ด์ ์ด๋ฆ, ์ธ์ ๊ฐ์) |
list_ministries | ์ง์ ๊ธฐ๊ด๊ณผ ๋ฌธ์ ์ข
๋ฅ๋ณ ์ง์ ์ฌ๋ถ(๋ณด๊ณ ์: ๊ธฐ๊ด ๊ท์น/๊ณตํต ๊ท์น, ๋ณด๋์๋ฃ: ๋ณธ๋ฌธ ๋ฐฉ์, ๊ธฐ์๋ฌธ: ๊ณตํต ์์) |
get_rules | ๊ธฐ๊ดยท๋ฌธ์ ์ข
๋ฅ๋ณ ์์ ๊ท์น๊ฐ(๊ณ์ธต๋ณ ๊ธฐํธยท๊ธ๊ผดยทํฌ๊ธฐยท๋ด์ด์ฐ๊ธฐยท๋น ์ค, ์ ๋ชฉ ์์ยทํ ๋จธ๋ฆฌ, ๊ธฐ์๋ฌธ์ rules_official/_๊ณตํต.json) |
๋ณด๊ณ ์๊ฐ ์ด๋ ๊ฒ ๋์ต๋๋ค (์์ ๊ธฐ๋ฅ)
| ๊ธฐ๋ฅ | ๋ด์ฉ |
|---|
| ๊ฐ์กฐ์ ๊ณ์ธต | ์์ ๋ชฉ(โ
. โ
ก.) โ โก ๊ฒฐ๋ก ํ ๋ฌธ์ฅ โ ใ
๊ทผ๊ฑฐ โ - ์ธ๋ถ โ * ๊ฐ์ฃผ, โป ์ฐธ๊ณ . ๊ธฐํธยท๋ค์ฌ์ฐ๊ธฐยท๊ธ๊ผด์ ๊ธฐ๊ด ๊ท์น๊ฐ |
| ๊ฐ์กฐยท๊ฐ์ฃผ | **ํต์ฌ ๋ฌธ๊ตฌ**๋ ๊ตต๊ฒ, ๋ฌธ์ฅ ์ *ยท**๋ ์์ฒจ์ ๊ฐ์ฃผ ํ์ |
| ๋ถ์ ํ์ | ๋ฌธ์ฅ ๋ "๋ถ์ 1"ยท"์ฐธ๊ณ 2"๋ ์์๋ก ํ์ํ๊ณ , ๋ถ์ยท์ฐธ๊ณ ๋ ์ ์ชฝ์์ ๋จธ๋ฆฌ ํ๋ก ์์ |
| ํ | ์์๋ ๊ตต์ ์ , ๋จธ๋ฆฌํ ์๋ ์ด์ค์ , ๋จธ๋ฆฌํ ์
์ ์์, ์ข์ฐ ๋ฐ๊นฅ์ ์์. ํ ์ค์ง๋ฆฌ ์ด์ ๊ฐ์ด๋ฐ ์ ๋ ฌ. ์ชฝ์ ๋์ผ๋ฉด ๋จธ๋ฆฌํ ๋ฐ๋ณต |
| ๋ถ๋ ์ ๊ฒ | ๋ชฉํ ์ชฝ์(target_pages)๋ฅผ ์ฃผ๋ฉด ๋ณธ๋ฌธ ์ชฝ์ยท๋ง์ง๋ง ์ชฝ ์ฑ์์ ์ฌ์ ๋์นจยท๋ ์ฐธยท๋ถ์ ์์์ ๊ฒฝ๊ณ |
| 1์ชฝ ๋ณด๊ณ ์ ๊ท์น | "์ฒซ ์ฅ์ด ๋ณด๊ณ ์ ์ ๋ถ" โ ๊ฐ์๋ ํ, โก๋ ํ ๋ฌธ์ฅ ์์ถ, ๋๋ฌป์ง ์๊ฒ ๊ฝ ์ฑ์ฐ๊ณ ์ธ๋ถ๋ ๋ถ์(์์ฑ ๊ฐ์ด๋์ ํฌํจ) |
| ์๊ฐ ๋ง์ถค | ๋ฌธ๋จ๋ง๋ค ์๊ฐยท์ฅํ์ ๊ณจ๋ผ ๋ง์ง๋ง ์ค์ ํ๋ ๊ธ์๋ง ๋จ์ง ์๊ฒ. ๋งฅ+ํ๊ธ์ด ์์ผ๋ฉด polish=True๋ก ์ค์ ์ค ๋ฐฐ์น์ ๋ง์ถฐ ๋ค๋ฌ๊ธฐ |
| ์์ ์ธ ๊ฐ์ง | ํ์ค ยท ๋ด๋ถ ๊ฒฐ์ฌ(report_kind="internal") ยท ๊ฐ์ํ(style="simplified", ๋งํฌ๋ค์ด ๋์ ์ถ๋ ฅ) |
๋ฌธ์ ์ข
๋ฅยท๋ถ๋ ์ ๊ฒ
| ์ข
๋ฅ | ๊ตฌ์ฑ | ๊ธฐ๊ด ์ง์ | ๊ท์น |
|---|
| ๋ณด๊ณ ์(๊ฐ์กฐ์) | ์ ๋ชฉ ์์, ์์ฑ์ผยท์์ฑ๋ถ์ ์ค(์ ํ), ์์ ๋ชฉ(โ
. โ
ก.) โ โก โ ใ
โ - โ *, โป ์ฐธ๊ณ , ๊ตต๊ฒยท๊ฐ์ฃผ, ํ, ๋ถ์ ํ์ ์์, ๋ถ์ยท์ฐธ๊ณ ์ชฝ, ๋ถ๋ ์ ๊ฒ | ์ ํ โ 42๊ฐ ๊ธฐ๊ด ๊ท์น, ๊ทธ ์ธยท๋ฏธ์ง์ ์ ๊ณตํต ๊ท์น | rules_report/ (๋ณด๋์๋ฃ ์ฐธ๊ณ ยท๋ถ์ ๊ตฌ๊ฐ 1,326๊ฑด) |
| ๋ณด๋์๋ฃ | ํ์ง(๋ก๊ณ ์๋ฆฌยท๋ณด๋์๋ฃ), ๋ณด๋์์ ยท๋ฐฐํฌ, ์ ๋ชฉยท๋ถ์ , ๋ณธ๋ฌธ(๋ฌธ๋จ์/โก์), ๋ด๋น ํ, ์ฐธ๊ณ ์ชฝ | ํ์ โ 52๊ฐ ๊ธฐ๊ด | rules/ยทtemplates/ (๋ณด๋์๋ฃ 2,670๊ฑด) |
| ๊ธฐ์๋ฌธยท์ํ๋ฌธ(๋ณ์ง ์ 1ํธ์์) | ๋๋ฌธยท๋ณธ๋ฌธยท๊ฒฐ๋ฌธ, ํญ๋ชฉ ๋ฒํธ(1.โ๊ฐ.โ1)โ๊ฐ)โ(1)โ(๊ฐ)) ์๋, ๋ถ์, "๋." ํ์, ๊ฒฐ์ฌ๋(ํ), ํ์กฐ์, ์ํ/์ ์, ์ฃผ์ยท์ฐ๋ฝ์ฒยท๊ณต๊ฐ๊ตฌ๋ถ | ๊ธฐ๊ด ์ง์ ์์ด ๊ณตํต ์์(rules_official/_๊ณตํต.json) | rules_official/_๊ณตํต.json (ํ์ ์
๋ฌด๊ท์ ์ 7์กฐยท์ํ๊ท์น ์ 2ยท4ยท6์กฐ) |
์ฌ์ฉ ํ๋ฆ โ AI์๊ฒ "์ด ๋ฉ๋ชจ๋ฅผ โโ๋ถ ๋ณด๊ณ ์๋ก ๋ง๋ค์ด ์ค" โ AI๊ฐ get_writing_guide๋ก ์์ฑ ๊ท์น ํ์ธ โ ์๊ณ ๋ฅผ ๊ตฌ์กฐ JSON์ผ๋ก ์์ฑ โ build_document โ ๊ฒฐ๊ณผ์ warnings(๊ณ ์น ์ )๊ฐ ์์ผ๋ฉด AI๊ฐ ๊ณ ์ณ ๋ค์ ์์ฑ.
๋ถ๋ ์ ๊ฒ: ์ฌ์ฉ์๊ฐ "1์ชฝ์ผ๋ก", "3์ชฝ ์ด๋ด๋ก"์ฒ๋ผ ๋ถ๋์ ๋งํ๋ฉด AI๊ฐ target_pages๋ก ๋๊ธฐ๊ณ , ๋๊ตฌ๋ ๋ณธ๋ฌธ ์ชฝ์ยท๋ง์ง๋ง ์ชฝ ์ฑ์์ ์์ธกํด ๋ชฉํ๋ฅผ ๋๊ฑฐ๋ ๋ ์ฐจ๊ฑฐ๋(80% ๋ฏธ๋ง) ๋ถ์์ด ์์ผ๋ฉด ๊ฒฝ๊ณ ํฉ๋๋ค. ๋ถ๋์ ๋งํ์ง ์์ผ๋ฉด ์ชฝ์ ์ ํ ์์ด ๋ง๋ญ๋๋ค. ์์ธก์ ์ค์ ๋ก ๋ง๋ค ๋ฌธ์๋ฅผ ํ๊ธ ๋ฐฐ์น ๊ท์น(์ธํจ์ด์ค ๋ณดํธ, ์์ ๋ชฉ์ ๋ค์ ๋ฌธ๋จ๊ณผ ๊ฐ์ ์ชฝ, ํ๋ ํ ๋จ์๋ก ๋๋๊ณ ๋จธ๋ฆฌํ ๋ฐ๋ณต)๋๋ก ์์ ๊ณ์ฐํฉ๋๋ค. ๋งฅ ํ์ปด์คํผ์ค ํ๊ธ๋ก ์ค์ธกํ 54๊ฐ ๋ฌธ์(1โ6์ชฝ, ํ์คยท๋ด๋ถ ๊ฒฐ์ฌยท๊ฐ์ํ)์์ ์ชฝ์๊ฐ ๋ชจ๋ ๋ง์์ต๋๋ค.
๋ฌธ์ ์ข
๋ฅ ํ๋จ ๊ธฐ์ค(๊ฐ์ด๋์ ํฌํจ): ์ธ๋ก ยท๊ตญ๋ฏผ ๋์ ๋ฐํยท๋ฐฐํฌ์ฉ์ด๋ฉด ๋ณด๋์๋ฃ, ๋ด๋ถ ๋ณด๊ณ ยท๊ณํยท๊ฒํ ๋ฉด ๋ณด๊ณ ์, ํ์ ์
๋ฌด๊ท์ ๋ณ์ง ์ 1ํธ์์ ๊ธฐ์๋ฌธยท์ํ๋ฌธ์ด ํ์ํ๋ฉด official.
๋ณด๋์๋ฃ ์์ฑ ๋ฐฉ๋ฒ๊ณผ ์ฌ์ค ๋ฉ๋ชจ ์์
get_writing_guide(doc_type='press_release', ministry=๊ธฐ๊ด)์ ํธ์ถํ๋ฉด ๋ณด๋์๋ฃ ์์ฑ ๋ฐฉ๋ฒ(๋ฆฌ๋ยท์ ๋ชฉยท์ธ์ฉยท์ซ์ยท์ฌ์ด ๋ง)๊ณผ ์ฌ์ค ๋ฉ๋ชจ ์์, ๊ธฐ๊ด๋ณ ๊ฐ์ ์์๋ฅผ ํจ๊ป ์ ๊ณตํ๋ค. ๊ทผ๊ฑฐ๋ ๊ตญ๋ฆฝ๊ตญ์ด์ ๋ณด๋์๋ฃ ์์ฑ ์ง์นจ๊ณผ ์ ์ฑ
๋ธ๋ฆฌํ ๋ณด๋์๋ฃ 2,667๊ฑด ์ค์ธก์ด๋ค(์์ง 2,670๊ฑด ์ค ๋ณธ๋ฌธ ์ค์ธก์ ์ด 2,667๊ฑด).
์ฌ์ค ๋ฉ๋ชจ ์์(๊ณผํ๊ธฐ์ ์ ๋ณดํต์ ๋ถ ๊ฐ์ ์ฌ๋ก):
{
"kind": "๋ณด๋์๋ฃ",
"ministry": "๊ณผํ๊ธฐ์ ์ ๋ณดํต์ ๋ถ",
"release": "2026. 11. 4.(์) ์กฐ๊ฐ",
"headline": "์ด๋ฅด์ ๋์งํธ ๋ฐฐ์ํฐ ํค์ค์คํฌ ๊ต์ก 4,820๋ช
์๋ฃ",
"subtitles": ["๊ต์ก์ฅ 37๊ณณ ์ด์ ๊ฒฐ๊ณผ, ์๋ฃ์ ๋ง์กฑ๋ 92.4%"],
"who": "๊ณผํ๊ธฐ์ ์ ๋ณดํต์ ๋ถ(์ฅ๊ด โโโ)",
"when": "11์ 3์ผ(ํ)",
"what": "์ฌํด ์ด๋ฅด์ ๋์งํธ ๋ฐฐ์ํฐ ํค์ค์คํฌ ๊ต์ก ์ด์ ๊ฒฐ๊ณผ๋ฅผ ๋ฐํํ๋ค",
"points": ["3์๋ถํฐ 10์๊น์ง ์ ๊ตญ ๊ต์ก์ฅ 37๊ณณ์์ ์ด๋ฅด์ 4,820๋ช
์ด ๊ต์ก์ ๋ง์ณค๋ค."],
"numbers": [{"item": "์๋ฃ ์ธ์", "value": "4,820", "unit": "๋ช
", "basis": "2026. 3.~10."}],
"quote": {"speaker": "โโโ ๊ณผํ๊ธฐ์ ์ ๋ณดํต์ ๋ถ ์ฅ๊ด", "text": ["์ด๋ฅด์ ๋๊ตฌ๋ ๋ฌด์ธ ๊ธฐ๊ธฐ๋ฅผ ๋ถํธ ์์ด ์ธ ์ ์๋๋ก ๊ฐ๊น์ด ๊ณณ์์ ๋ฐฐ์ธ ๊ธฐํ๋ฅผ ๋ํ๊ฒ ๋ค."], "verb": "๋งํ๋ค"},
"contact": {"dept": "๊ณผํ๊ธฐ์ ์ ๋ณดํต์ ๋ถ ๋์งํธํฌ์ฉ์ ์ฑ
๊ณผ", "people": [["์ฑ
์์", "๊ณผ์ฅ", "โโโ", "(044-202-0000)"]]}
}
์ดํ draft_press_structure(facts, ministry) โ ๊ตฌ์กฐ JSON ์ด์ + missingยทwarnings โ ๋ฌธ์ฅ ๋ค๋ฌ๊ธฐ โ check_structure(structure, 'press_release', ministry=๊ธฐ๊ด) โ build_document(structure, 'press_release', ๊ธฐ๊ด).
์ถ์ฒ:
- ๊ตญ๋ฆฝ๊ตญ์ด์, ใ์ ํ๋ณ๋ก ์์๋ณด๋ ๋ณด๋์๋ฃ ์์ฑ ๊ธธ์ก์ดใ(2020) โ G20
- ๊ตญ๋ฆฝ๊ตญ์ด์, ใ๋ณด๋์๋ฃ ์ ํ๋ณ ํ์ค์ ๊ฐ๋ฐใ(2020) โ R20
- ๊ตญ๋ฆฝ๊ตญ์ด์, ใ๋ณด๋ ์๋ฃ ์ฐ๊ธฐ ๊ธธ์ก์ดใ(2011) โ G11
- ๊ตญ๋ฆฝ๊ตญ์ด์, ใ๊ฐ์ ํ ํ๋์ ์์๋ณด๋ ๊ณต๊ณต์ธ์ด ๋ฐ๋ก ์ฐ๊ธฐใ(2022) โ H22
- ๋ฌธํ์ฒด์ก๊ด๊ด๋ถยท๊ตญ๋ฆฝ๊ตญ์ด์, ใ์ฌ์ด ๊ณต๊ณต์ธ์ด ์ฐ๊ธฐ ๊ธธ์ก์ดใ(2014) โ E14
- ์ ์ฑ
๋ธ๋ฆฌํ(korea.kr) ๋ณด๋์๋ฃ 2,667๊ฑด ๋ณธ๋ฌธ ์ค์ธก(52๊ฐ ์ค์ํ์ ๊ธฐ๊ด) โ C
๊ฐ์ํ ๋ชจ๋ (style="simplified")
AI๊ฐ ์ฝ๊ธฐ ์ฌ์ด ๋ณด๊ณ ์ ์์(๋ฒํธ ์ฒด๊ณ ํ์คํ, ์์ ์ ๋ฌธ์ฅ, ๋จ์ํ ํ). ํญ๋ชฉ ๊ธฐํธ๋ฅผ ๋จ๊ณ๋ณ ๋ฒํธ๋ก ์๋ ๋ถ์ฌํ๊ณ , ์ ๋ชฉ ์์ยทํ ๋จธ๋ฆฌ ์์์ ์์ค ๊ฐ๊ฒฐํ ์์.
์ฌ์ฉ๋ฒ: build_document(..., style="simplified") ๋๋ get_writing_guide(..., style="simplified")๋ก ์ง์ .
๊ฐ์ํ ๋ชจ๋ ํน์ง:
- ํญ๋ชฉ ๊ธฐํธ(โก ใ
โ - * โป) ๋์ ๋จ๊ณ๋ณ ๋ฒํธ ์๋ ๋ถ์ฌ: โ
. โ
ก. โ
ข. (์์ ๋ชฉ) โ 1. 2. 3. (๋ํญ๋ชฉ) โ ๊ฐ. ๋. ๋ค. (์คํญ๋ชฉ) โ 1) 2) 3) (์ํญ๋ชฉ) โ ๊ฐ) ๋) ๋ค) (์ธํญ๋ชฉ)
- ๋ฒํธ๋ ์๋ฒ๊ฐ ๊ตฌ์กฐ JSON์ ๊ณ์ธต ์์ค(level)์์ ๊ณ์ฐํ๋ฏ๋ก ์ฌ์ฉ์๊ฐ ์ง์ ๋ฒํธ๋ฅผ ์ฐ์ง ์์
- ๋จ๊ณ๋ณ ๋ค์ฌ์ฐ๊ธฐ ์ ์ง
- ์์ ์ ๋ฌธ์ฅ ํ์ฉ (~ํฉ๋๋คยท~ํ๋ค ๋ฑ ๋์ฌํ ์ข
๊ฒฐ ๊ฐ๋ฅ, ๋ช
์ฌํ ์ข
๊ฒฐ ๊ฒฝ๊ณ ์์)
- ์ ๋ชฉ ์์(ํ
๋๋ฆฌยท์์) ์์ด ์ผ๋ฐ ์ ๋ชฉ ๋ฌธ๋จ
- ํ ๋จธ๋ฆฌ ์์ ์์
- ํ ์ ๋ชฉ ์๋ ๋ฒํธ:
ใํ 1ใ ์ ๋ชฉ ํ์ (caption์๋ ์ ๋ชฉ๋ง ์์ฑ)
- ํ ์
๋ณํฉ ๊ธ์ง: ๊ตฌ์กฐ์ ๋ณํฉ์ด ์์ผ๋ฉด ๊ฐ์ ๊ฐ์ด ํ๋ง๋ค ๋ฐ๋ณต๋๋๋ก ํ์ด ์
export_markdown=True: ๊ฐ์ ๊ตฌ์กฐ๋ก .md ํ์ผ ๋์ ์ ์ฅ (GFM ํ, #, ##, ### ์ ๋ชฉ ์๊ณ)
- ์ค ๊ฐ๊ฒฉ 150%, ๋ฌธ๋จ ์ 10pt(1์์ค)ยท5pt(๊ทธ ์ธ), ๋น ์ค ์์ด ๋ฌธ๋จ ๊ฐ๊ฒฉ์ผ๋ก ๊ตฌ๋ถ
- ๋ฒํธ๋ ๊ธ์๋ก ๋ฃ์. ํ๊ธ '๊ฐ์' ๋ฒํธ ์ฐ๋์ ๋ค์ ๋ฒ์ ์์
๋ด๋ถ ๊ฒฐ์ฌ ๋ณด๊ณ ์ (report_kind="internal")
์ ๋ณด๊ณต๊ฐํฌํธ ๋ด๋ถ ๊ฒฐ์ฌ ๋ณด๊ณ ์ ์ค๋ฌผ ํ๋ณธ ์ธก์ ๊ฐ ๋ฐ์: ๋ผ๋ฒจ ์นธ ์๋ ์ ๋ชฉ, ์์ฑ์ผยท๋ถ์ ์ค '26. 10. 9.(๊ธ) / ๊ณผยทํ๋ช
, ์ค ๊ฐ๊ฒฉ 150%, ๋ฌธ๋จ ์ 10pt(โก)ยท5pt(ใ
ยท-).
์์:
{
"title": "โโ ์ถ์ง๊ณํ(์)", "date": "2026. 10. 7.", "dept": "โโ๊ณผ",
"body": [
{"type": "h", "text": "์ถ์ง ๋ฐฐ๊ฒฝ"},
{"type": "l1", "text": "๋ฏผ์ ๋๊ธฐ ์๊ฐ ๊ฐ์๋ฅผ ์ํด AI ์๋ด ๋์
ํ์"},
{"type": "l2", "text": "ํ๋ฃจ ํ๊ท ์ฐฝ๊ตฌ ๋ฏผ์ ์ฝ 400๊ฑด"},
{"type": "caption", "text": "์์ ์์ฐ"},
{"type": "table", "rows": [["๊ตฌ๋ถ", "๊ธ์ก"], ["์์คํ
๊ตฌ์ถ", "2์ต"]]}
]
}
โ ๊ฐ์ํ ๋ชจ๋๋ก ์์ฑ ์: โ
. ์ถ์ง ๋ฐฐ๊ฒฝ, 1. ๋ฏผ์ ๋๊ธฐ ์๊ฐ ๊ฐ์๋ฅผ ์ํด AI ์๋ด ๋์
ํ์, ๊ฐ. ํ๋ฃจ ํ๊ท ์ฐฝ๊ตฌ ๋ฏผ์ ์ฝ 400๊ฑด, ใํ 1ใ ์์ ์์ฐ ํ์์ผ๋ก ํ์.
๊ตฌ์กฐ JSON ์ โ ๋ณด๊ณ ์ยท๋ณด๋์๋ฃยท๊ธฐ์๋ฌธ
๋ณด๊ณ ์ ๊ตฌ์กฐ JSON ์:
{
"title": "โโ ์๋น์ค ๋์
์ถ์ง๊ณํ(์)", "date": "2026. 10. 7.", "dept": "โโ๊ณผ",
"body": [{"type": "h", "text": "โ
. ์ถ์ง ๋ฐฐ๊ฒฝ"},
{"type": "l1", "text": "ํต์ฌ ๊ฒฐ๋ก ํ ๋ฌธ์ฅ์"}, {"type": "l2", "text": "๊ทผ๊ฑฐยท์ธ๋ถ"}, {"type": "l3", "text": "์ํญ๋ชฉ"},
{"type": "note", "text": "๊ฐ์ฃผ"}, {"type": "ref", "text": "์ฐธ๊ณ ์ฌํญ"},
{"type": "caption", "text": "์์ ์์ฐ"}, {"type": "table", "rows": [["๊ตฌ๋ถ", "๊ธ์ก"], ["๊ฐ", "100"]]}],
"appendix": [{"title": "๋ถ์ 1", "heading": "์ธ๋ถ ๋ด์ฉ", "body": [{"type": "l1", "text": "..."}]}]
}
๋ณด๋์๋ฃ ๊ตฌ์กฐ๋ {release, distribute, title, subtitles, body, appendix, contact}์
๋๋ค(๋ธ๋ก ์ข
๋ฅ๋ ๊ฐ๊ณ ๋ฌธ๋จ pยท๊ฐ์กฐ ์์ boxยท๊ทธ๋ฆผ image ์ถ๊ฐ). ์๊ณ ์ ๋ด๋น์๊ฐ ์์ผ๋ฉด ๋ด๋น ํ๋ฅผ โโ๊ณผ / ๊นโโ / 044-000-0000 ์๋ฆฌํ์๋ก ์ฑ์๋๋ค(placeholder_contact).
๊ธฐ์๋ฌธยท์ํ๋ฌธ(๋ณ์ง ์ 1ํธ์์) ๊ตฌ์กฐ๋ doc_type="official"๋ก ์์ฒญํฉ๋๋ค. ๊ตฌ์กฐ:
{
"org": "ํ์ ์์ ๋ถ",
"to": "์์ ์ ์ฐธ์กฐ",
"via": "",
"title": "2026๋
โโ ๊ณํ ์๋ฆผ",
"body": [
{"type": "l1", "text": "..."},
{"type": "l2", "text": "..."},
{"type": "l3", "text": "..."},
{"type": "table", "rows": [[...]]},
{"type": "lines", "lines": ["..."]}
],
"attachments": ["โโ ๊ณํ์ 1๋ถ.", "โโ ๋ช
๋จ 1๋ถ."],
"recipients": ["โโ๋ถ์ฅ๊ด", "โโ์ฒญ์ฅ"],
"sender": "ํ์ ์์ ๋ถ์ฅ๊ด",
"approval": {
"drafter": {"title": "์ฃผ๋ฌด๊ด", "name": "", "mark": "โ
"},
"reviewers": [{"title": "๊ณผ์ฅ", "name": "", "opinion": false}],
"approver": {"title": "๊ตญ์ฅ", "name": ""},
"coordinators": [{"title": "โโ๊ณผ์ฅ"}]
},
"doc_no": {"issue": "โโ๊ณผ-1234", "issue_date": "2026. 10. 14.", "receive": "", "receive_date": ""},
"contact": {"zip": "30112", "address": "์ธ์ข
ํน๋ณ์์น์ โโ๋ก 00", "homepage": "www.mois.go.kr",
"phone": "044-000-0000", "fax": "044-000-0001", "email": "โโโ@korea.kr", "disclosure": "๊ณต๊ฐ"}
}
๊ธฐ์๋ฌธ ํญ๋ชฉ ๋ฒํธ๋ l1โ1. / l2โ๊ฐ. / l3โ1) / l4โ๊ฐ) / l5โ(1) / l6โ(๊ฐ). ๊ฐ์ ๊ณ์ธต ์์์ ์์๋๋ก ์ฆ๊ฐํ๊ณ ์์ ๊ณ์ธต์ด ๋ฐ๋๋ฉด ํ์ ๋ฒํธ ์ด๊ธฐํ(์ 2์กฐโ ). ๋์งธ ๊ณ์ธต๋ถํฐ ์์ ๋ฒํธ ์์ ์์น์์ 2ํ(ํ ๊ธ์) ์ค๋ฅธ์ชฝ ๋ค์ฌ์ฐ๊ธฐ. ๊ธ์ก์ ๊ธ113,560์(๊ธ์ผ์ญ์ผ๋ง์ผ์ฒ์ค๋ฐฑ์ก์ญ์)์ฒ๋ผ ํ๊ธ ๋ณ๊ธฐ๋ฅผ ๋ถ์ฌ์ผ ํ๋ฉฐ, ์์ผ๋ฉด warnings์ "๊ธ์ก ํ๊ธ ๋ณ๊ธฐ ํ์(์ํ๊ท์น ์ 2์กฐโก)"๊ฐ ๋์ต๋๋ค(์ 2์กฐโก). ๋ ์ง๋ YYYY-MM-DDยทYYYY.MM.DD๋ฅผ YYYY. MM. DD.๋ก ์ ๊ทํํฉ๋๋ค(์ ์ 7์กฐโค). disclosure๋ "๊ณต๊ฐ"|"๋ถ๋ถ๊ณต๊ฐ"|"๋น๊ณต๊ฐ"๋ง ํ์ฉ๋ฉ๋๋ค.
์ง์ ๊ธฐ๊ด (52๊ณณ)
| ๊ธฐ๊ด | ๋ณด๊ณ ์ | ๋ณด๋์๋ฃ | ๊ธฐ๊ด | ๋ณด๊ณ ์ | ๋ณด๋์๋ฃ |
|---|
| ๊ฐ์ธ์ ๋ณด๋ณดํธ์์ํ | ๊ธฐ๊ด ๊ท์น | ๋ฌธ๋จ์ | ๋ฒ๋ฌด๋ถ | ๊ธฐ๊ด ๊ท์น | โก์ |
| ๊ฒฝ์ฐฐ์ฒญ | ๊ธฐ๊ด ๊ท์น | ๋ฌธ๋จ์ | ๋ฒ์ ์ฒ | ๊ธฐ๊ด ๊ท์น | ๋ฌธ๋จ์ |
| ๊ณ ์ฉ๋
ธ๋๋ถ | ๊ธฐ๊ด ๊ท์น | ๋ฌธ๋จ์ | ๋ณ๋ฌด์ฒญ | ๊ณตํต ๊ท์น | ๋ฌธ๋จ์ |
| ๊ณต์ ๊ฑฐ๋์์ํ | ๊ธฐ๊ด ๊ท์น | ๋ฌธ๋จ์ | ๋ณด๊ฑด๋ณต์ง๋ถ | ๊ธฐ๊ด ๊ท์น | ๋ฌธ๋จ์ |
| ๊ณผํ๊ธฐ์ ์ ๋ณดํต์ ๋ถ | ๊ธฐ๊ด ๊ท์น | ๋ฌธ๋จ์ | ์ฐ๋ฆผ์ฒญ | ๊ธฐ๊ด ๊ท์น | ๋ฌธ๋จ์ |
| ๊ด์ธ์ฒญ | ๊ธฐ๊ด ๊ท์น | ๋ฌธ๋จ์ | ์ฐ์
ํต์๋ถ | ๊ธฐ๊ด ๊ท์น | ๋ฌธ๋จ์ |
| ๊ต์ก๋ถ | ๊ธฐ๊ด ๊ท์น | ๋ฌธ๋จ์ | ์๋ง๊ธ๊ฐ๋ฐ์ฒญ | ๊ณตํต ๊ท์น | โก์ |
| ๊ตญ๊ฐ๊ต์ก์์ํ | ๊ธฐ๊ด ๊ท์น | ๋ฌธ๋จ์ | ์ฑํ๋ฑ๊ฐ์กฑ๋ถ | ๊ธฐ๊ด ๊ท์น | โก์ |
| ๊ตญ๊ฐ๋ฐ์ดํฐ์ฒ | ๊ธฐ๊ด ๊ท์น | โก์ | ์๋ฐฉ์ฒญ | ๊ณตํต ๊ท์น | โก์ |
| ๊ตญ๊ฐ๋ณดํ๋ถ | ๊ธฐ๊ด ๊ท์น | ๋ฌธ๋จ์ | ์ํ์์ฝํ์์ ์ฒ | ๊ธฐ๊ด ๊ท์น | ๋ฌธ๋จ์ |
| ๊ตญ๊ฐ์ ์ฐ์ฒญ | ๊ธฐ๊ด ๊ท์น | ๋ฌธ๋จ์ | ์ธ๊ต๋ถ | ๊ณตํต ๊ท์น | ๋ฌธ๋จ์ |
| ๊ตญ๋ฌด์กฐ์ ์ค | ๊ธฐ๊ด ๊ท์น | โก์ | ์ฐ์ฃผํญ๊ณต์ฒญ | ๊ธฐ๊ด ๊ท์น | ๋ฌธ๋จ์ |
| ๊ตญ๋ฏผ๊ถ์ต์์ํ | ๊ธฐ๊ด ๊ท์น | โก์ | ์์๋ ฅ์์ ์์ํ | ๊ณตํต ๊ท์น | โก์ |
| ๊ตญ๋ฐฉ๋ถ | ๊ธฐ๊ด ๊ท์น | โก์ | ์ธ๊ตฌ์ ๋ต์์ํ | ๊ณตํต ๊ท์น | ๋ฌธ๋จ์ |
| ๊ตญ์ธ์ฒญ | ๊ธฐ๊ด ๊ท์น | โก์ | ์ธ์ฌํ์ ์ฒ | ๊ธฐ๊ด ๊ท์น | ๋ฌธ๋จ์ |
| ๊ตญํ ๊ตํต๋ถ | ๊ธฐ๊ด ๊ท์น | โก์ | ์ฌ์ธ๋ํฌ์ฒญ | ๊ณตํต ๊ท์น | โก์ |
| ๊ธ์ต์์ํ | ๊ธฐ๊ด ๊ท์น | ๋ฌธ๋จ์ | ์ฌ์ ๊ฒฝ์ ๋ถ | ๊ธฐ๊ด ๊ท์น | ๋ฌธ๋จ์ |
| ๊ธฐ๋ณธ์ฌํ์์ํ | ๊ณตํต ๊ท์น | โก์ | ์กฐ๋ฌ์ฒญ | ๊ธฐ๊ด ๊ท์น | ๋ฌธ๋จ์ |
| ๊ธฐ์์ฒญ | ๊ธฐ๊ด ๊ท์น | ๋ฌธ๋จ์ | ์ค์๋ฒค์ฒ๊ธฐ์
๋ถ | ๊ธฐ๊ด ๊ท์น | ๋ฌธ๋จ์ |
| ๊ธฐํ์์ฐ์ฒ | ๊ธฐ๊ด ๊ท์น | ๋ฌธ๋จ์ | ์ง์์ฌ์ฐ์ฒ | ๊ธฐ๊ด ๊ท์น | ๋ฌธ๋จ์ |
| ๊ธฐํ์๋์งํ๊ฒฝ๋ถ | ๊ธฐ๊ด ๊ท์น | ๋ฌธ๋จ์ | ์ง๋ณ๊ด๋ฆฌ์ฒญ | ๊ธฐ๊ด ๊ท์น | ๋ฌธ๋จ์ |
| ๋๋ฆผ์ถ์ฐ์ํ๋ถ | ๊ธฐ๊ด ๊ท์น | ๋ฌธ๋จ์ | ํต์ผ๋ถ | ๊ณตํต ๊ท์น | โก์ |
| ๋์ด์งํฅ์ฒญ | ๊ธฐ๊ด ๊ท์น | ๋ฌธ๋จ์ | ํด์๊ฒฝ์ฐฐ์ฒญ | ๊ณตํต ๊ท์น | โก์ |
| ๋ฌธํ์ฒด์ก๊ด๊ด๋ถ | ๊ธฐ๊ด ๊ท์น | ๋ฌธ๋จ์ | ํด์์์ฐ๋ถ | ๊ธฐ๊ด ๊ท์น | ๋ฌธ๋จ์ |
| ๋ฐฉ์ก๋ฏธ๋์ดํต์ ์์ํ | ๊ธฐ๊ด ๊ท์น | ๋ฌธ๋จ์ | ํ์ ์์ ๋ถ | ๊ธฐ๊ด ๊ท์น | ๋ฌธ๋จ์ |
| ๋ฐฉ์์ฌ์
์ฒญ | ๊ธฐ๊ด ๊ท์น | ๋ฌธ๋จ์ | ํ์ ์ค์ฌ๋ณตํฉ๋์๊ฑด์ค์ฒญ | ๊ธฐ๊ด ๊ท์น | ๋ฌธ๋จ์ |
๋ณด๊ณ ์: ๊ธฐ๊ด ๊ท์น = ๊ทธ ๊ธฐ๊ด ๋ณด๋์๋ฃ ์ฐธ๊ณ ยท๋ถ์ ๊ตฌ๊ฐ ์ค์ธก๊ฐ(42๊ณณ), ๊ณตํต ๊ท์น = ๊ธฐ๊ด ๊ฐ ์ต๋น๊ฐ(๊ธฐ๊ด์ ์ง์ ํ์ง ์์ผ๋ฉด ๊ธฐ๊ด๋ช
์นธ์ ๋น์). ๋ณด๋์๋ฃ: ๋ฌธ๋จ์ = ๊ธฐํธ ์๋ ๊ธฐ์ฌ์ฒด ๋ฌธ๋จ ์์ฃผ, โก์ = โก โ ใ
โ - ๊ฐ์กฐ์.
๊ธฐ๊ด ๋ก๊ณ
์ ๋ถ์์งยท๊ธฐ๊ด ๋ก๊ณ ๋ ์ฌ์ฉ ๊ท์ ์ ์ด ํจํค์ง์ ํฌํจํ์ง ์์ต๋๋ค. ์์ ๊ธฐ๊ด ๋ด๋น์๊ฐ ์๊ธฐ ๊ธฐ๊ด ๋ก๊ณ ํ์ผ์ ์ง์ ํ์ธ์.
logo_path๋ก ๋ก๊ณ ๊ทธ๋ฆผ ํ์ผ์ ์ง์ ํ๋ฉด ๋ณด๋์๋ฃ๋ ํ์ง์ ๋ก๊ณ ์๋ฆฌ(๊ธฐ๊ด๋ณ ํฌ๊ธฐ)์, ๋ณด๊ณ ์๋ ์ ๋ชฉ ์์ ์์ ๋ค์ด๊ฐ๋๋ค. ๋ณด๋์๋ฃ ์ฌ๋ก๊ฑด ๊ทธ๋ฆผ์ slogan_path.
- ์ง์ ํ์ง ์์ผ๋ฉด ๋ณด๋์๋ฃ ํ์ง์ ๊ฐ์ ํฌ๊ธฐ์ ใ๊ธฐ๊ด ๋ก๊ณ ใ ์๋ฆฌํ์๊ฐ ๋ค์ด๊ฐ๋๋ค. ํ๊ธ์์ ๊ธ์ ์ง์ฐ๊ณ ๊ทธ๋ฆผ์ ๋ฃ์ผ๋ฉด ๋ฉ๋๋ค.
๊ทผ๊ฑฐ โ ์ ์ฑ
๋ธ๋ฆฌํ ๋ณด๋์๋ฃ 2,670๊ฑด ์กฐ์ฌ์ ๊ณต์ ๊ธฐ์ค
- ์ ์ฑ
๋ธ๋ฆฌํ(korea.kr) ๋ณด๋์๋ฃ HWPX 2,670๊ฑด(52๊ฐ ์ค์ํ์ ๊ธฐ๊ด) ์ ์ ํ์ฑ. ๋ณด๋์๋ฃ ๋ณธ๋ฌธ ์์์ 2,016๊ฑด์ ๋ฌธ๋จ 35,465๊ฐยท๋น ์ค 35,434๊ฐยทํ ์นธ 32,392๊ฐ ์ค์ธก.
- ๋ณด๊ณ ์ ์์์ ๊ฐ์ ์๋ฃ ์ค ใ์ฐธ๊ณ ยท๋ถ์ใ ๋ณด๊ณ ์ํ ๊ตฌ๊ฐ์ด ์๋ 1,326๊ฑด(๋ฌธ๋จ 13,757๊ฐ)์์ ๊ธฐ๊ด๋ณ๋ก ์ฐ์ถ(42๊ฐ ๊ธฐ๊ด, 3๊ฑด ์ด์). ๊ณตํต ๊ณจ๊ฒฉ(โกยท-ยท*ยทโป ๊ธฐํธ, ๊ธฐํธ ๋ค 1ํ, 1ํ ์ ๋ชฉ ์์, ํ ๋จธ๋ฆฌ ๋ง์ ๊ณ ๋ยท๊ฐ์ด๋ฐยท๊ตต๊ฒ)์ ๊ธฐ๊ด ๊ฐ 90% ์ด์ ์ผ์น.
- ๊ณต์ ๊ธฐ์ค: ใํ์ ์
๋ฌด์ ์ด์ ๋ฐ ํ์ ์ ๊ดํ ๊ท์ ์ํ๊ท์นใ์ ํญ๋ชฉ ๊ตฌ๋ถ(1. โ ๊ฐ. โ 1) โ ๊ฐ) โฆ), ๊ฒฝ๊ธฐ๋๊ต์ก์ฒญ ใํ ๊ณณ์ ์ ๋ฆฌํ ๊ณต๋ฌธ์ ์์ฑ๋ฒใ(๋์งธ ์ค์ ํญ๋ชฉ ์ฒซ ๊ธ์์ ๋ง์ถค, ๊ธฐํธ ๋ค 1ํ, ํ์ ํญ๋ชฉ 2ํ ๋ค์ฌ์ฐ๊ธฐ ๋ฑ).
- ์ค์ธก: ์ ์ฑ
๋ธ๋ฆฌํ ๋ณด๋์๋ฃ 2,670๊ฑดยท52๊ฐ ๊ธฐ๊ด(๋ณด๊ณ ์ ๊ตฌ๊ฐ 1,326๊ฑด)์์ ๊ธฐ๊ด๋ณ ๊ธฐํธยท๊ธ๊ผดยท๋น ์คยทํ์ง ํ ์์น๋ฅผ ์ฐ์ถ.
- ๊ท์น ๋ฌธ์: ๋ณด๋์๋ฃ ์์ ๊ท์น, ๋ณด๊ณ ์ ์์ ๊ท์น. ๊ท์น๊ฐ:
rules/, rules_report/, ๋ณด๋์๋ฃ ํ์งยท๋ด๋น ํ ์์น: templates/.
- ์์๋ฃ๋ ์ ์ฑ
๋ธ๋ฆฌํ์ ๊ณต๊ณต๋๋ฆฌ๋ก ๊ณต๊ฐ๋ ๋ณด๋์๋ฃ์ด๋ฉฐ, ์ด ์ ์ฅ์์๋ ์๋ณธ ํ์ผยท๋ณธ๋ฌธยท๊ทธ๋ฆผ์ ํฌํจํ์ง ์๊ณ ์์ ์์น๋ง ๋ด์์ต๋๋ค.
- ๊ฑด์: ์์ ๊ท์น(๊ธฐํธยท๊ธ๊ผดยท๋น ์คยท๋ณด๊ณ ์ ๊ตฌ๊ฐ)์ ์์งํ 2,670๊ฑด ์ ์ ํ์ฑ, ๋ณด๋์๋ฃ ๋ณธ๋ฌธ ๋ฌธ์ฅ ์ค์ธก๊ณผ ์ชฝ ์ค์ ์ ๊ฐ์ ์๋ฃ ์ค 2,667๊ฑด ๊ธฐ์ค์
๋๋ค.
์์ ๊ทผ๊ฑฐ (์ชฝ ์ค์ )
๋ชจ๋ ๋ฌธ์ ์ข
๋ฅ(๋ณด๊ณ ์ยท๋ณด๋์๋ฃยท๊ธฐ์๋ฌธ)์ ํธ์ง ์ฉ์ง๋ A4(210ร297mm, HWPUNIT 59528ร84188), ์ข์ฐ ์ฌ๋ฐฑ 20mm(HWPUNIT 5669), ์ยท์๋ ์ฌ๋ฐฑ 15mm(HWPUNIT 4252), ๋จธ๋ฆฌ๋งยท๊ผฌ๋ฆฌ๋ง 10mm(HWPUNIT 2835), gutter 0์ ๊ธฐ๋ณธ๊ฐ์ผ๋ก ์ด๋ค. ๋ณธ๋ฌธํญ(text width)์ width โ left โ right = 48190(HWPUNIT, 170mm)์ด๋ฉฐ, ํ(<hp:tbl>)์ ํญ์ ๋ณธ๋ฌธํญ์ ๋์ง ์๋๋ค.
- ๊ทผ๊ฑฐ: ์ ์ฑ
๋ธ๋ฆฌํ(korea.kr) ๋ณด๋์๋ฃ ์๋ณธ 2,667๊ฑด(52๊ฐ ์ค์ํ์ ๊ธฐ๊ด) ์ค A4ยท์ข์ฐ 20mm 2,640๊ฑด, ์15ยท์๋15ยท๋จธ๋ฆฌ๋ง10ยท๊ผฌ๋ฆฌ๋ง10 1,817๊ฑด(์ต๋น๊ฐ). ๊ณผํ๊ธฐ์ ์ ๋ณดํต์ ๋ถ 118๊ฑด ์ค 100๊ฑด, ํ์ ์์ ๋ถ 135๊ฑด ์ค 120๊ฑด์ด ์ด ์ค์ ๊ณผ ์ผ์น.
- ๊ธฐ๊ด ํ
ํ๋ฆฟ(
templates/<๊ธฐ๊ด>.json์ page)์ด ์์ผ๋ฉด ๊ทธ ๊ธฐ๊ด์ ์ต๋น๊ฐ(๊ธฐ๊ด๊ฐ)์ ์ฐ๊ณ , ํ๋ณธ์ด 10๊ฑด ๋ฏธ๋ง์ด๋ฉด ๊ณตํต๊ฐ(default)์ ์ด๋ค. ๊ธฐ๊ด๊ฐ์ korean_report_hwpx/rules/_์ชฝ์ค์ .json์ ๊ธฐ๊ด๊ฐ์ ๊ทผ๊ฑฐ์ ํจ๊ป ๊ธฐ๋ก๋ผ ์๋ค.
- ๊ธฐ์๋ฌธ ์ชฝ ์ค์ ์ ใํ์ ์
๋ฌด์ ์ด์ ๋ฐ ํ์ ์ ๊ดํ ๊ท์ ใ ์ 7์กฐโฅ(์ฉ์ง A4)์ ๋ฐ๋ผ ์ ๊ณตํต๊ฐ์ ์ด๋ค.
- ๊ท์น๊ฐ ํ์ผ:
korean_report_hwpx/rules/_์ชฝ์ค์ .json.
์์ฑ ์ฃผ์ฒด (Solar Pro 4ยทClaude)
- 0.2.0๋ถํฐ 0.3.x๊น์ง: Solar Pro 4 ์์ฑ, CodeSolarยทClaude ๊ฒ์.
- 0.4.0๋ถํฐ: ๋ผ๋๋ Solar Pro 4, ๋ณด์ยท๋ช
์ธยท์ ๋ต ํ
์คํธ(ํ๊ธ ์ค์ธก ์๋ฃ ํฌํจ)๋ Claude. 0.5.2ยท0.5.6์ Claude ์์ฑ.
- ๋ฒ์ ๋ณ ์์ฑ ์ฃผ์ฒด๋ CHANGELOG ๊ฐ ์ ๋จธ๋ฆฌ์ ์ ํ ์์ต๋๋ค.
์ ์์ ๋ฐ์ดํฐ ์ ์ก
- ๊ฒฐ๊ณผ๋ฌผ์ ์ด์์
๋๋ค. ๋ณด๊ณ ยท๋ฐฐํฌ ์ ํ๊ธ์์ ํ์ธํ์ธ์.
- ์ค ๋(๋ง์ง๋ง ์ค ํ๋ ๊ธ์ ๋ฑ)์ ๊ธ์ ํญ ์ถ์ ์ผ๋ก ๋ง์ถ๋ฏ๋ก ์ผ๋ถ ๋จ์ ์ ์์ต๋๋ค. macOS + ํ์ปด์คํผ์ค ํ๊ธ์ด ์์ผ๋ฉด
polish=True๋ก ์ค์ ์ค ๋ฐฐ์น๋ฅผ ๋ฐ์ ๋ฌธ๋จ๋ณ ์๊ฐ์ ๋ค์ ๊ณ ๋ฆ
๋๋ค(ํ๊ธ ์ฐฝ์ด ์ฌ๋ฌ ๋ฒ ์ด๋ฆฌ๊ณ ์ ๋ถ ๊ฑธ๋ฆผ).
- ๊ธ๊ผด์ ์ฌ์ฉํ๋ ์ปดํจํฐ์ ์ค์น๋ ๊ธ๊ผด๋ก ํ์๋ฉ๋๋ค(ํด๋จผ๋ช
์กฐยทHYํค๋๋ผ์ธM ๋ฑ ๋ฏธ์ค์น ์ ๋์ฒด ๊ธ๊ผด).
- ๊ธฐ์๋ฌธยท์ํ๋ฌธ์
doc_type="official"๋ก ์ง์ํฉ๋๋ค(๋ณ์ง ์ 1ํธ์์, rules_official/_๊ณตํต.json). ํญ๋ชฉ ๋ฒํธ(1.โ๊ฐ.โ1)โ๊ฐ)โ(1)โ(๊ฐ))๋ ์๋ฒ๊ฐ ๋ถ์ฌ, ์ฌ์ฉ์๋ ๋ฒํธ๋ฅผ ์ฐ์ง ์์ต๋๋ค. ๋ ์ง๋ YYYY-MM-DDยทYYYY.MM.DD๋ฅผ YYYY. MM. DD.๋ก ์ ๊ทํํฉ๋๋ค.
- ๋ชจ๋ ์ฒ๋ฆฌ๋ ๋ก์ปฌ์
๋๋ค. ์ด ์๋ฒ๋ ์ธ๋ถ API๋ฅผ ๋ถ๋ฅด์ง ์๊ณ , ์๊ณ ยท๊ฒฐ๊ณผ ํ์ผ์ ์ด๋๋ก๋ ๋ณด๋ด์ง ์์ต๋๋ค.
- ์๊ณ ๋ฅผ ๊ตฌ์กฐ๋ก ์ ๋ฆฌํ๋ ์ผ์ ์ฌ์ฉ์๊ฐ ์ฐ๋ AI๊ฐ ํฉ๋๋ค. ๊ทธ AI ์๋น์ค์ ๋ฐ์ดํฐ ์ ์ฑ
์ ๋ณ๋๋ก ํ์ธํ์ธ์.
MIT ยฉ 2026 Upstage ยท Created by Mia(์ค์น๋ฏธ)