前言¶

在 DeepSeek Harness（DSH）里做公文相关任务，常见做法是手写提示词，再让用户自己对照国标调 Word 格式。格式项多、规则细，Agent 很难稳定产出合规的 .docx。手工排版则重复劳动多，检查与修订也难以在对话里闭环。

下面介绍的 gongwen-skill（维护者 linhut）把 GB/T 9704《党政机关公文格式》落成可执行的 Python CLI，并打包为 DSH 可直接加载的 Skill 与 Cordis 插件。Agent 可以调用格式检查、自动修复、内容优化、模板生成等命令，把公文处理从「口头建议」变成「可复现的工具链」。

这是什么¶

gongwen-skill 是中文公文全流程处理工具，当前版本 v2.1.0（MIT 许可证，GitHub 约 14 stars）。它基于 GB/T 9704 国家标准，面向公文写作与企事业单位材料编制场景。

项目源自开源桌面应用 AI 公文智能优化助手：抽取核心格式引擎、去掉桌面端与数据库依赖后独立发行。除命令行外，仓库自带 .dsh/skills/ 技能描述、dsh/ 桥接层与 cordis.patch.yml，可在 DSH Agent 与 Web UI 中直接调用。

运行环境要求 Python 3.10+；核心依赖为 python-docx、pydantic、pyyaml。包已上架 PyPI（gongwen-skill）。

核心功能¶

能力按「解析 → 检查 → 修复 → 生成 → 审校」组织，下列内容均来自项目 README 与能力表。

格式与模板¶

• 列类型（list-types）：列出 24 种支持的公文类型（含新闻稿、讲话稿、主持词等）。
• 模板生成（template）：按类型生成 GB/T 9704 标准空白模板。
• 解析（parse）：将 .docx 解析为结构化 DocumentModel。
• 格式检查（check）：按国标检查，问题分级为 P0/P1/P2（只读）。
• 格式修复（optimize）：自动修复字体、字号、行距、页边距等，输出合规文档。
• 模型生成（generate）：从 JSON 模型生成 .docx。
• 一键修复（fix-common）：段落类型修正、编号拆分、首句加粗、加粗范围修复等常见项。

内容与草稿¶

• 内容优化（optimize-content）：默认 Word 原生修订 + 批注（tracked 模式，审阅面板逐条接受/拒绝）；可选行内差异对比版（inline）。
• Markdown 转公文（md2docx）：支持 Front Matter 元数据，草稿直接转为格式化 .docx。
• 首句加粗（bold-first）：正文段落首句按公文规范加粗。
• 完整审校（full-review）：修订与批注联合，含句子级差异修订与分类批注。
• 审稿生成（review）：按五角色审稿机制生成审稿意见。

版式注入¶

• 版头（header）：注入发文机关标志、发文字号、签发人、红色反线。
• 版记（footer）：注入抄送机关、印发机关、印发日期、分隔线。
• 页码（pagenum）：注入 Word PAGE 域动态页码（宋体 4 号，默认单右双左适配双面打印）。

样式、规则与辅助¶

• 样式学习（style-learn / style-list）：从标准文档学习 Run/段落/页面三级样式，生成命名模板；后续用 optimize -t 模板名 套用。
• 规则管理（rule-export / rule-import / rule-list）：YAML 规则三层定制（官方/单位/用户）。
• 桌签生成（table-signs）：批量生成 A5 横版会议桌签。
• 文档审计（audit）：检查删除线、加粗、AI 声明等痕迹。
• 会话交接（handoff）：跨会话上下文传递（--list / --latest）。
• 自我诊断（doctor / repair）：诊断 Python、依赖、版本一致性、字体、DSH 文件等 21 项，可自动修复常见问题。
• 版本自检（check-update）：多渠道比对 GitHub、GitCode、AtomGit 仓库版本。

