写在前面：笔者在机关单位从事公文写作多年，深感排版格式是公文工作中最耗时、最易错的环节。直到遇到这个开源工具，一条命令就能把草稿转成标准红头文件，格式检查、内容润色、事实核验全流程自动化。项目功能极其强大，但 Star 数还不到两位数，实在可惜。特写此文推荐给所有被公文格式折磨的同仁。

---

一、痛点：公文人的格式焦虑

如果你在体制内、国企或事业单位工作，一定对这些场景不陌生：

• 一份通知，标题字体要"方正小标宋简体二号"，正文要"仿宋_GB2312三号"，行距33磅，页边距上3.7下3.5左2.8右2.6——这些参数你背得下来吗？
• 领导改了一版措辞，你要逐句对比哪里变了，手动标修订、写批注，生怕遗漏。
• 人名、职务、机构全称写反了，发文后才被发现——这种事实错误是重大失误。
• Markdown 草稿要转成正式公文格式，手动排版半小时起步。

这些事情，gongwen-skill 全部能自动完成。

---

二、gongwen-skill 是什么

一句话概括：基于 GB/T 9704《党政机关公文格式》国家标准的中文公文全流程处理工具。

核心信息：

维度	说明
国标依据	GB/T 9704《党政机关公文格式》
公文类型	24 种（通知/请示/报告/函/会议纪要/新闻稿/讲话稿…）
能力命令	25+ 条（检查/修复/优化/生成/注入/核验…）
依赖	仅 3 个纯 Python 包（python-docx / pydantic / pyyaml）
部署	无数据库、无 Web 框架、无桌面端，克隆即用
许可证	MIT 开源
安装	pip install gongwen-skill 或 git clone

项目地址：

• GitHub：https://github.com/linhut/gongwen-skill
• GitCode 镜像：https://gitcode.com/linhut/gongwen-skill
• AtomGit 镜像：https://atomgit.com/linhut/gongwen-skill
• PyPI：https://pypi.org/project/gongwen-skill/

---

三、核心能力逐一看

3.1 一条命令生成标准公文模板

python -m gongwen template notice -o 通知模板.docx

生成的模板严格遵循国标：方正小标宋简体二号标题、仿宋_GB2312三号正文、33磅行距、标准页边距，拿来即用。

3.2 格式检查与自动修复

检查（只读，不改原文）：

python -m gongwen check 公文.docx -t notice --json

输出分级问题清单：P0（严重）、P1（重要）、P2（建议），一目了然。

修复（自动修排版，不动文字内容）：

python -m gongwen optimize 公文.docx -o 成品.docx -t notice --apply

字体不对？修。行距不对？修。页边距不对？修。编号格式不对？修。一键搞定，输出的文档直接合规。

3.3 Markdown 草稿直转正式公文

这是我最喜欢的功能。先在 Markdown 里写好内容（甚至支持 Front Matter 元数据），一条命令转成标准格式 .docx：

python -m gongwen md2docx 草稿.md -o 正式公文.docx -t report \
  --signer "XX单位" --date "2026年8月1日"

写公文终于可以像写 Markdown 一样高效了。

3.4 红头文件：版头/版记/页码一条龙

公文不仅要内容规范，还要有红头。gongwen-skill 把版头、版记、页码注入做成了独立命令：

# 注入版头：发文机关标志 + 发文字号 + 签发人 + 红色反线
python -m gongwen header 公文.docx -o 红头公文.docx \
  --org-name "XX单位文件" --doc-number "〔2026〕12号"

# 注入版记：抄送机关 + 印发机关 + 印发日期 + 分隔线
python -m gongwen footer 红头公文.docx \
  --cc "各单位" --printer "XX办公室" --print-date "2026年8月1日"

# 注入页码：Word PAGE 域动态页码（单右双左，适配双面打印）
python -m gongwen pagenum 红头公文.docx --alignment right

生成的红头公文，版式要素齐全，直接可用于正式场合：

3.5 内容优化：Word 原生修订 + 分类批注

这是整个项目最硬核的能力，也是市面上同类工具几乎做不到的。

传统的内容润色工具最多给你一个"修改后版本"，你得自己对比差异。而 gongwen-skill 直接生成 Word 原生修订标记（w:del/w:ins）和 分类批注（comments.xml），在 Word/WPS 的"审阅"面板里可以逐条接受/拒绝、按审阅者筛选，和真实的公文审稿流程完全一致。

python -m gongwen optimize-content 原文.docx \
  --changes 修订内容.json --apply --mode tracked -t news

输出效果（在 Word 中打开后）：

放大看细节——每处修改都有删除线标记新文字，右侧批注按角色分类着色：

8 色审阅角色体系

