Skip to content

duyunzhoudyz/dyz-gongwen-skills / skills/gongwen-format

gongwen-format

Verified

按 GB/T 9704-2012 把公文正文排成 Word,有红头、信函、纪要、命令(令)、白头、材料、简报七种版式,支持联合行文版头、附件另面、预印红头纸套打;检查、修复 docx 的页边距、字体、行距、页码;把核稿意见写成 Word 批注;无 Python 时给手动设置清单。用户说“排版”“套红头”“转成 Word”“按国标调格式”“格式乱了帮我改”“页码怎么设”时使用。只管格式不改内容:起草转对应起草 skill,压缩改写转 gongwen-polish,去 AI 味转 gongwen-humanize,去免责对冲转 gongwen-direct,核稿转 gongwen-review。

FileKindSize
README.mdmarkdown10.0 KB
SKILL.mdskill md21.1 KB
assets/gbt9704_params.jsonconfig20.0 KB
evals/evals.jsonconfig18.7 KB
evals/files/交接卡-平安建设总结-正文.txtmarkdown965 B
evals/files/信函-正文.txtmarkdown611 B
evals/files/信函-版式信息.jsonconfig166 B
evals/files/医院-单位画像.mdmarkdown805 B
evals/files/医院-院内通知-正文.txtmarkdown700 B
evals/files/卫健简报-两篇稿件.txtmarkdown1016 B
evals/files/国企-单位画像.mdmarkdown624 B
evals/files/国企-通知-正文.txtmarkdown646 B
evals/files/学校-监考安排-正文.txtmarkdown688 B
evals/files/学校-通知-正文.txtmarkdown585 B
evals/files/年终总结-正文.txtmarkdown1.2 KB
evals/files/核稿意见.jsonconfig1.4 KB
evals/files/格式混乱的情况报告.docxbinary36.3 KB
evals/files/涉密材料-正文.txtmarkdown221 B
evals/files/白头请示-正文.txtmarkdown701 B
evals/files/社区-情况报告-正文.txtmarkdown577 B
evals/files/简报-正文.txtmarkdown1.0 KB
evals/files/简报-版式信息.jsonconfig364 B
evals/files/红头通知-正文.txtmarkdown1.5 KB
evals/files/红头通知-版式信息.jsonconfig284 B
evals/files/纪要-正文.txtmarkdown910 B
evals/files/纪要-版式信息.jsonconfig119 B
evals/files/请示-缺落款-正文.txtmarkdown339 B
evals/files/高校-单位画像.mdmarkdown509 B
evals/files/高校-请示-正文.txtmarkdown603 B
evals/trigger.jsonconfig1.9 KB
manifest.jsonconfig976 B
references/_shared/README.mdmarkdown110 B
references/_shared/guardrails.mdmarkdown12.6 KB
references/_shared/profiles/roles.mdmarkdown16.1 KB
references/_shared/profiles/units/dangzheng.mdmarkdown7.9 KB
references/_shared/profiles/units/gaoxiao.mdmarkdown11.2 KB
references/_shared/profiles/units/guoqi.mdmarkdown12.7 KB
references/_shared/profiles/units/jiceng.mdmarkdown9.3 KB
references/_shared/profiles/units/shequ.mdmarkdown8.8 KB
references/_shared/profiles/units/yiyuan.mdmarkdown13.2 KB
references/_shared/profiles/units/zhongxiaoxue.mdmarkdown10.6 KB
references/_shared/rules/doc-types.mdmarkdown28.1 KB
references/_shared/rules/gbt15834.mdmarkdown13.3 KB
references/_shared/rules/gbt15835.mdmarkdown10.6 KB
references/_shared/rules/gbt9704.mdmarkdown17.2 KB
references/_shared/rules/jianfu.mdmarkdown12.5 KB
references/_shared/rules/tiaoli.mdmarkdown15.3 KB
references/_shared/style/ai-tone.mdmarkdown10.2 KB
references/_shared/style/defensive.mdmarkdown8.1 KB
references/_shared/style/output-format.mdmarkdown9.0 KB
references/check-items.mdmarkdown16.1 KB
references/layouts.mdmarkdown20.8 KB
references/manual-setup.mdmarkdown13.9 KB
references/meta-fields.mdmarkdown11.6 KB
scripts/annotate_docx.pyscript9.7 KB
scripts/build_docx.pyscript76.1 KB
scripts/check_docx.pyscript74.7 KB
scripts/extract_docx.pyscript16.2 KB
scripts/fix_docx.pyscript28.3 KB
scripts/gw_docx.pyscript50.0 KB
scripts/gw_fonts.pyscript24.2 KB
scripts/gw_format.pyscript15.9 KB
scripts/gw_layout.pyscript56.6 KB
scripts/gw_verify.pyscript6.1 KB
scripts/preview_docx.pyscript11.1 KB
scripts/secret_check.pyscript8.9 KB

