博維諮詢 Word 報告自動排版技能 v2.7.4

依據《博維諮詢Word版報告行文排版標準 V2.6-20250920》+ 國標《GB/T 15834—2011 標點符號用法》。

前置依賴: 使用本技能前，需確保已安裝 python-docx 和 lxml：

pip install python-docx lxml

本技能中的指令碼位於 scripts/ 目錄下，引用參考文件位於 references/ 目錄下。

強規則（一票否決，不達標不得交付）

標點符號必須符合 GB/T 15834—2011 國標。AI 生成的中文 Word 文件中最常見、亦最難憑肉眼察覺的錯誤，即"形似中文實為半形"的標點。此項為所有排版交付前第一項必須掃描的硬性指標。

三大判定原則

1. 純中文上下文裡，所有標點必須全形。
2. 判斷方法：標點前後兩側任一為中文字元，則該標點必須全形。
3. 白名單：URL、郵箱、檔案路徑、程式碼、版本號、千分位逗號、小數點、化學式 → 保留半形。

必掃的十類錯誤（必須全部為零）

完整規則、對照表、自動檢查正則、白名單參見 references/punctuation_GB_T_15834-2011.md。執行任何排版任務之前，須先閱讀該參考文件。

自動修復策略

• format_word.py 預設啟用 fix_chinese_punctuation。執行後自動修正絕對安全的半形→全形問題。
• 存在歧義的修正（如單個 EM dash、句中半形句號或為版本號片段）僅在 audit_word.py 報告中列出，交由人工研判。
• 如需關閉自動修正：python format_word.py input.docx --no-fix-punctuation

三種工作模式

根據使用者需求選擇合適的模式：

模式一：自動排版（最常用）

使用者已有一份Word文件，需要按博維標準統一格式。

執行步驟：

1. 先閱讀 references/punctuation_GB_T_15834-2011.md——充分掌握標點規則，方能準確解讀 audit 報告
2. 確認使用者檔案路徑，使用 python-docx 讀取檔案基本資訊（頁數、段落數、當前格式）
3. 詢問使用者關鍵引數（若無法從文件自動推斷）：
   • 是否有封面頁？
   • 是否需要目錄？
   • 頁首左側文字（報告名稱）和右側文字（編制單位）？
   • 提交物件是國企/政府還是民企？（影響嚴格程度）
4. 執行自動排版指令碼（預設修正標點）：

   python scripts/format_word.py input.docx output.docx \
    --cover --toc --page-num-style dash \
    --header-left "報告名稱" --header-right "博維管理諮詢"

5. 執行審查指令碼確認是否仍有遺漏，重點關注 P1–P20 標點項：

   python scripts/audit_word.py output.docx --strict

6. 依據審查結果，使用 python-docx 手動修復指令碼無法自動處理的問題（尤其是 audit 標記為 INFO 但需人工研判的標點項）
7. 將最終檔案交付使用者

模式二：排版審查

使用者希望檢驗現有文件是否符合博維排版標準，但不一定執行自動修改。

執行步驟：

1. 執行審查指令碼：

   python scripts/audit_word.py input.docx --strict -o report.json

2. 將審查結果整理為結構化問題清單，按嚴重程度排序
3. 向用戶呈現清單，說明各問題的位置、成因及修改建議

   7w4.net收錄了海量優質技能外掛。

4. 標點項須分級處理：ERROR 級（中文上下文半形標點、尖括號冒充書名號等）必須全部清零；WARNING 級交由使用者研判；INFO 級僅作提示
5. 若使用者需要自動修復，切換至模式一

模式三：新建報告

從零建立一份符合博維標準的Word報告。

執行步驟：

1. 使用 python-docx 建立新文件
2. 撰寫過程中主動按 GB/T 15834 採用全形標點——此為源頭治理，較事後批次替換更為可靠
3. 依據下文"排版標準速查表"中的所有規則設定格式
4. 執行審查指令碼，驗證格式與標點的合規性

排版標準速查表

以下是V2.6標準的完整規則，按類別組織。指令碼中的常量與這些值一一對應。

一、頁面設定

二、字型字號

三、行距與段距

四、標題層級序號

