<!-- README_SYNC: source=working-tree; updated=2026-10-22 --> <div align="center">

公文 Skills · gongwen-skills

面向机关事业单位和国企文字工作者的公文写作 Skills：防编造、守保密、一键 GB/T 9704 排版。

简体中文 · English

如果这个项目帮了你，点一个 Star，方便回来，也让更多有同样需求的人更容易发现它。

快速开始 · 技能地图 · 直接这样说 · 效果 · 常见问题 · 关注与交流

</div>

保密提示：涉密信息严禁输入任何联网 AI 工具。处理内部材料请使用单位内网部署的模型；本项目的提示词版和离线包可以直接在内网使用。详见 使用须知。

<div align="center"> <img src="docs/assets/hero-before-after.png" width="860" alt="AI 腔通知经过 gongwen-skills 处理前后对比：P0 必改 5 处降到 0，P1 建议改 31 处降到 0，生成国标红头 docx" />

示例为虚构的区教育局通知，完整过程见 examples/B-AI稿体检；成稿截图为近似渲染，实际字体以本机安装为准。

</div>

---

和普通 AI 写材料有什么不同

| | 一般的 AI 写作 | gongwen-skills | |---|---|---| | 数据和案例 | 缺了就编 | 只用你给的材料，缺的标【待补】 | | 篇幅 | 越写越长，素材不够就注水 | 你定了字数就按字数写，不新增事实、不注水 | | 文风 | AI 腔、新八股 | 去掉 AI 腔，保留"一是二是"、排比小标题这些公文正当写法 | | 态度 | 对冲、免责声明 | 措辞明确，需要核实的事项放到正文之外 | | 格式 | 自己排 | 一键生成 GB/T 9704 国标 docx，机检标点、数字、发文字号 | | 单位差异 | 一刀切 | 7 类单位画像、5 种角色模式、5 个行业包 |

---

同台评测摘要：和 GitHub 上 8 个同类公文 skill 以及"不装 skill"对照组，在同一模型、同一批题目下各跑 2 次，由 Claude、DeepSeek 两个 LLM 评审排名（不是人工评审）。

• 排版，明显第一：Claude 评审的 16 次运行全部排第 1，GB/T 9704 版式审计 97.2 分（次优 79.6 分）；缺字体时 16 次都按标准字体名书写并告知，不替代
• 涉密与防编造，领先：首页标密级的涉密题，本项目检查点通过率 91.7%，所有对手 0%；写作赛道出现编造的运行最少（Claude 评审 7/20，DeepSeek 评审 13/40）；去 AI 味事实保持 99.6%
• 写作与去 AI 味，第一梯队：DeepSeek 评审在两个赛道都排第 1；Claude 评审下与最好成绩的差距在 0.5 个名次以内
• 最新一轮复测（v9，写作赛道）：自动化检查点通过率 81.0%，排第 1（次优 77.5%）

各项数据、对比对象、局限和复现脚本见下方 效果，统计表见 compete-v7 和 compete-v9。

---

快速开始

先看你在用什么工具：

| 你在用 | 安装方式 | |---|---| | DeepSeek、豆包、Kimi 等网页版，或单位内网模型 | 不用安装，复制提示词即可，见方式四 | | Claude Code | 插件市场两行命令，见方式二 | | Codex、Cursor、Gemini CLI、GitHub Copilot、Qwen Code、Kimi Code CLI | 一键脚本，见方式一 | | 已经在用 Agent，不想敲命令 | 见方式五 |

Trae、CodeBuddy 的 skills 目录路径尚未完全核实，一键脚本提供了对应目标（--target trae、--target codebuddy），可以试用，遇到问题请提 Issue。

方式一：一键安装脚本（Windows、macOS、Linux）

1. 下载本仓库。会用 git 的运行 git clone https://github.com/duyunzhoudyz/gongwen-skills.git；不会的，点本页上方绿色 Code 按钮，选 Download ZIP，下载后解压。
2. 在仓库文件夹里运行（Windows 在文件夹地址栏输入 powershell 回车；macOS、Linux 在终端里进入该文件夹）：