references/check-items.md

View on GitHub
# 检查项、识别规则与脚本输出

## 目录

一、check_docx.py 检查项
二、段落角色识别规则(build、check、fix 共用)
三、fix_docx.py 修改范围
四、annotate_docx.py 批注写法
五、退出码与输出文件

## 一、check_docx.py 检查项

级别含义同开发规范第 8 节:P0 必须改;P1 建议改;P2 提示。同类问题按段合并,消息中写“共 N 段”。“第 N 段”按文档中的段落序号计,空段也计数。

`--allow` 列出的检查项(逗号分隔,如 `--allow DOCX-050`)用于本单位制度明文规定、与国标不同的写法:命中时降为 P2,消息前加“按本单位制度保留:”,不计入 `--strict`;JSON 的 `notes` 中写明降级处数。不存在的检查项忽略并提示。build_docx.py、fix_docx.py 的 `--allow` 原样传给回读检查。

`--unit-fonts "仿宋=方正仿宋_GBK,小标宋=方正小标宋_GBK"` 用于本单位制度明文规定了字体的情形(角色限 gbt9704_params.json 中 `fonts.standard` 的键:仿宋、楷体、黑体、小标宋、宋体;未知角色或空字体名退出码 2):该角色使用单位字体视为合规,使用国标字体按 DOCX-016 报;JSON 的 `unit_fonts` 为 `{角色: {unit_font, standard_font}}`,`notes` 写明“按单位规定使用字体”。build_docx.py、fix_docx.py 的 `--unit-fonts` 原样传给回读检查。

