文档格式处理工具。支持格式诊断、标点符号修复、格式统一。输入杂乱的文档,输出规范整洁的docx。
文档格式处理工具是一项面向实际任务的技能,主要用于处理文档格式问题:诊断格式错误、修复标点符号、统一文档样式;分析文档存在的格式问题;
应用预设格式规范;formatter.py;分析文档存在的问题,输出诊断报告:;输出示例:;标点符号修复;标点符号处理规则;正确(中文);
正确(英文);直引号 ""。它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。
处理文档格式问题:诊断格式错误、修复标点符号、统一文档样式。
| 功能 | 说明 | 脚本 |
|---|---|---|
| 格式诊断 | 分析文档存在的格式问题 | analyzer.py |
| 标点修复 | 修复中英文标点混用 | punctuation.py |
| 格式统一 | 应用预设格式规范 | formatter.py |
分析文档存在的问题,输出诊断报告:
uv run --with python-docx python3 scripts/analyzer.py input.docx
输出示例:
=== 格式诊断报告 === 【标点问题】共 5 处 - 第2段: 英文括号 () 建议改为 () - 第3段: 英文引号 "" 建议改为 "" 【序号问题】共 2 处 - 序号格式不统一: 同时存在 "1、" 和 "1." - 第5段: 层级跳跃,从 "一、" 直接到 "1." 【段落问题】共 3 处 - 第2、4、7段: 缺少首行缩进 - 行距不统一: 存在单倍、1.5倍混用 【字体问题】共 2 处 - 正文字号不统一: 12pt、14pt 混用 - 检测到 4 种字体混用
# 智能模式(根据上下文判断) uv run --with python-docx python3 scripts/punctuation.py input.docx output.docx # 强制全部转中文标点 uv run --with python-docx python3 scripts/punctuation.py input.docx output.docx --mode chinese # 强制全部转英文标点 uv run --with python-docx python3 scripts/punctuation.py input.docx output.docx --mode english # 只修复特定类型 uv run --with python-docx python3 scripts/punctuation.py input.docx output.docx --fix brackets,quotes
# 应用公文格式 uv run --with python-docx python3 scripts/formatter.py input.docx output.docx --preset official # 应用学术论文格式 uv run --with python-docx python3 scripts/formatter.py input.docx output.docx --preset academic # 应用法律文书格式 uv run --with python-docx python3 scripts/formatter.py input.docx output.docx --preset legal
# 先诊断 uv run --with python-docx python3 scripts/analyzer.py messy.docx # 修复标点 + 应用格式 uv run --with python-docx python3 scripts/punctuation.py messy.docx temp.docx uv run --with python-docx python3 scripts/formatter.py temp.docx clean.docx --preset official
| 类型 | 错误 | 正确(中文) | 正确(英文) |
|---|---|---|---|
| 括号 | 中英混用 | () | () |
| 引号 | 直引号 "" | ""'' | "" '' |
| 冒号 | 中英混用 | : | : |
| 逗号 | 中英混用 | , | , |
| 句号 | 中英混用 | 。 | . |
| 分号 | 中英混用 | ; | ; |
| 问号 | 中英混用 | ? | ? |
| 叹号 | 中英混用 | ! | ! |
| 省略号 | ... | …… | ... |
| 破折号 | -- 或 — | —— | -- |
100% 保持英文e.g. i.e. 保持英文句点页面: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 # 法律文书
使用 uv run --with python-docx 自动安装。