文档格式刷
📖 技能介绍
name: doc-format-brush description: 文档格式刷 skill。当用户需要将某个文档的格式调整成与另一个模板文档完全一致时使用，支持任意格式文档（Word、Markdown、纯文本）的格式整理。包括字体、字号、对齐方式、首行缩进、行距、段前段后间距、页边距等。更支持智能识别标题层级（标题、一级标题、二级标题、正文），应用不同格式。支持内置公文格式（GB/T 9704-2012）。触发场景：用户说"格式对齐到模板"、"参照某文件的格式"、"格式刷"、"格式和XXX文档一样"、"把文档改成公文格式"、"使用公文格式"、"把Markdown转成Word格式"等。
文档格式刷 (Doc Format Brush)
概述
本 skill 提供多格式文档格式整理功能：提取模板文档的格式 → 应用到任意格式的目标文档。
核心功能
- 多格式支持：输入/输出支持 Word(.docx)、Markdown(.md)、纯文本(.txt)
- 智能标题层级识别：自动识别标题、一级标题（"一、"）、二级标题（"（一）"）、正文
小葱技能有更好的技能skills插件。
- 格式精确复制：字体、字号、加粗、对齐、首行缩进（字符级）、段前间距、段后间距、行间距、页边距
- 内置公文格式：支持一键应用 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 | 正文（列表项） |
| 普通文本 | 正文 |
格式转换矩阵
| 输入格式 | 支持的输出格式 | 说明 |
|---|---|---|
| .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 评测
这是一个功能明确、文档详尽的文档格式整理工具，支持多种格式互转和标准公文格式一键应用。主要优点是使用简单、格式规则清晰；不足之处是文档中有少量错误，且没有提供实际示例文件，用户难以直接验证效果。整体质量中上，适合有文档格式整理需求的用户使用。