| ID | 检查内容 | 级别 | 依据 |
|---|---|---|---|
| DOCX-001 | 纸张不是 A4 | P0 | 5.1 |
| DOCX-002 | 上边距(天头)、左边距(订口)超出 ±1 mm | P0 | 5.2.1 |
| DOCX-003 | 下边距、右边距与推算值相差超过 1 mm | P1 | 5.2.1 推算 |
| DOCX-004 | 未设字符网格或每行不是 28 字 | P2 | 5.2.3 |
| DOCX-010 | 正文字体不是仿宋体;正文中夹有其他字体(P2) | P0 | 7.3.3 |
| DOCX-011 | 正文字号不是三号(层次标题字号不对为 P1) | P0 | 7.3.3 |
| DOCX-012 | 行距使每页不是 22 行 | P1 | 5.2.3 |
| DOCX-013 | 首行缩进不是 2 字 | P1 | 7.3.3 |
| DOCX-014 | 段首用空格缩进 | P1 | 7.3.3 |
| DOCX-015 | 正文文字不是黑色 | P1 | 5.2.4 |
| DOCX-016 | 使用非标准字体(如仿宋、楷体、方正小标宋_GBK、华文中宋、宋体加粗代替小标宋等):字体类别对,但不是标准字体本身;只认标准字体名和同款英文名(FangSong_GB2312、KaiTi_GB2312、SimHei、SimSun、FZXiaoBiaoSong-B05S);消息写明应为哪款标准字体 | P1 | gbt9704.md 第九部分(字体名称,实践) |
| DOCX-020~022 | 标题字体不是小标宋、字号不是二号、未居中 | P1 | 7.3.1 |
| DOCX-023 | 未识别到标题 | P2 | 7.3.1 |
| DOCX-024 | 标题回行后有一行少于 3 字 | P2 | 7.3.1 |
| DOCX-030~032 | 一级标题不是黑体、二级不是楷体、三四级不是仿宋 | P1 | 7.3.3 |
| DOCX-033 | 层次序数写法不规范(1、,(一)、,(1)) | P1 | 7.3.3;GB/T 15834 附录 B.3 |
| DOCX-040、041 | 主送机关未顶格;后面用了半角冒号 | P1 | 7.3.2 |
| DOCX-042 | 附件说明用半角冒号、名称后有标点 | P1 | 7.3.4 |
| DOCX-043 | 成文日期编虚位(01月05日) | P0 | 7.3.5.4 |
| DOCX-044 | 成文日期用汉字数字 | P1 | 7.3.5.4 |
| DOCX-045 | 附注未加圆括号 | P2 | 7.3.6 |
| DOCX-046 | 成文日期没有排在右侧 | P2 | 7.3.5 |
| DOCX-047 | 纪要第一个出席(请假、列席)段前没有空一行(前一段是空段且不足半行高,或段前距不足大半行) | P1 | 10.3 |
| DOCX-050~053 | 发文字号:括号不是〔〕、年份不全、加“第”、编虚位 | P0 | 7.2.5 |
| DOCX-054 | 签发人后用半角冒号 | P1 | 7.2.6 |
| DOCX-055 | 发文机关标志不是红色 | P1 | 7.2.4 |
| DOCX-056 | 上行文(请示、报告、议案)红头的发文字号不是居左空一字(顶格、空多了,或居中、居右) | P1 | 7.2.5、7.2.6 |
| DOCX-060 | 抄送用半角冒号、末尾缺句号 | P1 | 7.4.2 |
| DOCX-061 | 印发日期写法不对 | P1 | 7.4.3 |
| DOCX-070 | 没有页码 | P1 | 7.5 |
| DOCX-071 | 页码不是“— 1 —”格式 | P1 | 7.5 |
| DOCX-072 | 页码不是四号宋体 | P2 | 7.5 |
| DOCX-073 | 未设奇偶页不同,或单双页位置不对 | P2 | 7.5 |
| DOCX-074 | 信函格式首页显示页码 | P1 | 10.1 |
| DOCX-075 | 页眉中有页码或杂项(信函首页页眉的发文机关标志除外);公文不用页眉,页码放页脚 | P1 | 7.5 |
| DOCX-080 | 残留【待补】【待核实】标记(每处一条,单独计数,提醒补齐后再定稿) | P2 | guardrails 第二条;开发规范第 8 节 |
| DOCX-081 | 含密级、“内部资料”等标识 | P2 | guardrails 第一条 |
| DOCX-082 | 文档中有【起草说明】:其后内容不是正文,不参与识别和检查;成稿中应删除【起草说明】及其后的全部内容 | P1 | output-format.md 第二部分 |
| DOCX-090 | 正文中的日期编虚位 | P1 | 7.3.5.4;GB/T 15835 |
| DOCX-092 | 同一行日期(落款)在正文中重复排了两次 | P1 | 排版不改内容 |
| DOCX-100 | 正文中有未转换的 Markdown 表格行(竖线和短横线组成的分隔行,或首尾都是竖线的行,原样成段) | P1 | output-format.md 第一部分 |
| DOCX-101 | 正文表格宽度超出版心 | P1 | 5.2.1 |
| DOCX-102 | 正文表格文字不是仿宋或宋体,或不在小四至四号之间 | P2 | 实践(国标未规定) |
| DOCX-110 | 简报报头缺简报名称、期号行、编印单位和日期行(写【待补】的不算缺) | P1 | 实践(简报无国标格式) |
| DOCX-111~113 | 简报名称不是红色居中;报头下没有红色分隔线;报尾(有的话)上方没有分隔线 | P1 | 同上 |
| DOCX-114 | 期号行、编印行不是三号仿宋 | P2 | 同上 |
| DOCX-120~122 | 命令(令):标志缺失或不是“令”结尾;标志不居中;缺令号或令号不居中 | P1 | 10.2 |
| DOCX-123、124 | 命令(令):标志与令号之间、令号与正文之间不是空二行 | P1 | 10.2 |
| DOCX-125、126 | 命令(令):成文日期不是右空四字或缺成文日期(P1);职务(签名章)与日期之间不是空一行(P2) | P1、P2 | 7.3.5.3 |
| DOCX-130~132 | 附件页:标识不是三号黑体或未顶格;附件前没有分页;标题缺失、未居中或不在第三行 | P1 | 7.3.7 |
| DOCX-133 | 正文缺附件说明,或附件说明与附件页的顺序号、名称、个数不一致 | P1 | 7.3.4、7.3.7 |
| DOCX-134 | 附件所在节重新起页码(应与正文连续) | P1 | 7.5 |
| DOCX-140、141 | 联合行文版头:少于两个机关名称或文字不是红色;“文件”不在名称右侧或未上下居中 | P1 | 7.2.4 |
| DOCX-143、144 | 联署署名表格:格宽小于印章直径(42 mm,实践值);超出版心 | P1 | 7.3.5.1 |
| DOCX-150、151 | 预印红头纸套打(check_docx.py --overprint):稿中有红色文字、红线或联合行文版头;发文字号上沿距版心上边缘小于 44 mm(推算值) | P1 | 实践(套打);7.2.4、7.2.5 |
| DOCX-160 | 红头、纪要版头缺红色分隔线(发文字号下 4 mm 处) | P1 | 7.2.7 |
| DOCX-161 | 发文机关标志未居中 | P1 | 7.2.4 |
| DOCX-162 | 签发人另起一行,没有与发文字号同一行 | P1 | 7.2.5、7.2.6 |
| DOCX-163 | 版记是普通段落,或版记表格缺首末分隔线、没有固定在最后一页版心底部 | P1 | 7.4.1 |

