把 Word 或 Markdown 文档一键排版为符合党政机关公文国标的 docx:字体字号行距标题合规、表格美化、图片防裁剪、大纲级别导航层级、Markdown H2/H3/H4 自动映射公文 4 级并挂 Word 自动编号。
文档格式化排版(gongwen-format v2.1)
作者:胡立敏 | 依据:GB/T 9704-2012《党政机关公文格式》、GB/T 33476.2-2016《党政机关电子公文格式规范 第 2 部分》 v2.1 新增:Markdown H2/H3/H4 自动映射公文 4 级(一/(一)/1.)并挂 Word 自动编号(numPr);手册、技术文档的章节层级不再坍塌。
何时使用
用户给出 Word(.docx)或 Markdown(.md)文件,要求"排版 / 格式化 / 按公文国标刷新格式"时使用。 核心承诺:只刷格式,不改文字——不删字、不改字、不合并段落。
快速开始
路径一:Word 排版
python <skill>/scripts/format.py <输入.docx> -o <输出-formatted.docx> --report <变更报告.md>
- 自动识别 13 种段落角色(标题/发文字号/主送/正文/层次序数/图片段/图题表题/落款/抄送/印发等)
- 输出:排版后 docx + Markdown 变更清单;退出码 0=ERROR 清零,1=仍有 ERROR
- 不动原 docx 的纯文本序号("一、"仍为纯文本,不删除)——保"只改格式不改字"承诺
- 若需要把纯文本"一、"段升级为 Word 自动编号,加
--auto-number(动字,需用户显式确认)
路径二:Markdown 排版
python <skill>/scripts/md_parser.py <输入.md> -o <输出-formatted.docx> --report <变更报告.md>
- 段前用
<!--role: TITLE-->等注释标注角色(不标默认 BODY);支持|表格|语法和插图 - 相对图片路径以 .md 所在目录为基准解析;alt 文字非空时自动生成图题段
- v2.1 新增:Markdown 标题层级自动映射公文 4 级并挂 Word 自动编号:
# xxx→ TITLE(22pt 方正小标宋,居中)## xxx→ LAYER_NUM 第 1 级(黑体,"一、")### xxx→ LAYER_NUM 第 2 级(楷体,"(一)")#### xxx→ LAYER_NUM 第 3 级(仿宋,"1.")##### xxx→ LAYER_NUM 第 4 级(仿宋,"(1)")- 文本前缀("一、""(一)""1.""(1)")由脚本自动剥除,Word 自动填入;H2/H3/H4/H5 之间编号自动重新计数
路径三:只体检不改
python <skill>/scripts/check.py <输入.docx> --out <报告.md>
排版规则速览
| 要素 | 规则 | 依据 |
|---|---|---|
| 大标题 | 二号 22pt 方正小标宋,居中,大纲 1 级 | §7.3.1 |
| 一级"一、" | 三号 16pt 黑体,大纲 2 级,Word 自动编号 chineseCounting + %1、 | §7.3.3.2 |
| 二级"(一)" | 三号 16pt 楷体,大纲 3 级,Word 自动编号 chineseCounting + (%2) | §7.3.3.2 |
| 三四级"1./(1)" | 三号仿宋,大纲 4/5 级,Word 自动编号 decimal + %3.(第 3 级)/ (%4)(第 4 级) | §7.3.3.2 |
| 正文 | 三号仿宋,28 磅固定行距,首行缩进 2 字 | §7.3.3 |
| 图片段 | 居中、单倍行距(防裁剪)、段前后 6 磅 | 排版惯例 |
| 图题/表题 | "图1 xxx"→四号仿宋居中、单倍行距 | 排版惯例 |
| 表格 | 表头黑体、数据仿宋(四号)、整体居中、单元格居中、单倍行距 | 排版惯例 |
| 落款/日期 | 右对齐、右空 2 字、月日不补零 | §8.3 |
| 页面 | A4,版心 156×225mm(默认 33476.2 软件坐标;--strict 走 9704 严格坐标) | §6.1 |
大纲级别 1-4 级 = Word「视图 → 导航窗格」层级树,可折叠/跳转,引用→目录也可一键生成。
自动编号规则(v2.1 新增)
| 输入 | 输出 | ilvl | numFmt | lvlText | 字体 |
|---|---|---|---|---|---|
## xxx 或 <!--role: LAYER_NUM-->一、xxx | 一级章节 | 0 | chineseCounting | %1、 | 黑体 |
### xxx 或 <!--role: LAYER_NUM-->(一)xxx | 二级章节 | 1 | chineseCounting | (%2) | 楷体 |
#### xxx 或 <!--role: LAYER_NUM-->1.xxx | 三级章节 | 2 | decimal | %3. | 仿宋 |
<!--role: LAYER_NUM-->①xxx | 四级章节 | 3 | decimalEnclosedCircle | %4 | 仿宋 |
- md 路径默认挂 numPr(不动字:剥前缀由脚本在渲染时完成)
- Word 路径默认不挂 numPr(保"只改格式不改字");加
--auto-number后将纯文本"一、""(一)"等删掉并挂 numPr - 所有 numId 都用默认 100,避开 Word 内置 1-9 常用 id
使用约定(Agent 执行时遵守——效率优先,硬性要求)
标准流程只有一条命令。format.py 已内置「排版前校验 → 角色识别 → 排版 → 排版后校验 → 变更报告」全流程,一条命令跑完:
python <skill>/scripts/format.py <输入.docx> -o <输出-formatted.docx> --report <变更报告.md>
硬性禁令(违反即严重拖慢交付,每多一轮命令就是一次 Agent 往返):
- 禁止先跑 check.py 预检——format.py 自带 before/after ERROR 对比。仅当用户明确说"只体检不要改"时才单独跑 check.py。
- 禁止写临时检查脚本(inspect_*.py 之类)——变更报告已含逐段角色/置信度/变更明细,直接读报告回答用户。
- 禁止额外备份步骤——输出永远是新文件(-formatted.docx),源文件天然不被覆盖,不要复制 .bak。
- Python 探测最多一次——先直接用
python;报 ModuleNotFoundError 才提示先执行pip install python-docx(或使用任一已装 python-docx 的解释器);同一会话记住可用解释器,不重复探测。 - 不主动逐段复核——仅当变更报告中低置信段落涉及标题/主送等关键角色时,一句话提醒用户即可,不阻塞交付。
例外流程(仅三种):
- Markdown 输入 →
python <skill>/scripts/md_parser.py <输入.md> -o <输出.docx>(同样一条命令) - 只体检不改 →
python <skill>/scripts/check.py <输入.docx> --out <报告.md> - 专用模板豁免:等保定级报告、红头模板等,用户要求保留原版式时只跑 check 不跑 format。
已知边界(如实告知用户)
- 不改正文页脚页码(避免破坏原页脚域,需手工核对:四号宋体、单页右/双页左)
- 不探测印章是否加盖;只调整落款日期右空字数
- 特定格式公文(信函/命令/纪要)专属版式暂不支持
- 22 行/页 与 28 字/行的实际行数需在 Word 中目测核对(不渲染字体)
- markdown 图片需本地文件路径(网络 URL 不下载)
- md 路径下若用户在 H1/H2/H3 文本里写了"一、""(一)""1.",脚本会自动剥掉(因为 Word 自动生成);若不希望剥,在标题前加
<!--role: BODY-->显式标注
目录结构
gongwen-format/
├── SKILL.md 本说明
├── references/ 国标参数速查表
├── scripts/ 排版引擎
│ ├── format.py Word → 国标排版(主入口)
│ ├── md_parser.py Markdown → 国标 docx(含 H2/H3/H4 自动映射)
│ ├── check.py 合规体检(9 项检查器,只读)
│ ├── classify.py 段落角色识别(13 种)
│ ├── lib_docx.py python-docx 封装层
│ ├── report.py 报告生成
│ ├── rewrites/styles.py 国标样式套用(含 numPr 自动编号)
│ └── checks/ 10 项检查器实现
└── fixtures/ 测试样本(good/bad.docx、sample-media.md、sample-h2h3.md)
- Downloads
- 124All time
- Security audit
- Review
- Last updated
- 1w ago
- Current version
- v1.0.0
- License
- MIT-0