powershell -ExecutionPolicy Bypass -File .\install.ps1

bash install.sh

脚本检查 Python（3.9+），询问是否安装排版依赖，然后把 17 个核心 skill 装进本机找到的全部 Agent 工具。只想看会装到哪里而不写入文件：Windows 末尾加 -WhatIf，macOS/Linux 加 --dry-run。

查看支持哪些工具，或只装到某一个工具（以 Qwen Code 为例）：

python tools/install.py --list-targets
python tools/install.py --target qwen

方式二：Claude Code 插件市场

/plugin marketplace add duyunzhoudyz/gongwen-skills
/plugin install gongwen@gongwen-skills

方式三：npx skills（需要 Node.js）

npx skills add duyunzhoudyz/gongwen-skills

方式四：网页大模型或内网模型（不用安装）

打开 dist/prompts/，复制提示词文件全文，粘贴到对话开头，再说出你的需求。第一次用，从 gongwen.md（总入口）开始。

• 每个 skill 对应一份提示词，每份约 2.6 万～2.9 万字。
• 需要换到下一个 skill 时，当前对话会给你一张交接卡。新开对话，先粘贴下一份提示词，再粘贴交接卡和材料。
• 单位内网使用，运行 python tools/build_prompts.py --offline 生成离线包（输出到 dist/offline/）。

方式五：让 Agent 自己装

把这段话发给你的 Agent：

请把 https://github.com/duyunzhoudyz/gongwen-skills 中 skills/ 目录下的 skill 安装到你的 skills 目录。
其中 gongwen-grassroots、gongwen-hospital、gongwen-university、gongwen-k12、gongwen-soe 是行业包，
只装我需要的 gongwen-hospital。装好后告诉我有哪些可用。

选装行业包

行业包装在核心 skill 之上，按需选装。以医院为例：

/plugin install gongwen-hospital@gongwen-skills

bash install.sh --pack hospital

一键脚本支持多选：--pack hospital --pack soe；装全部：--pack all。

网页版直接用 dist/prompts/ 里对应的提示词，如 gongwen-hospital.md。

依赖：排版和 Excel 图表需要 Python 3.9+ 及 python-docx、openpyxl（pip install python-docx openpyxl，一键脚本会询问是否安装）。没有 Python 时，排版 skill 给出 WPS/Word 手动设置清单。

卸载：安装命令末尾加 --uninstall，确认清单后再加 --yes。

---

技能地图

17 个核心 skill 装在一个插件里，5 个行业包按需选装。

成熟度：Stable = 真实模型评测通过率 ≥ 80%、防编造 0 次、触发正确；Beta = 样例测试通过，一线反馈后升级。

入口与配置

| Skill | 能力摘要 | 成熟度 | |---|---|---| | gongwen 总入口 | 接住说不清的需求，判断文书类型和行文方向，3 个问题建简版单位画像，规划路线 | Stable | | gongwen-profile 单位画像 | 完整建档；学本单位历史稿文风；归纳领导改稿偏好；管理禁用词 | Stable |

起草

| Skill | 能力摘要 | 成熟度 | |---|---|---| | gongwen-draft 法定公文 | 通知、请示、报告、函、通报、批复、意见、签报、决定、通告、公告；先定文种再成稿 | Stable | | gongwen-report 综合文稿 | 总结、计划、工作要点、汇报、调研报告、经验材料、述职述责述廉、实施方案、大会报告 | Stable | | gongwen-speech 讲话类 | 领导讲话、主持词、致辞、表态/交流/代表发言；按时长定字数，写成口语稿 | Stable | | gongwen-party 党建与组织生活 | 对照检查、党建报告、党课、研讨发言、心得汇报、"三会一课"记录整理；无本人事例只给提纲 | Stable | | gongwen-brief 信息简报 | 政务信息、简报、新闻稿、公众号推文；长材料压成信息；评估能否被采用 | Stable | | gongwen-minutes 会议纪要 | 会议记录、纪要、上会议题材料、督办清单；只整理不添加，分清同意/原则同意/暂缓 | Stable | | gongwen-implement 上级文件转化 | 提取要点、任务分解表、实施方案、落实情况报告；检测照抄原文，提示层层加码 | Stable | | gongwen-rectify 整改材料 | 整改方案、台账（可转 Excel）、整改进展报告、自查报告；报告与台账逐条对账 | Stable |

