doc-format

Installation
SKILL.md

doc-format — 公文格式排版工具

使用 scripts/wfp_cli.py 将文档按公文排版规则格式化为标准 .docx。原始文件不原地修改,Word/WPS 类文档会先复制或转换到临时副本,再执行排版。

核心能力

  • 支持 .docx.doc.wps.txt.md
  • 支持单文件、多文件、重复 -i、位置参数输入,以及一个或多个目录;目录输入默认递归扫描,输出目录保留原结构。
  • 自动识别题目、副标题、四级标题、二级标题段内正文、图/表标题、附件标识。
  • 可选表格内容自动调整、数字和字母单独字体、符号标准化。
  • TXT/MD 支持三种空行模式:不改动任何空行;删除单个空行,多个空行保留至 1 个空行;保留单个空行,多个空行保留至 1 个空行。
  • 支持自动读取当前目录 wfp_config.json、指定 JSON 配置文件、内联 JSON、--set key=value 和便利开关覆盖配置。

使用前检查

  1. 确认脚本路径:脚本位于本 Skill 目录下的 scripts/wfp_cli.py。如果当前工作目录不是 Skill 目录,使用 SKILL.md 所在目录推导脚本绝对路径,或先 cd 到 Skill 目录。
  2. 检查输入:如果用户没有给出文件或目录,请先要求提供输入路径;告知支持 .docx/.doc/.wps/.txt/.md,目录默认递归处理。
  3. 检查配置:CLI 会自动读取当前工作目录的 wfp_config.json。如果用户指定 --config 或明确给出配置文件,使用用户指定配置;否则说明将使用当前目录配置或内置默认配置。
  4. 检查转换条件:Windows 处理 .doc/.wps 时优先使用 WPS/Word 和 pywin32;macOS/Linux 或 COM 不可用时,CLI 会尝试调用 LibreOffice soffice 转为 .docx。如果转换失败,再提示用户安装 LibreOffice、用 --soffice 指定路径,或先另存为 .docx
Installs
10
GitHub Stars
286
First Seen
14 days ago