Document Format Skills

📄 document-format-skills 公文格式助手

**[中文版本 README / Chinese Version](./README_CN.md)**

看不懂英文也没关系，请点击上面的链接查看中文版说明。

💡 **想要无需联网、一键运行修复格式的桌面应用版本？**

现已推出 **[Document Format GUI 公文格式助手](https://github.com/KaguraNanaga/docformat-gui)** —— 无需联网、一键修复公文格式的桌面应用，小白也能轻松上手！

🌐 **不想安装，也不需要 Agent？**

直接打开 **[公文格式处理工具网页版](https://web.gongwengeshizhushou.com)**，选择 `.docx` 文档即可开始处理。无需登录，文档只在当前浏览器中处理，不会上传到服务器。

A Word document formatting toolkit for Chinese official documents for the government, CCP (China Communist Party), and the state-owned enterprises. Diagnose formatting issues, fix punctuation, and apply standardized styles with one command. Available for Claude Code, Codex, and OpenCode.

公文格式助手是一个面向中文公文排版的 Skill 工具包，用于诊断 Word 文档格式问题、修复中英文标点和空格混用、统一公文/论文/法律文书格式、处理页码和表格，并支持从纯文本或 Markdown 生成规范 DOCX。

Features

• 中文用户如果不熟悉命令行，可以优先使用 Document Format GUI 公文格式助手：无需联网、一键修复公文格式。
• Smart one-shot processing: punctuation/spacing cleanup plus formatting.
• Format diagnosis for punctuation, numbering, paragraph, and font issues.
• Official, academic, legal, and custom presets.
• GB/T 9704-2012 style page margins, fonts, line spacing, headings, signatures, dates, and page numbers.
• Safer page-number handling with styles, positions, offsets, replacement control, and non-page footer protection.
• Table normalization with optional smart alignment.
• Custom settings compatible with the desktop app schema v2 and exported preset JSON.
• Word revision marks for supported formatting changes.
• macOS font fallback for common Chinese official-document fonts.
• .doc / .wps conversion on Windows when WPS Office or Microsoft Word is installed.
• Plain text or Markdown to formatted DOCX.

Requirements

• Python 3.8+
• python-docx
• pywin32 only for .doc/.wps conversion on Windows

Use `uv` for ad-hoc runs:

uv run --with python-docx python scripts/process.py --help

For Windows `.doc/.wps` conversion: