文件格式刷
📖 技能介紹
name: doc-format-brush description: 文件格式刷 skill。當用戶需要將某個文件的格式調整成與另一個模板文件完全一致時使用，支援任意格式文件（Word、Markdown、純文本）的格式整理。包括字型、字號、對齊方式、首行縮排、行距、段前段後間距、頁邊距等。更支援智慧識別標題層級（標題、一級標題、二級標題、正文），應用不同格式。支援內建公文格式（GB/T 9704-2012）。觸發場景：使用者說"格式對齊到模板"、"參照某檔案的格式"、"格式刷"、"格式和XXX文件一樣"、"把文件改成公文格式"、"使用公文格式"、"把Markdown轉成Word格式"等。
文件格式刷 (Doc Format Brush)
概述
本 skill 提供多格式文件格式整理功能：提取模板文件的格式 → 應用到任意格式的目標文件。
核心功能
- 多格式支援：輸入/輸出支援 Word(.docx)、Markdown(.md)、純文本(.txt)
- 智慧標題層級識別：自動識別標題、一級標題（"一、"）、二級標題（"（一）"）、正文
- 格式精確複製：字型、字號、加粗、對齊、首行縮排（字元級）、段前間距、段後間距、行間距、頁邊距
- 內建公文格式：支援一鍵應用 GB/T 9704-2012 國家標準公文格式
使用方式
方式一：使用內建公文格式（推薦）
當用戶需要將文件調整為標準公文格式時：
python apply_multi_format.py <輸入文件> --official --output <輸出文件>
支援的輸入格式：.docx, .md, .txt 支援的輸出格式：.docx, .md, .txt
示例：
# Markdown 轉 Word 公文格式
python apply_multi_format.py 報告.md --official --output 報告_公文.docx
# 純文本轉 Markdown
python apply_multi_format.py 筆記.txt --official --output 筆記.md
# Word 轉為 Word（使用公文格式）
python apply_multi_format.py 財務報告.docx --official --output 財務報告_公文格式.docx
方式二：參照模板文件
當用戶提供了特定的模板文件時：
從模板提取格式後應用到目標：
python apply_multi_format.py <目標文件> <模板.docx> --output <輸出文件>
示例：
# 參照 Word 模板，調整 Markdown 檔案
python apply_multi_format.py 報告.md 模板.docx --output 報告_新格式.docx
# 參照模板，轉換 Word 到 Word
python apply_multi_format.py 原始檔.docx 模板.docx --output 目標檔案.docx
方式三：使用格式描述檔案
可以先提取模板格式為 JSON，然後複用：
# 提取格式
python extract_format.py 模板.docx --output 格式.json
# 應用格式
python apply_multi_format.py 輸入.md --format-json 格式.json --輸出 輸出.docx
內建公文格式規範（GB/T 9704-2012）
| 段落型別 | 字型 | 字號 | 對齊 | 縮排 | 段前 | 段後 | 行距 |
|---|---|---|---|---|---|---|---|
| 標題 | 方正小標宋體 | 22pt（二號） | 居中 | 0 | 0pt | 0pt | 1.5倍 |
| 文號 | 仿宋_GB2312 | 16pt（三號） | 居中 | 0 | 0pt | 0pt | 1.5倍 |
| 一級標題 | 黑體 | 16pt（三號） | 左對齊 | 0 | 0pt | 0pt | 1.5倍 |
| 二級標題 | 楷體_GB2312 | 16pt（三號） | 左對齊 | 0 | 0pt | 0pt | 1.5倍 |
| 正文 | 仿宋_GB2312 | 16pt（三號） | 兩端對齊 | 2字元 | 0pt | 0pt | 1.5倍 |
頁面設定： - 紙張：A4（21cm × 29.7cm） - 頁邊距：上 3.7cm，下 3.5cm，左 2.8cm，右 2.6cm
標題層級識別規則
Word/文本識別規則
| 型別 | 識別規則 | 示例 |
|---|---|---|
| 標題 | 第一個非空段落 | 關於xxx的請示 |
| 文號 | 第二個段落，符合公文號格式 | X發〔2024〕10號 |
| 一級標題 | 以"一、"、"二、"等開頭 | 一、基本情況 |
| 二級標題 | 以"（一）"、"（二）"等開頭 | （一）主要業績 |
| 正文 | 其他段落 | 正文內容... |
Markdown 識別規則
| Markdown 標記 | 對應層級 |
|---|---|
| # Title | 標題 |
| ## Heading | 一級標題 |
| ### Subheading | 二級標題 |
| - List item | 正文（列表項） |
| 普通文本 | 正文 |
格式轉換矩陣
小蔥技能7w4.net持續更新中。
| 輸入格式 | 支援的輸出格式 | 說明 |
|---|---|---|
| .docx | .docx, .md, .txt | 保留格式資訊 |
| .md | .docx, .md, .txt | 識別標題層級 |
| .txt | .docx, .md, .txt | 智慧識別標題 |
指令碼位置
本 skill 包含以下指令碼：
| 指令碼 | 功能 |
|---|---|
extract_format.py |
從 Word 模板提取格式 → 輸出 JSON |
apply_format.py |
應用格式到 Word 文件 |
apply_multi_format.py |
【推薦】多格式統一處理入口 |
format_bridge.py |
多格式文件讀寫核心庫 |
指令碼目錄：C:\Users\14032\.codebuddy\skills\doc-format-brush\scripts\
常見錯誤與修正
| 錯誤現象 | 原因 | 修正方式 |
|---|---|---|
| 首行縮排顯示為釐米而非字元 | 使用了 Cm() 而非 XML 屬性 |
使用 w:firstLineChars 設定字元數 |
| 段後間距仍有 10pt | Word Normal 樣式預設值未覆蓋 | 強制 pf.space_after = Pt(0) |
| 對齊方式為左對齊而非兩端對齊 | 未正確設定 JUSTIFY | 使用 WD_ALIGN_PARAGRAPH.JUSTIFY |
| 中文字型未變化 | 只設了 font.name |
同時設定 w:eastAsia 屬性 |
| 檔案儲存報 PermissionError | 目標檔案在 Word 中開啟 | 換一個新檔名儲存 |
典型對話示例
使用者 A： "把這份 Markdown 報告改成公文格式 Word"
AI： 使用內建公文格式處理 Markdown：
python apply_multi_format.py 報告.md --official --output 報告_公文格式.docx
使用者 B： "參照這個 Word 模板，調整我的筆記檔案"
AI： 參照模板格式處理：
python apply_multi_format.py 我的筆記.md 模板.docx --output 筆記_整理.docx
使用者 C： "把這個文本檔案轉成帶格式的 Markdown"
AI： 使用內建格式輸出 Markdown：
python apply_multi_format.py 原始筆記.txt --official --output 格式化筆記.md
🤖 AI 評測
這是一個功能明確、文件詳盡的文件格式整理工具，支援多種格式互轉和標準公文格式一鍵應用。主要優點是使用簡單、格式規則清晰；不足之處是文件中有少量錯誤，且沒有提供實際示例檔案，使用者難以直接驗證效果。整體質量中上，適合有文件格式整理需求的使用者使用。
