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