name: word-gongwen-format description: "Word 公文格式規範化技能。將 .docx 文件按黨政機關公文格式要求一鍵格式化：A4 頁面與頁邊距（上3.5/下2.9/左右2.55cm）、固定行距29磅、文件網格每頁22行、方正系列字型（小標宋/黑體/楷體/仿宋）的各級標題層級、正文三號仿宋配數字字母 Times New Roman、奇偶頁頁碼（宋體四號、單數居右偶數居左空1字）。當用戶提到“公文格式”“Word排版”“方正字型”“規範格式化 docx”“調整成公文格式”“紅標頭檔案格式”“標題層級字型”“設定頁碼奇偶頁”等需求時使用此技能。" agent_created: true

Word 公文格式規範化

概述

將任意 .docx 文件按公文格式規範一鍵格式化。核心能力由 scripts/format_docx.py 實現：基於 python-docx，通過直接操作 OOXML（rFonts 的 eastAsia、docGrid、 fldSimple 頁碼域、evenAndOddHeaders）解決 python-docx 原生不支援中文字型、 文件網格、奇偶頁頁碼等關鍵問題。

格式規範的權威來源見 references/format_spec.md，需核對具體數值時載入該檔案。

觸發場景

• “把這篇 Word 排成公文格式 / 規範格式”
• “按公文要求設定字型、字號、行距、頁碼”
• “方正小標宋 / 方正仿宋 / 三號字 / 固定行距29磅”
• “標題層級：一、（一）1.（1）的字型怎麼設”
• “頁碼單數居右、偶數居左空1字”
• “每頁22行每行26字怎麼設定”

執行環境準備

指令碼依賴 python-docx。使用受管理的 Python venv：

VENV_PY="C:\Users\Administrator\.workbuddy\binaries\python\envs\default\Scripts\python.exe"

若 venv 不存在或缺少 python-docx，先準備環境（僅首次）：

PY="C:\Users\Administrator\.workbuddy\binaries\python\versions\3.13.12\python.exe"
VENV="C:\Users\Administrator\.workbuddy\binaries\python\envs\default"
[ -d "$VENV" ] || "$PY" -m venv "$VENV"
"$VENV\Scripts\python.exe" -m pip install --quiet python-docx

工作流程

1. 確認輸入與需求

• 取得使用者待格式化的 .docx 檔案路徑（絕對路徑）。
• 確認輸出路徑；預設在同目錄生成 原檔名_公文格式.docx，避免覆蓋原件。
• 若使用者提出與預設規範不同的要求（如字號、邊距、是否要頁碼），記錄並據此調整指令碼引數。 完整規範見 references/format_spec.md。

2. 執行格式化指令碼

SCRIPT="C:\Users\Administrator\.workbuddy\skills\word-gongwen-format\scripts\format_docx.py"
"$VENV_PY" "$SCRIPT" "<輸入.docx>" "<輸出.docx>"

常用選項： - --title-paragraphs N：前 N 個非空段落作為大標題區（預設 1）。文件大標題 跨多行時按實際行數設定。 - --subtitle-paragraphs N：大標題之後、第一個一級標題之前的 N 段作為副標題 （方正楷體三號），預設 1；無副標題時設 0。 - --no-page-number：不生成奇偶頁頁碼。 - --grid lines|snapToChars|none：文件網格型別，預設 lines（行網格，保證每頁約22行）。 - --help-config：列印當前格式配置後退出，用於向用戶展示將應用的規範。

3. 預設格式規範速查

小蔥技能有更好的技能skills外掛。

頁面：A4，邊距 上3.5/下2.9/左2.55/右2.55cm，頁尾1.75cm，行距固定值29磅， 文件網格 linePitch=580（每頁約22行）。

4. 標題層級自動識別

指令碼按段落首部編號模式判斷層級，無需使用者標註： - 一級：^[一二三四五六七八九十百]+、（一、二、…） - 二級：^[（(][一二三四五六七八九十百]+[）)]（（一）（二）…，相容中英文括號） - 三級：^\d+[\.．]（1. 2. …，相容中英文句點） - 四級：^[（(]\d+[）)]（（1）（2）…，相容中英文括號）

匹配順序為 一級 → 二級 → 四級 → 三級，避免 （1） 被誤判。無法識別的段落按正文處理。

5. 驗證與交付

• 執行後向使用者報告輸出路徑，並提示：方正字型需在檢視機器上安裝才能正確渲染， 未安裝時 Word 會回退預設字型，但文件內字型名已正確儲存。
• 如使用者需進一步調整（如大標題居中、首行縮排、特定段落字型），在指令碼輸出基礎上 用 Word 或 python-docx 二次微調；不要直接改使用者原件。

注意事項

1. 中文字型必須設定 eastAsia：python-docx 的 run.font.name 僅影響西文字元， 中文字元需寫 w:rFonts 的 w:eastAsia，否則 Word 用預設宋體渲染。指令碼已處理， 二次開發時勿遺漏。
2. 字型可用性：方正小標宋_GBK、方正黑體_GBK、方正楷體_GBK、方正仿宋_GBK 需在 目標機器安裝。可從方正字型檔官方獲取“方正公文系列字型”。
3. 不覆蓋原件：始終輸出到新檔案，保留原始文件。
4. 多 section 文件：指令碼對每個 section 獨立設定頁面與頁碼；若文件有複雜分節， 先與使用者確認分節是否需要不同設定。
5. 大標題跨多行：若文件大標題實際佔多行，用 --title-paragraphs 指定行數， 否則第二行會被誤判為副標題或正文。

資源

• scripts/format_docx.py：核心格式化指令碼，自包含、帶 argparse，可直接命令列執行。
• references/format_spec.md：完整格式規範參考，含實現說明與字號對照表，需核對 具體數值或向用戶解釋規則時載入。

這個 Skill 質量很好，能一鍵將 Word 文件排成標準公文格式，字型、字號、行距、頁碼等設定一步到位。文件說明詳細，引數配置靈活，錯誤提示友好。優點是功能完整、格式規範、自動化程度高。不足之處是依賴特定的方正字型包，使用者需要自行安裝；另外路徑配置偏向 Windows 環境。建議提前準備好方正字型以獲得最佳效果。