gongwen-skill 设计了一套 8 色审阅角色方案，每类问题由独立角色负责，颜色各异，Word 中可按审阅者筛选：

角色	颜色	负责领域
格式审校	蓝色 #2E86C1	格式优化
用语审校	绿色 #27AE60	用语优化
逻辑审校	红色 #E74C3C	逻辑优化
法规审校	紫色 #9B59B6	法规合规
综合审校	橙色 #F39C12	内容优化
事实核验	青色 #00BCD4	事实核验
GongWen-Skill 修订	玫红 #E91E63	内容/事实核验修订
风格审校	深紫 #6C3483	风格优化（自动应用）

这意味着：审稿人可以只看"事实核验"批注，确认人名职务是否准确；也可以只看"格式审校"批注，集中处理排版问题。分工明确，效率倍增。

3.6 事实核验：防止"领导职务写反"的严重错误

公文写作中铁律：领导姓名、职务、机构全称绝对不能出错。gongwen-skill 内置事实核验能力：

• 实体提取：自动识别人名+职务配对（如"省XX委党组成员、副主任XXX"）
• 互联网交叉核验：配置 GONGWEN_WEB_VERIFY=1 后，百度→必应多引擎搜索验证
• LLM + 规则混合提取：配置 API 后，LLM 内容理解提取（主通道）+ 规则提取（兜底）
• 结果分级：存疑 / 已确认 / 未经核验，生成独立批注

# 带事实核验的内容优化
python -m gongwen optimize-content 新闻稿.docx \
  --changes changes.json --apply --mode tracked -t news \
  --background 背景资料.pdf

3.7 风格增强：6 套公文语言风格

公文不同场景需要不同语感——通知要庄重严谨，请示要请示商洽，法规条文要平实准确。gongwen-skill 内置 6 套风格提示词：

1. 庄重严谨（通知/决定/通报）
2. 平实简洁（报告/总结）
3. 宏观概括（公报/决议）
4. 请示商洽（请示/函）
5. 法规条文（制度/意见）
6. 讲话稿（讲话稿/主持词）

风格建议会自动合入已有变更（auto-accept），批注标注"已自动应用"，跨 20+ 文档类型自动适配，不硬编码关键词。

3.8 桌签生成、文档审计、会话交接

除了核心的格式和内容能力，还有一些"小而美"的实用命令：

• 桌签生成 table-signs：批量生成 A5 横版会议桌签，再也不用手动排
• 文档审计 audit：检查删除线/加粗/AI 声明等痕迹，确保文档"干净"
• 会话交接 handoff：跨会话上下文传递，长任务不丢上下文

---

四、AI Agent 原生集成：让 AI 帮你写公文

gongwen-skill 不只是命令行工具，它还被设计为 可被 AI Agent 直接调用的 Skill。打包了标准的 SKILL.md 技能清单，支持以 SKILL.md 为技能入口的平台：

• DeepSeek Harness (DSH)
• WorkBuddy
• CloudCode
• Claude Code
• AtomCode

安装到 Agent 的 skills 目录后，你可以直接用自然语言对话：

你说	Agent 自动执行
“帮我检查这份通知的格式”	check 并展示问题清单
“帮我排版这份红头文件”	optimize --apply 修复格式
“润色一下这份报告的措辞”	optimize-content（修订+批注）
“帮我写一份关于XX的通知”	追问细节 → md2docx → optimize → check
“核验一下这份新闻稿里的人名职务”	optimize-content --output-tasks → 核验 → --input-tasks 回填

Agent 调用示例对话：

用户：帮我优化这份会议通知的第二章节措辞

Agent：
  合规自检报告
  Skill 版本: v1.12.68（多渠道自检已确认最新）
  路径判定: B（内容优化）
  命令调用: optimize-content 会议通知.docx --changes changes.json --apply
  交付物: 会议通知+庄重严谨+2026-08-01+v1.docx（Word 原生修订+批注版）
  质量验证: check 通过

DeepSeek Harness (DSH) 深度集成

项目原生支持 DSH 的两种集成方式：

1. Skill 文件系统（轻量、跟随项目）：克隆到 .dsh/skills/ 目录，Agent 自动发现
2. Cordis 插件 bundle（npm 包通道）：dsh plugin --profile web add -w gongwen-skill，让 Web UI 工具面板直接调用

还支持通过 ~/.gongwen-skill/dsh-config.json 配置化排版参数（页边距/行距/字体等），热更新，修改即生效。

---

五、30 秒快速上手

# 方式一：pip 安装（最简）
pip install gongwen-skill

# 方式二：克隆源码
git clone https://github.com/linhut/gongwen-skill.git
cd gongwen-skill
pip install -r requirements.txt