DOCX-120~163 的参数、用法和依据见 `references/layouts.md`。

检查不了的项目,交付前人工核对(有 LibreOffice 时可用 preview_docx.py 转成图片看):标志和红线的实际位置、首页是否显示正文(7.3.3)、标题回行是否词意完整、层次标题是否落在页末、落款是否单独成页、版记是否落在最后一页且在偶数页、印章位置。

## 二、段落角色识别规则(build、check、fix 共用)

1. 版头:开头的 6 位以内纯数字行为份号;“绝密、机密、秘密”开头为密级;“特急、加急”为紧急程度;以“文件”结尾的短行为发文机关标志;“某发〔2026〕5号”这类行(可带“签发人:”)为发文字号,序号还没编、写成“某发〔2026〕【待补:序号】号”的同样识别。
2. 标题:首个非空行以“关于”开头或以文种结尾。首行没有以文种结尾、下一行是以文种结尾的短行时,两行合并为标题。都不符合时,首行较短且没有句末标点的,推断为标题并提示核对。
3. 副标题、题注:标题后以“——”开头的行为副标题;“(2026年1月5日)”这类行和讲话人行为题注。
4. 主送机关:标题后第一个以冒号结尾、不超过 80 字的行。讲话稿的“同志们:”按同样方式顶格排;称呼不紧跟标题(隔着几行题注,或在正文中间)时识别为“称呼”,同样顶格。讲话人行可含顿号、不超过 40 字,后面三行内有称呼的按题注识别。
5. 层次标题:行首“一、”(整行不含句号、不超过 50 字)为一级;“(一)”为二级;“1.”为三级;“(1)”为四级。文档含“1.1”“1.1.1”这类多级阿拉伯数字序号时,改按首次出现时的嵌套深度定层级(第一种序号为一级,其下新出现的写法依次为二、三、四级),序号文字不改,DOCX-033 提示改为标准序号。一级标题必须独占一行(同段时无法与以“一、”开头的正文长句区分,按正文排);二至四级与正文同段时,第一个句号及以前的部分是标题。
6. 出席、请假、列席:以“出席:”“请假:”“列席:”开头的行。
7. 附件说明:主体末尾以“附件:”开头的行,及其后以“2.”“3.”开头的行。
7a. 命令(令):红色短行以“令”结尾、下一行是“第12号”(或【待补:令号】)的,标志后的这一行是令号;有令号的文档没有标题,令号之后直接是正文。
7b. 附件页:docx 中独占一行的“附件”“附件1”段落是附件页标识,其后第一个非空段是附件标题;主文识别到标识之前为止,附件页另查。正文文件中用“【附件1】标题”分界行引出附件(只在 build_docx.py 读取)。
8. 表格:build_docx.py 读到的 Markdown 管道表格(表头行、分隔行、数据行),check_docx.py、fix_docx.py 读到的 docx 正文表格(不含版记表格),在识别时占一个位置,不参与标题、署名的判断;表格上一行以“表1”“附表2”开头,或以“表”“清单”“台账”结尾的短行(不超过 40 字、没有句号)为表题。
9. 从末尾倒推:“××××年×月×日印发”行为印发机关和印发日期;“抄送:”行为抄送;成文日期下一行的括号行或“联系人:”“联系电话:”行为附注;“××××年×月×日”行为成文日期;日期前不超过 3 行、不含标点的短行为发文机关署名。“特此通知”“妥否,请批示”等结束语按正文处理。
10. 简报(简报无国家标准格式,以下按常见做法识别,各单位以往期样式为准):开头第一行以“简报”“动态”“信息”等结尾(指定简报版式时放宽为不带句末标点的短行)、红色,后接“第12期(总第68期)”“编印单位 日期”行的,是报头;“────”分隔线忽略;末尾的“报:”“送:”“发:”“抄送:”“(共印X份)”行是报尾(docx 中报尾是贴版心底部的表格)。报头、报尾之间,不带句末标点、不超过 50 字的短行是篇目标题(连续几行都算标题,末尾孤立的标题行按正文),标题下的括号注(如“(某街道供稿)”)是题注,其余按层次标题、表格、正文识别。报头、报尾要素不当作正文检查。