改稿质检

| Skill | 能力摘要 | 成熟度 | |---|---|---| | gongwen-title 标题与提纲 | 公文标题、主副标题、三套小标题方案、提纲，检查标题与正文是否对应 | Stable | | gongwen-polish 改稿润色 | 压缩、扩写、语气互转、大白话转公文、按领导批注改、多稿合并 | Stable | | gongwen-humanize 去 AI 味 | 改掉 AI 腔，保留公文正当写法，事实一字不动 | Stable | | gongwen-direct 去防御性 | 删免责声明，把"建议""可以考虑"改成要求，让请示有倾向性意见 | Stable | | gongwen-review 核稿审校 | 按"八关"核稿，出分级问题清单；机检标点、数字、格式、保密隐私、禁用词 | Stable |

交付工具

| Skill | 能力摘要 | 成熟度 | |---|---|---| | gongwen-format 国标排版 | 按 GB/T 9704-2012 生成红头、信函、纪要、白头、材料、简报六种版式 Word；修复已有 docx | Stable | | gongwen-data 数据与图表 | 报表体检、同比环比计算（附算式）、数据写成公文句子、本机生成黑白灰 Excel 图表 | Stable |

行业包（单独安装）

| Skill | 能力摘要 | 成熟度 | |---|---|---| | gongwen-grassroots 乡镇街道社区 | 迎检汇报、居民通知、应急通知、工作台账、村居务公开 | Beta | | gongwen-hospital 公立医院 | 等级评审自评、绩效分析、RCA/PDCA、科室述职（DRG/CMI）、党委会/院长办公会议题 | Beta | | gongwen-university 高校 | 审核评估自评、学科评估、申报书审查、学院总结、签报和两级发文判断 | Beta | | gongwen-k12 中小学 | 学期计划总结、督导评估自评、家长会讲话、学生评语、致家长一封信 | Beta | | gongwen-soe 国有企业 | "三重一大"议题、董事会议案、总经理办公会纪要、ESG 报告、合规管理报告 | Beta |

---

直接这样说

不用记 skill 名，把你的需求直接发给它：

| 你发给它 | 由谁处理 | |---|---| | "帮我判断一下这个材料应该用什么文种，然后起草。（附背景材料）" | gongwen 总入口 | | "这是今天上午安全生产专题会的录音转文字，帮我出纪要，定了的事列个督办清单。" | gongwen-minutes | | "写一篇科室年度工作总结，2000 字左右，素材在附件里，不要编数据。" | gongwen-report | | "这是 AI 写的初稿，把'赋能''闭环''全链条'这类 AI 腔去掉，改成正常公文的语气，数字和案例一个不动。（附稿件）" | gongwen-humanize | | "这篇通知里的'建议各单位''可以参考'改成要求的口气，明确是必须执行。（附通知）" | gongwen-direct | | "明天这份请示要送签，先帮我核一遍有没有问题，核完排成标准红头 Word。（附请示）" | gongwen-review → gongwen-format | | "市里下发了这个文件，帮我提取任务清单，写我们单位的贯彻落实方案。（附文件）" | gongwen-implement | | "巡察组反馈了 9 个问题，帮我出整改方案和整改台账，台账最后要能导出 Excel。（附反馈清单）" | gongwen-rectify | | "下周等级评审，帮我写科室自评报告，重点体现 DRG 和 CMI 指标，材料在这里。（附数据）" | gongwen-hospital 行业包 | | "学校审核评估，帮我写学院自评报告里'教学资源与利用'这一条，填写要求在附件。" | gongwen-university 行业包 | | "子公司增资需要上三重一大，下周党委会，帮我准备上会材料，议题说明和决议草案都要。" | gongwen-soe 行业包 | | "社区下周二停水检修，帮我写一份贴在单元门口的通知，另外写一条简短的发业主群消息。" | gongwen-grassroots 行业包 |

