智能判断逻辑

1. 中文环境：前后都是中文字符 → 用中文标点
2. 英文环境：前后都是英文/数字 → 用英文标点
3. 混合环境：默认用中文标点（可配置）

特殊处理

• 数字与单位之间：100% 保持英文
• 英文缩写：e.g. i.e. 保持英文句点
• 网址邮箱：保持原样不处理
• 代码块：跳过不处理

格式预设

公文格式（GB/T 9704-2012）

页面：A4，上边距37mm，下边距35mm，左边距28mm，右边距26mm
标题：方正小标宋简体，二号（22pt），居中
一级标题：黑体，三号（16pt），顶格，"一、"
二级标题：楷体_GB2312，三号（16pt），顶格，"（一）"
三级标题：仿宋_GB2312，三号（16pt），首行缩进，"1."
正文：仿宋_GB2312，三号（16pt），首行缩进2字符，行距固定值28pt

学术论文格式

页面：A4，边距25mm
标题：黑体，小二（18pt），居中
一级标题：黑体，小三（15pt），"1"
二级标题：黑体，四号（14pt），"1.1"
正文：宋体/Times New Roman，小四（12pt），首行缩进2字符，行距1.5倍

法律文书格式

页面：A4，上边距30mm，下边距25mm，左边距30mm，右边距25mm
标题：宋体加粗，二号（22pt），居中
条款标题：黑体，四号（14pt），"第一条"
正文：宋体，四号（14pt），首行缩进2字符，行距1.5倍

文件结构

document-format-skills/
├── SKILL.md
├── README.md
├── scripts/
│   ├── analyzer.py      # 格式诊断
│   ├── punctuation.py   # 标点修复
│   └── formatter.py     # 格式统一
└── presets/
    ├── official.yaml    # 公文格式
    ├── academic.yaml    # 学术论文
    └── legal.yaml       # 法律文书

依赖

• python-docx

使用 uv run --with python-docx 自动安装。

注意事项

1. 只支持 .docx：不支持旧版 .doc 格式
2. 备份原文件：修改前建议备份
3. 字体依赖：输出文件需要系统安装对应字体才能正确显示
4. 表格内容：会自动处理表格内的文字

# Official document format (GB/T 9704-2012)
uv run --with python-docx python scripts/formatter.py input.docx output.docx --preset official

# Academic paper format
uv run --with python-docx python scripts/formatter.py input.docx output.docx --preset academic

# Legal document format
uv run --with python-docx python scripts/formatter.py input.docx output.docx --preset legal

📋 What It Fixes

Punctuation Issues

The toolkit intelligently converts punctuation based on context:

| Type | Incorrect | Chinese | English | |------|-----------|---------|---------| | Parentheses | Mixed usage | （） | () | | Quotes | Straight " | "" '' | "" '' | | Colon | Mixed usage | ： | : | | Comma | Mixed usage | ， | , | | Period | Mixed usage | 。 | . | | Semicolon | Mixed usage | ； | ; | | Ellipsis | ... | …… | ... | | Dash | -- | —— | -- |

Format Issues

• Paragraph indentation — Detects missing first-line indents
• Line spacing — Identifies inconsistent spacing
• Font usage — Flags mixed fonts and sizes
• Numbering — Catches inconsistent numbering styles (e.g., mixing 1. with 1、)

📐 Formatting Presets

Official Document (GB/T 9704-2012)

Chinese government document standard:

• Page: A4, margins: top 37mm, bottom 35mm, left 28mm, right 26mm
• Title: FangZheng XiaoBiaoSong, 22pt, centered
• Body: FangSong_GB2312, 16pt, 2-character indent, 28pt line spacing
• Headings: Structured with 一、/ （一）/ 1. / （1）

Academic Paper

Standard academic formatting:

• Page: A4, 25mm margins
• Title: SimHei, 18pt, bold, centered
• Body: SimSun/Times New Roman, 12pt, 1.5x line spacing

Legal Document

Legal document formatting:

• Page: A4, margins: top 30mm, bottom 25mm, left 30mm, right 25mm
• Title: SimSun bold, 22pt, centered
• Body: SimSun, 14pt, 1.5x line spacing

📁 Project Structure

document-format-skills/
├── README.md           # English documentation
├── README_CN.md        # Chinese documentation
├── SKILL.md            # Skill definition file
└── scripts/
    ├── analyzer.py     # Format diagnostics
    ├── punctuation.py  # Punctuation fixer
    └── formatter.py    # Style formatter

🔧 Dependencies

• python-docx

Automatically installed when using uv run --with python-docx.

⚠️ Notes

1. Only supports .docx — Legacy .doc format is not supported
2. Backup your files — Always keep a backup before processing
3. Font requirements — Output files require corresponding fonts installed on the system to display correctly
4. Table content — Text within tables is also processed

📄 License

MIT License

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.