## 三、fix_docx.py 修改范围

| 改 | 不改 |
|---|---|
| 纸张、页边距、页脚距离、文档网格 | 文字内容(段首用于缩进的空格除外) |
| 各角色段落的对齐、缩进、行距、段前段后 | 发文机关标志的字号、颜色和位置 |
| 各角色文字的字体、字号;正文非黑色文字改黑色 | 正文中的表格(只统一版记表格的字体) |
| 署名和成文日期按是否盖章重新排列;正文最后一段至落款、末尾不带句号且独占一行的层次标题、表题设“与下段同页” | 页眉内容(有内容时在报告中提示) |
| 纪要第一个出席段前空一行(没有空段时用段前距) | 正文表格本身(只统一表题格式) |
| 页码(重设奇数页、偶数页页脚) | 信函格式的首页页眉页脚 |
| 上行文发文字号补足左缩进一字(不改文字) | 命令(令)的签发人职务和日期、联合行文的版头和署名表格、套打留白(只提示) |
| 附件页的标识、标题和正文格式(识别到“附件”“附件1”标识段时) | 附件标识与标题之间的空行(不增删,报告提示核对) |
| 多余空段压到 1 磅高(不删除) | 发文字号、日期等写法错误(列入报告,由用户确认后改原文) |
| `--keep-text`:以上格式照常调整,段首空格也保留 | `--keep-text` 时一个字都不改;标点、数字、写法问题只在报告“文字类问题”中列出,保存前核对文字与原文件一致 |
| 简报:篇间、标题后的空行,篇目标题、题注、正文、层次标题,报尾表格的字体 | 简报报头(名称、期号行、编印行和红线)保持原样,缺项由 check_docx.py 报出 |

## 四、annotate_docx.py 批注写法