# 安装标准字体（方正小标宋简体/仿宋_GB2312/楷体_GB2312）
python -m gongwen font install

# 验证安装
python -m gongwen --version
# 输出: gongwen-skill v1.12.68

# 生成一份标准通知模板
python -m gongwen template notice -o 通知模板.docx

# 检查公文格式
python -m gongwen check 公文.docx -t notice --json

# 自动修复格式
python -m gongwen optimize 公文.docx -o 成品.docx -t notice --apply

# Markdown 转公文
python -m gongwen md2docx 草稿.md -o 正式公文.docx -t report

# 内容优化（修订+批注）
python -m gongwen optimize-content 原文.docx \
  --changes changes.json --apply --mode tracked -t news

终端操作一览：

---

六、GB/T 9704 国标格式速查

很多人对国标格式参数记不住，gongwen-skill 帮你全部内置了。这里也做个速查表：

元素	字体	字号	对齐
公文标题	方正小标宋简体	二号（22pt）	居中
一级标题（一、二、）	黑体	三号（16pt）	顶格
二级标题（（一）（二））	楷体_GB2312	三号（16pt）	首行缩进2字符
三级标题（1. 2.）	仿宋_GB2312 加粗	三号（16pt）	首行缩进2字符
正文	仿宋_GB2312	三号（16pt）	首行缩进2字符
西文/数字	Times New Roman	与中文字号一致	—
页码	宋体	四号（14pt）	单右双左
页边距	—	上3.7/下3.5/左2.8/右2.6 cm	—

这些参数在 gongwen-skill 的 rules/official/_common.yaml（836行）中完整定义，驱动所有格式检查与修复命令。

---

七、规则自定义：你的单位有特殊要求？

公文格式有时有单位个性化需求（比如页边距调整、行距微调）。gongwen-skill 支持三层规则优先级：

官方规则（official）< 单位规则（custom）< 用户规则（user）

用 YAML 定义，同名字段自动覆盖：

# 导出某类型的规则看看
python -m gongwen rule-export notice -o notice_rules.yaml

# 导入你单位的规则
python -m gongwen rule-import my_company -f 公司规范.yaml

# 查看规则
python -m gongwen rule-list notice

---

八、技术亮点：为什么说它"市面上最强"

能力	市面同类工具	gongwen-skill
国标格式覆盖	部分覆盖	24 种公文类型，完整 GB/T 9704 参数
格式检查	简单提示	P0/P1/P2 三级分级，结构化 JSON
格式修复	需手动操作	一键 --apply 自动修复
内容润色	给修改后文本	Word 原生修订+批注，审阅面板逐条操作
事实核验	无	实体提取+互联网交叉核验
修订分类	单色批注	8 色角色体系，可按审阅者筛选
风格适配	固定风格	6 套风格，数据驱动自动适配
Markdown 转公文	无	支持 Front Matter 元数据
版头/版记/页码	需手动排版	独立命令一条龙注入
AI Agent 集成	无	原生 Skill，支持 DSH 等 5+ 平台
部署依赖	重（数据库/Web/桌面端）	3 个纯 Python 包，克隆即用
字体管理	需手动找字体	内置 3 个标准字体，font install 一键安装

---

九、适合谁用

• 机关单位公文写作者：格式检查+修复+内容优化+事实核验，全流程覆盖
• 国企/事业单位办公室：批量公文规范化，红头文件一条龙生成
• AI Agent 开发者：原生 Skill 集成，让 AI 帮用户自动处理公文
• 公文写作教学/培训：24 种类型模板+国标参数，现成的教学素材
• 任何需要写正式中文文档的人：即使不是公文，格式规范也适用

---

十、社区与参与

项目完全开源（MIT），欢迎参与：

• GitHub：https://github.com/linhut/gongwen-skill

项目持续迭代中，目前已到 v1.12.68，204 次提交，功能仍在不断完善。

---

写在最后

公文格式规范化这件事，看似简单实则繁琐——字体字号行距页边距，每一项都有国标要求，错一项就不合规。市面上的工具要么只做格式检查不修复，要么只做排版不做内容润色，更没有事实核验和 AI 集成。

gongwen-skill 把格式检查→自动修复→内容优化→事实核验→风格增强→版头版记注入→Markdown 转公文做成了完整闭环，25+ 条能力命令覆盖公文全生命周期，还原生支持 AI Agent 调用。

功能这么完整的工具，Star 数还不到两位数。如果你也在做公文相关工作，强烈建议试一试——一条命令省下半小时排版时间，这笔账怎么算都值。

pip install gongwen-skill
python -m gongwen template notice -o 通知模板.docx

---

项目地址：https://github.com/linhut/gongwen-skill
许可证：MIT
作者：Jose AI（https://www.linhut.cn）