更多用法见各 skill 目录下的 README。

---

一份材料的完整流程

| 场景 | 路线 | |---|---| | 年终总结、述职、汇报材料 | gongwen 确认需求 → report 建素材台账出稿 → direct、humanize 清理腔调 → review 核稿 → format 排国标 Word | | AI 稿体检（手上已有 AI 稿） | direct → humanize → review，要 Word 的再加 format | | 上级文件转化 | implement 提取要点、拆任务表、写实施方案 → direct → review → format |

表中省略了 gongwen- 前缀。在能调用多个 skill 的工具里，总入口按路线逐站交接；在网页版里，每站结束给交接卡，粘贴到下一份提示词后继续。

---

效果

AI 稿体检：一篇通知的前后对比

模拟 AI 起草的区教育局冬季校园安全检查通知，依次经过 gongwen-direct → gongwen-humanize → gongwen-review（完整过程见 examples/B-AI稿体检）：

| 机检 | P0 必改 | P1 建议改 | 篇幅 | |---|---:|---:|---:| | 原稿 | 5 | 31 | 1092 字 | | 体检后 | 0 | 0 | 814 字 |

原稿（节选）

随着冬季的到来，校园安全形势日趋复杂严峻……

一、充分认识冬季校园安全检查的重要意义

毋庸置疑，校园安全是教育事业发展的底线和生命线。……各学校要以此次检查为抓手，打造全方位、全链条的校园安全管理体系，充分运用信息化手段赋能校园安全管理……

以上内容仅供参考，请各学校结合实际情况调整。

体检后

一、总体要求

冬季取暖用电增多、道路结冰、流感高发，是校园安全事故的高发期。部分学校仍存在重检查轻整改的问题。各学校要以此次检查为抓手，建设校园安全管理体系，运用信息化手段提升校园安全管理水平……

其他改动："建议各学校成立……专班"改成"各学校要成立……专班"；发文字号 [2026]第12号 改成 〔2026〕12号；"对家长一律移交公安机关予以拘留"的表述，核查后发现区教育局没有处罚权，予以删除。

另有两个示例：医院科室年终总结（要求 2000 字而素材不多：正文约 1890 字，只有 2 处【待补】，没有新增事实）和申请经费该用函还是请示。

与同类项目对比

本项目和 GitHub 上 8 个同类公文 skill、"不装 skill"对照组同台真跑（compete-v7：写作 11 题、排版 8 题、去 AI 味 8 题，每个参赛方每题 2 次，共 276 次运行）。同一模型（claude-sonnet-5-5，max 推理强度）、同样的用户消息和材料，材料全部虚构。

| 维度 | 本项目 | 最好的对比项（含"不装 skill"对照） | |---|---|---| | 排版：GB/T 9704 版式审计均分（16 次运行） | 97.2 分 | 79.6 分 | | 排版：Claude 评审平均名次 | 1.00，16 次全部第 1 | 2.25 | | 排版：字体诚实 | 16/16 按标准字体名书写并告知缺字体 | 一个项目 16 次用替代字体、其中 2 次未告知；不装 skill 16 次静默替换 | | 涉密材料（首页标"秘密"，检查点通过率） | 91.7%（Claude、DeepSeek 评审一致） | 所有对手 0% | | 写作：出现编造的运行（Claude 评审，共 20 次） | 7/20（最少） | 8/20；不装 skill 11/20 | | 写作：出现编造的评审（DeepSeek，共 40 次） | 13/40（最少） | 14/40 | | 写作：平均名次，Claude 评审（1 最好） | 3.45，与另两个项目并列 | 不装 skill 对照 2.95 | | 写作：平均名次，DeepSeek 评审 | 2.98，第 1 | 3.02 | | 去 AI 味：事实保持 | 99.6%，平均新增数字 0.25 个，改动 11.3% | 99.8%，但只改动 1.7% 的文字、AI 味处理均分 1.8（本项目 6.1，满分 10）；其余对手 97.0% | | 去 AI 味：平均名次，Claude 评审 | 2.06，与另一个项目并列 | 不装 skill 对照 2.00 | | 去 AI 味：平均名次，DeepSeek 评审 | 1.88，第 1 | 1.91 | | 去 AI 味：出现新增事实的运行（Claude / DeepSeek） | 1/16、2/32 | 3/16、7/32；另一项目 1/16、0/32（几乎不改文字） |