1. 定位:先在各段(含表格中的段落)中逐字查找 excerpt;找不到时忽略空格再查。同一片段出现多处时,依次批注尚未批注的位置。
2. 批注内容:第一行“【级别|关口|类别】问题说明”,第二行“建议:……”,第三行“依据:……”;作者默认“gongwen-review”,缩写“GR”。
3. 列入未定位清单的情况:excerpt 为空;原文中找不到(跨段、已改动、在页眉页脚或文本框中);所在文字含域代码、图片或超链接,无法拆分;同一片段的每一处都已有批注。
4. 只写批注,不写修订,不改正文文字。
5. 批注加在由送审稿排出的 docx 上:核稿意见的 excerpt 取自送审稿(JSON 的 `source_file`)。按核稿意见改过的终稿不加批注,excerpt 多已改掉,大部分条目会定位不到。

## 五、退出码与输出文件

| 脚本 | 输出 | 退出码 |
|---|---|---|
| build_docx.py | 不写 -o 时输出到输入文件同目录:正文.txt 输出“成稿.docx”,正文-××.txt 输出“成稿-××.docx”,其他输入输出“<输入文件名>.docx”(如 送审稿.txt 输出“送审稿.docx”);已存在时加 -v2、-v3 | 0 成功;2 输入错误或缺少依赖 |
| check_docx.py | 屏幕输出,--json 为机检 JSON | 0;--strict 且有 P0 时 1(`--allow` 降级的不计);2 输入错误 |
| fix_docx.py | “原名-修复.docx”和“原名-修复-修复报告.md” | 0 成功;2 输入错误 |
| annotate_docx.py | “原名-批注.docx”和“原名-批注-批注报告.md” | 0 成功;2 输入错误或 python-docx 低于 1.2.0 |
| preview_docx.py | “原名-预览/”下的 PDF 和逐页 PNG(需 LibreOffice,PNG 另需 pymupdf);本机缺任一标准字体或无法检测时拒绝渲染,无绕过选项 | 0 完成或找不到 LibreOffice(只提示);2 输入错误或转换失败;3 缺标准字体或无法检测,拒绝渲染 |
| gw_fonts.py | 屏幕输出各标准字体是否已安装、缺失时的获取与安装方法,`--json` 为结构化输出 | 0 标准字体齐全;3 缺字体或无法检测;2 参数文件读取失败 |

build_docx.py、fix_docx.py 的字体核对结果(`font_status`、`font_method`、`missing_fonts`、`unverified_fonts`、`font_notice`、`unit_fonts`)并入 JSON 报告,屏幕报告和修复报告开头有醒目的“字体缺失”区块;文件中一律写入标准字体名(指定了 `--unit-fonts` 的角色写入单位字体名,同样要求本机装有),不降级、不替代。

脚本只读写本地文件,不访问网络。原文件一律不修改。
canvas-designanthropics/skillsCreate beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
docxanthropics/skillsUse this skill whenever the user wants to create, read, edit, or manipulate Word documents (.docx files) or Word templates (.dotx files). Triggers include: any mention of 'Word doc', 'word document', '.docx', '.dotx', or requests to produce professional documents with formatting like tables of contents, headings, page numbers, or letterheads. Also use when extracting or reorganizing content from .docx or .dotx files, inserting or replacing images in documents, performing find-and-replace in Word files, working with tracked changes or comments, or converting content into a polished Word document. If the user asks for a 'report', 'memo', 'letter', 'template', or similar deliverable as a Word or .docx file, use this skill. Do NOT use for PDFs, spreadsheets, Google Docs, or general coding tasks unrelated to document generation.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
pdfanthropics/skillsUse this skill whenever the user wants to do anything with PDF files. This includes reading or extracting text/tables from PDFs, combining or merging multiple PDFs into one, splitting PDFs apart, rotating pages, adding watermarks, creating new PDFs, filling PDF forms, encrypting/decrypting PDFs, extracting images, and OCR on scanned PDFs to make them searchable. If the user mentions a .pdf file or asks to produce one, use this skill.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
pptxanthropics/skillsUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an email or summary); editing, modifying, or updating existing presentations; combining or splitting slide files; working with templates (.potx), layouts, speaker notes, or comments. Trigger whenever the user mentions "deck," "slides," "presentation," or references a .pptx or .potx filename, regardless of what they plan to do with the content afterward. If a .pptx or .potx file needs to be opened, created, or touched, use this skill.Stars: 198kUpdated Claude CodeCodexVerifiedInstall