前言¶

在 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