仓库还提供纯文本知识库（prompts/style-prompts.md、prompts/usage-prompts.md、rules/official/*.yaml），供 Agent 在无代码执行环境下引用写作规范。

安装与启用¶

gongwen-skill 支持多种接入方式。在 DSH 生态中，可按是否需要 Web UI 工具面板选择路径。

方式一：注册为 DSH Skill（文件系统，轻量）¶

DSH Agent 启动时会扫描技能目录（优先级从高到低：{project}/.dsh/skills/、{project}/.agents/skills/、~/.dsh/skills/、~/.agents/skills/）。

项目级安装示例：

git clone https://github.com/linhut/gongwen-skill.git ./third_party/gongwen-skill
ln -s ./third_party/gongwen-skill/.dsh/skills/gongwen-skill ./.dsh/skills/gongwen-skill

克隆后安装 Python 依赖：

cd third_party/gongwen-skill
pip install -r requirements.txt
# 或：pip install gongwen-skill

方式二：作为 DSH Cordis 插件（Web Profile）¶

若需要在 DSH Web UI 中通过工具流调用，使用官方 CLI 挂载到 Web Profile：

dsh plugin --profile web add -w gongwen-skill

该命令会按 preset 写入 ~/.dsh/profiles/web/package.json 并重建 bundle。安装后确认 dsh.profile.bundles 数组包含 gongwen-skill（仅根包，勿重复列入子目录）。

启动前在本地准备好 Python 环境：

pip install gongwen-skill   # 或于克隆目录执行 pip install -r requirements.txt
dsh --profile web

浏览器访问 http://127.0.0.1:3080/ 即可在新建会话中让 Agent 加载该技能。

字体与 DSH 配置（v2.1.0+）¶

GB/T 9704 排版依赖标准字体。克隆用户可使用 assets/fonts/ 内置字体；PyPI 安装用户需执行：

python -m gongwen font install
python -m gongwen font check

DSH 插件可通过 ~/.gongwen-skill/dsh-config.json 管理默认公文类型、页边距、正文字体与行距等排版参数；纯 CLI 用户不受影响。

插件目录页：SkillHub · linhut/gongwen-skill（分类：工作流）。

典型用法¶

以下命令可在 Agent 会话中直接执行，也可在终端手动验证。

生成标准通知模板：

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

检查公文格式（只读，JSON 输出便于 Agent 解析）：

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 --signer "XX单位" --date "2026年8月1日"

内容优化（Word 原生修订 + 批注）：

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

注入版头、版记与页码：

python -m gongwen header 公文.docx -o 红头公文.docx --org-name "XX单位" --doc-number "〔2026〕1号"
python -m gongwen footer 红头公文.docx --cc "各单位" --printer "XX办公室" --print-date "2026年8月1日"
python -m gongwen pagenum 红头公文.docx --alignment right

从标准文档学习样式并套用：

python -m gongwen style-learn 标准公文.docx -n 模板名
python -m gongwen optimize 公文.docx -o 成品.docx -t 模板名 --apply

在 AI 对话中，用户也可以用自然语言描述需求，由已加载技能的 Agent 选择对应子命令执行。

适用场景与注意¶

适合谁

• 需要在 DSH Agent 中处理党政机关或企事业单位公文的开发者与写作人员。
• 希望把 GB/T 9704 格式检查、修复、版头版记注入自动化，而不是每次手写排版说明的团队。
• 已有 Markdown 草稿或 Word 初稿，需要一键转为合规 .docx 或带审阅痕迹的优化稿的场景。

使用注意

1. 权限：插件以当前 DSH 进程权限运行，可读写本地文件并执行 Python 命令。安装前应阅读 源码 与 MIT 许可证，确认符合本单位安全要求。
2. 环境：Cordis 插件桥接层为 Node.js，实际排版由 Python CLI 完成；两种方式都需本机具备 Python 3.10+ 与依赖。
3. 字体：未安装国标字体时，检查与修复结果可能偏离预期；建议先执行 python -m gongwen font install。
4. 内容优化：optimize-content 的修订内容通常以 JSON 形式传入；Agent 需先组织修改方案，再调用命令写入 Word 修订。
5. 生态定位：SkillHub 是面向中国用户的 Skills 社区目录，与 DeepSeek / 幻方无官方从属关系；DSH 本身遵循「一切皆插件」理念，技能与插件均从本地或指定源加载。

结尾¶

gongwen-skill 把 GB/T 9704 从纸面标准落到可调用工具链：格式检查与修复、Markdown 转公文、版头版记页码注入、Word 原生修订审校，均可由 DSH Agent 在对话中驱动。若你正在 DSH 里搭建公文类工作流，可从 Skill 文件系统轻量接入，或通过 dsh plugin --profile web add -w gongwen-skill 挂到 Web Profile。

• 目录页：https://www.skillhub.cn/plugins/linhut/gongwen-skill
• GitHub：https://github.com/linhut/gongwen-skill