📄 document-format-skills 公文格式助手
中文版本 README / Chinese Version
看不懂英文也没关系，请点击上面的链接查看中文版说明。
💡 想要无需联网、一键运行修复格式的桌面应用版本？
现已推出 Document Format GUI 公文格式助手 —— 无需联网、一键修复公文格式的桌面应用，小白也能轻松上手！
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-docxpywin32 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:
uv run --with python-docx --with pywin32 python scripts/process.py --help
Quick Start
Smart cleanup:
uv run --with python-docx python scripts/process.py smart input.docx output.docx --preset official
Analyze only:
uv run --with python-docx python scripts/process.py analyze input.docx
uv run --with python-docx python scripts/process.py analyze input.docx --json
Punctuation and spacing only:
uv run --with python-docx python scripts/process.py punctuation input.docx output.docx --space-mode keep_en_boundary
Formatting only:
uv run --with python-docx python scripts/process.py format input.docx output.docx --preset official
Create a formatted DOCX from Markdown or text:
uv run --with python-docx python scripts/from_text.py input.md output.docx --title "Work Plan"
Useful Options
--preset official|academic|legal|custom
--custom-settings path.json
--revision
--deep-clean
--smart-table-align
--no-page-number
--page-number-style dash|plain|page_text|page_total
--page-number-position outside|left|center|right
--space-mode remove_all|keep_en_boundary|keep_all
--custom-settings accepts desktop schema v2 config files, exported preset files like {"preset": {...}}, or plain preset/override JSON.
Scripts
| Script | Purpose |
|---|
scripts/process.py | Main CLI pipeline: smart, analyze, punctuation, format. |
scripts/formatter.py | Formatting engine and preset handling. |
scripts/punctuation.py | Punctuation and spacing fixer. |
scripts/from_text.py | Text/Markdown to DOCX generator. |
scripts/analyzer.py | Diagnostic helpers. |
scripts/converter.py | Windows .doc/.wps conversion helpers. |
Notes
.docx is the most reliable format..doc/.wps requires Windows plus WPS Office or Microsoft Word.- Keep a backup of important documents before running automated formatting.
License
MIT