最新一轮复测（compete-v9）只重跑写作赛道，改用自动化检查点评分（142 个可程序化验证的检查点，语体、编造判断等无法程序化的项默认判通过）：本项目 81.0%（115/142）排第 1，次优 77.5%，不装 skill 76.1%。其中页眉密级题 2 次里有 1 次漏检页眉（读 docx 时漏掉页眉文件），已修复，修复后尚未复测。

排版、涉密拦截、防编造和字体诚实上，本项目是参赛方里成绩最好的；写作和去 AI 味处于第一梯队，DeepSeek 评审排第 1，Claude 评审下与最好成绩相差 0.5 个名次以内。

几点限定：

• 评审员是 Claude 与 DeepSeek 两个 LLM，不是人工；其中 Claude 评审与被测模型同为 claude-sonnet-5-5。两家评审名次的一致性（Kendall τ）：写作 0.50，去 AI 味 0.65。人工盲评在路线图中。
• 每个参赛方每题只跑 2 次（写作 20 次、排版 16 次、去 AI 味 16 次），0.1～0.5 个名次的差距不宜读成稳定排名。
• 这些题不是新的留出题：v7 用最初的题集，v9 用 tasks-v3，两套题此前都用于调试修复，所以这是迭代后的复测，不是盲测。更早的两套留出题（c4、c5）和迭代过程见竞品对标评测报告。
• 题目由本项目设计；涉密题只有 1 道（2 次运行），样本很小。
• 评测只针对当时的版本，各项目此后可能已有改进。

方法和复现脚本见 evals/compete/README.md。

v1.0 全量评测

被测模型 claude-sonnet-5-5，共 372 条用例、2671 项检查，材料全部虚构，评分员盲评。

| 口径 | 装 skill | 不装 skill | |---|---:|---:| | 全部检查项通过率（2671 项） | 98.6% | 54.1% | | 通用检查项通过率（1726 项） | 99.1% | 68.7% | | 136 条防编造用例中出现编造的运行 | 0 | 66 | | 21 条带密级用例中按要求停止处理的 | 21 | 3 |

第二轮装 skill 的一组在 max 推理强度下重跑，不装 skill 的一组沿用第一轮输出，不是等条件对比；条件完全一致的第一轮是 97.1% 对 54.0%（通用检查项 97.7% 对 68.5%）。每条用例只跑一次，评分员与被评模型是同一个模型。

17 个核心 skill 通过率均不低于 97.4%，防编造 0 次，触发达标，标 Stable；5 个行业包数字也达标，按约定等一线反馈再升级。完整方法和局限见 v1.0 评测报告。

---

六条写作红线

所有 skill 都遵守这六条，优先级高于任何具体流程（全文见 shared/guardrails.md）：

1. 保密先于生成：发现密级标识、"内部资料""工作秘密"字样或个人敏感信息，先停下来提醒。
2. 事实只来自用户：数据、案例、文号、政策依据都只取自你的材料；必须由你补的标【待补】，存疑的列在起草说明里。
3. 正文干净，提示外置：正文里没有免责声明和 AI 自述，需要核实的放到"起草说明"。
4. 默认做减法：开门见山，遵守减负规定的篇幅要求，不照抄上级文件；你指定字数就按字数写，不新增事实、不注水。
5. 规则可溯源、可机检：每条格式、标点、数字规则都标注条款号，能用脚本检查的就不靠模型自觉。
6. 辅助不代笔：对照检查、述职等需要本人经历的材料，没有素材就只给提纲。

规则依据：《党政机关公文处理工作条例》、GB/T 9704-2012、GB/T 15834-2011、GB/T 15835-2011、《整治形式主义为基层减负若干规定》。要点整理见 shared/rules/，每条标注条款号。机检引擎按这些规则做 12 类检查，覆盖 41 类文书。

---

适用人群

不需要有多好的文笔，也不