Word文档排版

SKILL.md 节选

# 博维咨询 Word 报告自动排版技能 v2.7.4

依据《博维咨询Word版报告行文排版标准 V2.6-20250920》+ 国标《GB/T 15834—2011 标点符号用法》。

> **前置依赖**: 使用本技能前，需确保已安装 python-docx 和 lxml：
> ```bash
> pip install python-docx lxml
> ```
> 本技能中的脚本位于 `scripts/` 目录下，引用参考文档位于 `references/` 目录下。

---

## 强规则（一票否决，不达标不得交付）

**标点符号必须符合 GB/T 15834—2011 国标**。AI 生成的中文 Word 文档中最常见、亦最难凭肉眼察觉的错误，即"形似中文实为半角"的标点。此项为所有排版交付前**第一项必须扫描**的硬性指标。

### 三大判定原则

1. **纯中文上下文里，所有标点必须全角。**
2. **判断方法**：标点前后两侧任一为中文字符，则该标点必须全角。
3. **白名单**：URL、邮箱、文件路径、代码、版本号、千分位逗号、小数点、化学式 → 保留半角。

### 必扫的十类错误（必须全部为零）

| 错误模式 | 正确写法 | audit 编号 |
|---|---|---|
| `公司,跨境电商,物流.` | `公司、跨境电商、物流。` | P1, P2 |
| `"做强做优"` (ASCII 直引号) | `"做强做优"` (弯引号) | P7 |
| `年均增长(CAGR)` (半角括号) | `年均增长（CAGR）` | P9 |
| `<公司法>` (尖括号冒充书名号) | `《公司法》` | P10 |
| `供应链能力--博维核心` (双连字符) | `供应链能力——博维核心` | P11 |
| `供应链能力—博维核心` (单 EM dash) | `供应链能力——博维核心` | P12 |
| `物流仓储...` (三点) | `物流仓储……` | P13 |
| `年增长 15-30%` | `年增长 15%～30%` | P15, P20 |
| `《公司法》、《证券法》` (书名号间顿号) | `《公司法》《证券法》` | P17 |
| `1、推动产业链协同` (三级标题用顿号) | `1.推动产业链协同` | P19 |

完整规则、对照表、自动检查正则、白名单参见 [`references/punctuation_GB_T_15834-2011.md`](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. 执行自动排版脚本（默认修正标点）：
   ```bash
   python scripts/format_word.py input.docx output.docx \
     --cover --toc --page-num-style dash \
     --header-left "报告名称" --header-right "博维管理咨询"
   ```
5. 执行审查脚本确认是否仍有遗漏，**重点关注 P1–P20 标点项**：
   ```bash
   python scripts/audit_word.py output.docx --strict
   ```
6. 依据审查结果，使用 python-docx 手动修复脚本无法自动处理的问题（尤其是 audit 标记为 INFO 但需人工研判的标点项）
7. 将最终文件交付用户

### 模式二：排版审查

用户希望检验现有文档是否符合博维排版标准，但不一定执行自动修改。

**执行步骤：**

1. 执行审查脚本：
   ```bash

SKILL.md 不止这些内容，安装后可阅读全文。

技能包内容

共 7 个文件，合计 158.7 KiB