前言¶
论文、报告、汇报材料经常在 Word 里来回改：正文一种字体、标题另一种字号、行距页边距各段不一，表格和图注也对不齐。手工在「样式」面板里逐段调整，既慢又容易漏。若你希望在 Agent 对话里直接说「帮我排版这个 Word」，由工具统一处理字体、标题、行距、页边距、表格和题注，可以了解 SkillHub 上的社区 Skill word-auto-format（坐标 @user_e41a5bf9/wsj-word-format，当前版本 1.0.0）。
这是什么¶
word-auto-format 面向需要自动格式化、排版或美化 Word（.docx） 文档的场景。发布者为 SkillHub 用户 user_e41a5bf9，来源为 community，分类为 office-efficiency。Skill 内提供 Python 脚本 word_formatter.py，在一条命令流程中处理字体统一、标题识别、行距、页边距、表格格式与题注居中；标签标明 requires_api_key=false，不依赖额外 API Key。
官方入口：
- SkillHub 页面：https://www.skillhub.cn/skills/user_e41a5bf9/wsj-word-format
- API 坐标页：https://api.skillhub.cn/user_e41a5bf9/wsj-word-format
（SkillHub 页面展示的评分为 100000，下载 808 次；以上为页面与预抓取资料中的统计，会随商店更新变化。）
核心功能¶
以下能力均来自 Skill 官方简介，对应 word_formatter.py 的处理范围：
- 字体统一（font unification）：收敛正文与常见文本的字体不一致问题。
- 标题检测（heading detection）：识别并规范化标题层级相关格式。
- 行距（line spacing）：统一段落行距设置。
- 页边距（page margins）：调整页面边距。
- 表格格式（table formatting）：处理文档内表格的排版。
- 题注居中（caption centering）：对图、表等题注做居中类排版。
Skill 说明强调上述项可在 one command（一次命令/一次脚本执行）中完成，适合「先出内容、再统一版式」的工作流。
何时会触发这个 Skill¶
Agent 在匹配用户意图时会加载 Skill 说明。官方列出的触发表述包括（中英文均可）：
- 「帮我排版这个 Word」「自动格式化文档」「统一字体行距」
- 「论文/报告排版」「Word 排版」「整理文档格式」
- “format this Word file”“auto typeset”“standardize document style”
安装并启用后，用自然语言描述排版需求并指向 .docx 文件即可，由 Agent 按 Skill 指引调用 word_formatter.py。
安装与启用¶
Skill 遵循通用 SKILL.md 格式。SkillHub 页面给出的安装方式是：让 AI 按 SkillHub 安装说明 安装坐标 @user_e41a5bf9/wsj-word-format。
若本机已安装 skillhub CLI，可先确认版本，再安装到当前 Agent 的 skills 目录（必须使用 --dir，否则默认装到 ./skills/ 可能不会被 Agent 识别）：
command -v skillhub && skillhub --version
skillhub install @user_e41a5bf9/wsj-word-format --dir <你的 Agent skills 目录>
常用客户端的 skills 目录（摘自 SkillHub 安装文档，按你实际使用的工具选择其一）：
| 环境 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
| Windsurf | ~/.codeium/windsurf/skills/ 或 .windsurf/skills/ |
未安装 CLI 时，可按安装文档执行官方安装脚本（完整安装或仅 CLI）。沙箱或限网环境需允许访问安装源后再执行。
安装完成后，按你所用 Agent 的惯例重启或刷新 skills 加载；具体是否需重启以当前客户端文档为准。
典型用法¶
公开资料未单独给出 word_formatter.py 的命令行参数表，典型用法是 通过 Agent + Skill 说明 驱动脚本，而不是手写一长串未文档化的 flags。可复现的流程如下：
- 将待处理的文件准备为 .docx（Skill 简介明确针对 Word
.docx）。 - 在已安装本 Skill 的 Agent 中发送与排版相关的请求，例如：「请用 word-auto-format 统一这份报告的字体和行距，并处理表格和图注。」
- 按 Agent 提示确认输入文件路径与输出方式（覆盖或另存为以 Agent/Skill 指引为准）。
- 在 Word 中打开结果，抽查标题层级、正文字体、行距、页边距、表格与题注是否符合预期。
若需脚本级调用方式，应在安装后的 Skill 包内查看 SKILL.md 与 word_formatter.py 的说明，以包内文档为准。
适用场景与注意¶
适合谁
- 经常交付 Word 版论文、课程报告、内部汇报，版式要求重复且固定。
- 希望把「统一字体行距、页边距、表格、题注」交给可重复执行的自动化，而不是每次手工点选样式。
- 已在 Cursor、Claude Code、Codex 等支持 Skills 的环境里工作，并愿意通过 SkillHub 安装社区 Skill。
限制与注意
- 仅针对 .docx；旧版
.doc或其它格式需先转换，是否支持转换不在本 Skill 简介范围内。 - 社区来源（community），使用前可在 SkillHub 页面查看版本 1.0.0 与说明，重大文档建议先备份再排版。
- heading detection 依赖文档既有结构；若全文几乎无样式、仅靠加粗区分标题，效果可能不如已使用 Word 标题样式的文档。
- 复杂版式（多栏、域、嵌入对象、极端自定义样式）是否完全覆盖，需以实际文档试跑为准；官方简介未承诺替代专业排版软件的全部能力。
结尾¶
word-auto-format 把 Word 排版里高频、机械的部分——字体、标题、行距、页边距、表格与题注——收敛到 Skill 提供的 word_formatter.py 与一次执行流程中，适合在 Agent 对话里用自然语言触发。安装坐标为 @user_e41a5bf9/wsj-word-format，说明与统计见 SkillHub：https://www.skillhub.cn/skills/user_e41a5bf9/wsj-word-format 。