第一層: 一、  二、  三、 ……
第二層: （一）（二）（三）……
第三層: 1.   2.   3.  ……  （注意是下角點，不是頓號！）
第四層: （1）（2）（3）……
第五層: ①   ②   ③  ……
第六層: A.   B.   C.  ……
第七層: a.   b.   c.  ……

關鍵規則：

• 一二級標題獨佔行，末尾不加標點
• 三級及以下可根據長短決定是否獨佔行；若獨佔行則末尾不加標點，否則標題後必須加句號
• 阿拉伯數字後用下角點（.），不用頓號（、）—— 這是國標硬性規定
• 帶括號的序號不加點號
• 提交甲方報告不使用理工科論文編碼法（如"1.2.1"）

v2.7.3 標題排版強規則（必須遵守）：

• 一級標題首行縮排2字元（與正文一致，0.85cm），不是0或不縮排
• 二級標題首行縮排2字元（與正文一致，0.85cm），不是0或不縮排
• 一級標題必須設定大綱級別為0（outlineLvl val="0"），以便Word自動生成目錄時識別
• 二級標題必須設定大綱級別為1（outlineLvl val="1"），以便Word自動生成目錄時識別
• 一級和二級標題字型顏色必須為黑色（w:color val="000000"），不能是藍色、主題色或其他顏色

v2.7.4 分頁規則（必須遵守）——只在以下位置強制另起頁，其他地方一律不強制分頁：

1. 封面結束後：封面最後一頁之後，目錄或正文必須另起一頁
2. 目錄結束後：目錄之後的正文必須另起一頁
3. 每個一級標題另起頁：所有一級標題（"一、""二、""三、"……）都設定 page_break_before = True
4. 每個附件標題另起頁：附件1、附件2……每個附件另起一頁（page_break_before = True）
5. 其他地方不強制分頁：二級標題、三級標題、正文段落、圖表標題等一律 page_break_before = False 或 None
6. 寬表格預設不橫向分節：檢測到寬表格時，預設保留縱向頁面並自動適應頁面寬度；只有使用者明確要求橫排/橫向頁時，才使用 --landscape-wide-tables

五、頁碼

• 格式：— X —（一字線，5號半形宋體阿拉伯數字）
• 位置：版心下邊緣之下7mm
• 奇數頁居右空一字，偶數頁居左空一字（需勾選"奇偶頁不同"）
• 封面不編頁碼、不計入頁碼數
• 附件與正文連續編排頁碼

六、頁首

• 左側：報告名稱，楷體五號加黑
• 右側：編制單位名稱，黑體小五
• 細橫線與正文分隔

七、目錄

• "目錄"二字：黑體二號加粗，居中
• 一級：黑體四號加粗，行距1.5倍，段後6磅
• 二級：楷體小四加黑，行距1.5倍
• 三級：黑體五號，行距1.25倍
• v2.7.3 目錄排版強規則（必須遵守）：
  • 目錄內容不能留空——必須有實際的條目內容
  • 預設顯示到二級目錄（一級標題+二級標題）
  • 每條目錄條目包含：標題文本 + 前導點製表位 + 頁碼域
  • 條目格式嚴格遵循上方字型字號表（一級黑體四號加粗，二級楷體小四加黑）
  • 條目首行縮排2字元
  • 開啟Word後右鍵目錄 → "更新域" → "更新整個目錄"，可獲取準確頁碼
• 建議使用Word自定義目錄功能，通過"引用→目錄→自定義目錄→修改"設定格式

八、封面

• 標題：小標宋一號，加粗
• 說明文字（如"討論稿""徵求意見稿"）：四號楷體，不加粗，括號內
• 副標題/說明文字（標題與署名之間的所有非空段落）：楷體四號，居中（v2.7.2 改進：不再要求以括號開頭）
• 落款：楷體四號，不加粗，居中，位於頁面底部（v2.7.2 改進：space_before 動態計算，避免副標題較多時落款溢位第二頁）
• 日期：阿拉伯數字，具體到月份（如"2024年6月"）；漢字格式用"〇"不用"零"
• 不加頁碼，不計入頁碼數

九、表格

• 預設三線表：頂線和底線較粗，欄目線稍細
• 行數較多時可以每行加細邊框
• 表標題標註在表正上方，keep_with_next確保不跨頁分離
• 橫排表格頁碼位置與正文一致

十、圖例

• 序號按全文出現順序編號（如"圖3"）
• 標題在圖正下方，不與圖分跨兩頁
• 圖、表說明文字末尾不使用句號

十一、附件

• "附件"二字在正文下空一行左空二字，後標全形冒號
• 多個附件用阿拉伯數字標註順序號
• 附件名稱後不加標點
• 附件另面編排，"附件"二字及順序號用黑體頂格排在版心左上角
• v2.7.3 新增：附件標題自動設定 page_break_before = True 強制另起頁，黑體加粗，頂格不縮排，大綱級別0

十二、署名和日期

• 在正文（或附件說明）下空一行右空二字編排
• 日期在署名下一行，首字比署名首字右移二字
• 日期用阿拉伯數字標全，月日不編虛位（1不編為01）

十三、標點符號（v2.7 新增，對應國標 GB/T 15834—2011）

詳見 references/punctuation_GB_T_15834-2011.md。要點：

• 純中文上下文一律用全形標點
• ASCII 直引號 → 彎引號
• 半形括號包中文 → 全形括號
• 尖括號引法律法規 → 書名號
• -- 或單 EM dash → ——（兩個 EM dash 連用）
• ... 或單 … → ……
• 數值範圍用 ～，不用 - 或 —
• 多個書名號、引號並列不加頓號
• 三級標題序號用下角點 1.，不用頓號 1、
• 圖表標題末尾不加句號
• 標題獨佔行末尾不加標點

指令碼使用說明

format_word.py — 自動排版

pip install python-docx lxml

# 基礎用法（預設開啟標點修正）
python scripts/format_word.py input.docx

# 完整引數
python scripts/format_word.py input.docx output.docx \
  --mode full \
  --cover \
  --toc \
  --page-num-style dash \
  --header-left "XX公司十五五發展戰略規劃" \
  --header-right "博維管理諮詢"

# 關閉標點修正（甲方明確要求保留半形時）
python scripts/format_word.py input.docx --no-fix-punctuation

# 僅在明確需要橫向頁承載寬表格時啟用
python scripts/format_word.py input.docx output.docx --landscape-wide-tables

引數說明：

• --mode full|light：full=完整排版（預設），light=僅修正字型字號行距
• --cover：標記第一頁為封面（不加頁碼）
• --toc：標記有目錄（單獨處理目錄格式）
• --page-num-style dash|plain：頁碼樣式
• --header-left：頁首左側文本
• --header-right：頁首右側文本
• --no-fix-punctuation：v2.7 新增，關閉中文標點自動修正
• --landscape-wide-tables：v2.7.4 新增，將檢測到的寬表格強制切換為橫向頁；預設不啟用，避免表標題與表格被分到不同頁面

audit_word.py — 排版審查

# 基礎審查
python scripts/audit_word.py input.docx

# 嚴格模式 + JSON輸出
python scripts/audit_word.py input.docx --strict -o report.json

# 只看標點問題
python scripts/audit_word.py input.docx --only-punctuation

審查項包括：

• 頁面尺寸和頁邊距
• 各級標題字型、字號、加粗
• 標題層級跳躍
• 標題末尾標點
• 標題首行縮排
• 正文字型
• 空格冒充首行縮排
• 行距
• 表格/圖例序號連續性
• 封面 / 目錄 / 正文分頁邊界
• 表標題與表格是否緊鄰、表標題是否設定與下段同頁
• 標點符號 P1–P20（v2.7 重寫，對應國標 GB/T 15834—2011）
• 數字格式（年份縮寫、百分比範圍）
• 三級標題序號頓號誤用

指令碼無法自動處理的事項（需人工額外檢查）

以下事項需要在指令碼執行後，由人工額外檢查：

1. 每頁最後一行不出現標題：指令碼設定了keep_with_next，但無法精確判斷分頁位置
2. 表格跨頁時第二頁重複表頭：python-docx支援有限，需手動處理
3. 封面的精確排版：封面佈局因報告而異，指令碼僅設定字型字號。v2.7.2 改進了封面落款間距計算，但複雜封面仍需人工微調
4. 目錄頁碼準確性：指令碼自動插入目錄條目，但頁碼為佔位值。需在Word中右鍵目錄 → "更新域" → "更新整個目錄"以獲取準確頁碼
5. 圖片的精確尺寸和位置：取決於具體內容
6. 附件說明的精確位置：取決於正文結構
7. 橫排表格的頁碼方向：僅在顯式使用 --landscape-wide-tables 時需要在 Word 中手動複核；預設縱向排版不自動橫排
8. 標點中需要人工判斷的項：單個 EM dash 是否為表內分隔符；句中半形句號是否為版本號縮寫；引號內點號位置（獨立成句 vs 句中成分）

與其他技能的協作

• stop-slop-zh：若報告文字存在 AI 痕跡，先採用 stop-slop-zh 去除 AI 文風，再以本技能排版（說明：本技能 v2.7 已涵蓋標點層面的去 AI 化，stop-slop-zh 負責的是句式與措辭層面）

常見問題處理

Q: 甲方另有特定排版要求時如何處理？ A: 以甲方要求為準。可調整 format_word.py 中的常量值以適配。

Q: 字型在本機顯示異常如何處理？ A: 須確認仿宋、楷體、黑體、方正小標宋簡體等字型已安裝。仿宋_GB2312 與方正小標宋建議安裝 GBK 版。

Q: 為何部分標題未被正確識別？ A: 指令碼通過正則匹配標題編號（如"一、""（一）""1."）識別層級。非標準編號格式須手動處理。

Q: 提交國企或政府的報告有何特殊要求？ A: 須更嚴格遵循《黨政機關公文格式》（GB/T 9704—2012），包括正文采用 3 號仿宋體、每面 22 行 28 字、頁碼採用一字線格式等。可通過調整常量進行適配。

Q: 自動標點修正是否會破壞程式碼塊或 URL？ A: 不會。fix_chinese_punctuation 內建白名單，自動跳過 URL、郵箱、檔案路徑、千分位、小數點、版本號等。若文件中含有不規則的程式碼片段或英文引用，建議先執行 audit_word.py 檢視具體的預期修改範圍，再決定是否啟用 --no-fix-punctuation。

Q: 為何 audit 報告中 P12（單 EM dash）僅標記為 INFO？ A: 單個 — 在表內、目錄、數值範圍連線符等場合可能為合法用法（如 "2024 年 1 月—2024 年 12 月"），機械化判斷容易誤傷。本規則僅在正文中文上下文中可能誤用時給出提示，由人工根據語義研判是否調整為 ——。

版本歷史

• v2.7.4（2026-06）：WorkBuddy 相容補丁——封面推斷遇到"目錄/目 錄"即停止，避免目錄被誤納入封面；已有目錄標題強制另起頁；寬表格預設保留縱向頁面並自動適應寬度，僅在顯式 --landscape-wide-tables 時啟用橫向分節；表標題識別擴充套件到"表1-XXX / 表1：XXX / 表 1—XXX"；audit 新增封面/目錄/正文分頁邊界與表標題繫結檢查
• v2.7.3（2026-06）：分頁規則重構——只在4個位置強制另起頁（封面結束後、目錄結束後、每個一級標題、每個附件標題），其他地方一律不強制分頁；一級和二級標題首行縮排2字元、賦予大綱級別（0/1）以便生成目錄、字型強制黑色（RGB 000000）避免藍色；目錄條目自動插入——--toc 時不再留空，自動生成一級和二級目錄條目（含前導點+頁碼域），開啟Word後右鍵更新域即可獲取準確頁碼；附件標題識別與格式化（黑體加粗、頂格、大綱級別0、另起頁）
• v2.7.2（2026-06）：封面副標題識別改進（不再要求括號開頭，標題與署名間所有非空段落均居中）；落款 space_before 動態計算（避免副標題較多時溢位第二頁）；機構/日期識別更精確（含冒號段落排除、機構字尾連用匹配）
• v2.7（2026-05）：新增國標 GB/T 15834—2011 標點規則強約束；audit 增加 P1–P20 標點檢測；format 預設開啟 fix_chinese_punctuation
• v2.6（2025-09）：博維 Word 排版標準 V2.6 基礎版

這是一個專注於中文 Word 報告排版的工具類 Skill，遵循嚴格的博維公司排版標準和國標標點規範。優點是文件完善、規則清晰，能自動處理常見的"AI 味"標點問題；三種工作模式基本覆蓋日常需求。缺點是當前已被停用，且適用範圍僅限於特定公司的排版標準，通用性不足，需要手動安裝額外依賴才能使用。